BIDS Ready Protocols
How to name your protocols so they are easily converted to BIDS format
BIDS Naming Pattern
We provide custom code (xnat-tools package) to export your XNAT imaging sessions to BIDS format. The process relies on naming your series in a BIDS friendly manner. If you are new to BIDS, it may be helpful to familiarize yourself with the BIDS Standard. We also provide a short overview of BIDS in this section.
When naming your series at the scanner you will need to think of the different parts that make up the BIDS name. More explicitly, the name of the series is composed of different parts that provide information about the sequence type (i.e, anatomical, functional, etc), task information, acquisition parameters, the run id, among others. The examples and diagram below show the parts of the BIDS name that you need to pay attention when naming your series at the scanner. These are only a subset of the full set defined by the BIDS specification. You can refer to the Entity Table of the BIDS specification for a full reference.
To create the final name, the different parts shown above are concatenated using underscores (_)
Additional Sample Protocols
Important considerations
Scouts and Localizers
All scout and localizer sequences need to have a scout
label. For example:
anat-scout_acq-localizer
anat-scout_acq-aascout
Scout series will remain in the sourcedata
directory of your bids output, but will not be present in your anat
folder.
Incompatible symbols
Do not use "+", "_", "-" or "." within SESID, TASKID, ACQLABEL, RUNID. The only exception is the use of run+
Naming Runs
To indicate runs in your protocol, without explicitly indicating the run number, simply label the run as run+
Cancelled Runs
If run was canceled you will need to skip that series when calling the BIDS exporting code xnat2bids.
We encourage adding a note to that series in XNAT to indicate that the run was cancelled. This will improve bookkeeping and maintainability.
Functional
Functional runs must have _task- field defined
MEMPRAGE
You can choose (on the scanner) whether to send each individual echo along with the RMS image. Regardless, this data should now be converted appropriately to BIDS format.
Fieldmaps
Currently the fieldmaps collected with our Siemens scanner use the "old way" described here
Scanner derivatives
Some sequences are derivatives of the scanner and are not yet handled by our xnat2bids
software smoothly. We recommend not exporting those sequences to BIDS at the moment. (This behavior may change in the future. See here for more details)
Last updated