A growing number of researchers are adopting the BIDS standard for their data. Flywheel has many tools to support curating data into this standard. In order to make this curation process as automated as possible, the metadata describing the data needs to be as complete as possible. The best way to accomplish this is to name the Acquisitions on the scanner with the desired BIDS naming convention.
As a default, Flywheel uses the SeriesDescription
DICOM field to set the Flywheel Acquisition Label. The BIDS Curate gear will rely on the Flywheel Classifications to determine which BIDS data type the file is in. The Flywheel BIDS Curate Gear then uses the Acquisition Label to manipulate the file metadata so that it can be viewed and exported in BIDS format.
For more information on the BIDS specification for MRI data, see the BIDS documentation.
The BIDS specification has several templates for the different data types. In these templates, the fields in [ ] are optional, everything else is mandatory.
For example for anatomy imaging data:
sub-<label>/[ses-<label>/] anat/ sub-<label>[_ses-<label>][_acq-<label>][_ce-<label>][_rec-<label>][_run-<index>]_<modality_label>.nii[.gz] sub-<label>[_ses-<label>][_acq-<label>][_ce-<label>][_rec-<label>][_run-<index>][_mod-<label>]_defacemask.nii[.gz]
Here's the Functional template as another example.
sub-<label>/[ses-<label>/] func/ sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_ce-<label>][_dir-<label>][_rec-<label>][_run-<index>][_echo-<index>]_<contrast_label>.nii[.gz] sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_ce-<label>][_dir-<label>][_rec-<label>][_run-<index>][_echo-<index>]_sbref.nii[.gz]
Not all acquisitions that are acquired during a session are relevant to the BIDS standard. One example would be localizer scans. The BIDS Gear will set an ignore flag on that file if it's labeled with a known non-BIDS classification, like Localizer. However, if another acquisition may not be BIDS relevant but might otherwise look like a BIDS data type, the user should include the string
ignore-bids
in their acquisition label.