The scan table

Read the table

Each row is one recording. Its BIDS name is built from the cells of the row: change a cell and the name follows.

12345678

The columns shown at first:

Many more are available. Manage columns… under the table lists every column with a note on what it holds; tick the ones you want. Drag a column's header to reorder the columns, and drag its edge to widen it. The full list is in Scan table columns.

Row states

The badge in the second column says what state the row is in, and the row is tinted to match:

Hover a row to read its notes. The toolbar counts the rows as valid, warnings, error and skipped (non-image and physiology rows count as valid); click warnings, error or skipped to list those rows.

Edit a cell

1

Step 1. Open a cell for editing

Double-click a cell in an editable column: session, datatype, suffix, task or run (and the participant and recording columns you can show). The cell becomes a field or a dropdown.

2

Step 2. Type the new value and confirm it

Press Return on macOS, Enter on Windows and Linux. The row's BIDS name is rebuilt and checked against the standard at once. A value that breaks the standard's format, such as a session label with a space, is kept but turns the row amber, and its note says which rule it breaks.

Press ⌘Z on macOS, Ctrl+Z on Windows and Linux to undo an edit. Every edit is recorded in the project, so undo works after closing and reopening BIDS Manager too, back to the last conversion.

Leave a recording out, or put it back

Untick a row's box to leave it out of the conversion; tick it to put it back. The boxes in the Structure tree beside the table do the same for a whole subject, session or datatype at once. Leaving a row out never deletes it: it stays in the table, with its BIDS name struck through.

Set one subject and one session

The scan proposed four subjects and three sessions for what is one participant's single visit (chapter 3). Two bulk edits fix that.

3

Step 3. Select the rows to convert

Click the first ticked row, then ⇧ + Click on macOS, Shift + Click on Windows and Linux the last one. The range includes one row that is left out, the PhoenixZIPReport: ⌘ + Click on macOS, Ctrl + Click on Windows and Linux it to take it out of the selection, so the 15 rows to convert are selected. (⌘ + Click on macOS, Ctrl + Click on Windows and Linux adds or removes one row.)

4

Step 4. Open Bulk edit

Click Bulk edit… under the table. The Bulk edit dialog applies one value to one column across the selected rows.

5

Step 5. Set the subject to 001

Choose subject in Column:, keep every selected row (15) in Change:, and type 001 in New value:. What would change lists the rows the edit changes, each with its value Now and what it Becomes: the two spectroscopy rows, the PET row and the eye-tracking row. The other eleven already say 001.

Click Apply to 4 row(s). The four rows change, as one edit you can undo in one step.

6

Step 6. Set the session to 01

With the same rows selected, open Bulk edit… again, choose session, type 01 and click Apply to 15 row(s): no row said 01 before, so all of them change.

More from Bulk edit

• Change: narrows an edit to the rows that currently say one value, or to those that say nothing. Use it to rename one task label without touching the others.
• Column: also offers every entity the standard allows on all the selected rows, such as acquisition. Tick Remove this entity from the rows that have it to take an entity off: rows that must keep it (a BOLD run's task) are left alone, and the dialog says how many.
• Untick rows in What would change to leave them out of this edit.

Two more controls under the table

• Highlight aborts tints in purple the rows the scan believes are aborted runs: a series the operator restarted, usually after a few volumes. They are already unticked; the tint makes them easy to find. The sample has none.
• Dataset metadata… opens the questions about the dataset as a whole. That is chapter 7.