Exporting BIDS format
NiDB can export imaging data in BIDS format, through the Search page, and through the pipeline system. All exported BIDS data must have a mapping established before the data is exported. This makes sure that the exported BIDS data is valid.
BIDS Mapping
BIDS mappings are set on a project level. This means any mapping applied to an imaging study will be applied to all imaging studies within the same project. On a Project → Subject → Study page, there is a BIDS... button next to each series name.

Click the BIDS... button for the series you want to map. You will need to do this for all series that you will want to export in BIDS format. After clicking the button, you will see a mapping.

The top of the page shows the current series being mapped. The saved mapping will only apply to the Series Description, Image Type, and Project.
entity:suffix
BIDS entity:suffix for the MR modality (docs).
Special note - The fmap:magnitude1and2 is meant for Siemens scanners where a single series contains two magnitude images.
anat:t1w
IntendedFor - Entity
If this series is intended to be used for another series, for example if this is a fieldmap, you must specify which series it will apply to. A single fieldmap can be IntendedFor multiple BOLD series. The entity of the target series must be specified.
All IntendedFor fields must have the same number of items. This example has two runs of a Stroop task, so there must be 2 items for all of the IntendedFor mapping fields.
func,func,func
IntendedFor - Task
The task of the target series must be specified. It can only contain alphanumeric characters (no spaces, underscore, dash, etc) and must match another Task
Stroop,Stroop,GoNoGo
IntendedFor - Run
The run number(s) of the target series must be specified.
1,2,1
IntendedFor - Suffix
The entity of the target series.
bold,bold,bold
IntendedFor - FileExtension
nii.gz,nii.gz,nii.gz
Run number
If there are multiple runs on the same task, then a run number of required.
This maps to the run-<index> field in the BIDS image filename.
For example, if a study contains series named "Stroop 1" and "Stroop 2", then add those corresponding numbers for each run. If the study contains multiple runs of series with the same name (for example "Stroop", "Stroop"), then select Automatically number runs, and an ordinal number will be assigned to the consecutive series of the same name.
Task
A task name is required for BOLD series, and is good practice to identify particular series of data.
This maps to the task-<label> field in the BIDS image filename.
Stroop or Rest or GoNoGo, etc.
Acquisition
This is not required, but this maps to the acq-<label> field in the BIDS image filename.
OlinStroopRun1
Click Update when done. After all necessary series are mapped, the study page will look like this:

Last updated
Was this helpful?
