Actions

Naming acquisitions: Difference between revisions

From SpinozaWiki

mNo edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 4: Line 4:
To enable correct file naming and conversion, exam card names should adhere to the following convention:
To enable correct file naming and conversion, exam card names should adhere to the following convention:
: <code><researchgroup>_<project>_<extra info if need be></code>
: <code><researchgroup>_<project>_<extra info if need be></code>
E.g.;
E.g. <code>Dumoulin_SDVICI, Zwaag_Cerebellum, or SC-develop_VASO</code> etc.
: <code>Dumoulin_SDVICI</code>
: <code>Zwaag_Cerebellum</code>
: <code>SC-develop_VASO</code>
: etc.
<br>
[[File:Session naming.png|frame|center|How to name an exam card]]


===Naming convention for subjects===
===Naming convention for subjects===
To enable correct dicom naming, subject IDs should adhere to one these four formats:
To enable correct dicom naming, subject IDs should adhere to one these four formats:
: <code><subjectID></code>
<code><subjectID>, <subjectID>_<sessionID></code>
: <code><subjectID>_<sessionID></code>
E.g. <code>sub-01, sub-01_ses-01</code> etc.
E.g.;
: <code>sub01</code>
: <code>sub01_ses01</code>
: etc.<br>


Do '''not''' use:
Do '''not''' use:
: <code><projectID>_<subjectID></code>
: <code><projectID>_<subjectID></code> as this will lead to problems with subsequent automatic conversions.
as this will lead to the subject being named projectID and the session subjectID.
Also, make sure that you use a new subjectID / sessionID for each subject in the project.
E.g.  
: <code>Cerebellum_sub01</code> results in the subjectID Cerebellum with sessionID sub01 <br>
 
Also, make sure that you use a new subjectID / sessionID for each subject in the project.  


===Naming convention for sequences (optional, only needed for automatic conversion)===
===Naming convention for sequences (optional, only needed for automatic conversion)===
Functional MRI with topup
Functional MRI with topup
: <code>func-bold_task-<taskname>_run-01</code> This is run 01 of the task
: <code>BOLD_<taskname>_run-01</code> This is run 01 of the task
: <code>fmap-epi_acq-<taskname>_run-01</code> This is the topup sequence that goes with run 01
: <code>FMAP_<taskname>_run-01</code> This is the topup sequence that goes with run 01
: <code>func-bold_task-<taskname>_run-02</code> This is run 02 of the task
: <code>BOLD_<taskname>_run-02</code> This is run 02 of the task
: <code>fmap-epi_acq-<taskname>_run-02</code> This is the topup sequence that goes with run 02
: <code>FMAP_<taskname>_run-02</code> This is the topup sequence that goes with run 02
 
Make sure that your runs are consecutively named <code>_run-XX</code>, where XX is the index of the run.


Functional MRI with B0
Functional MRI with B0
: <code>func-bold_task-<taskname>_run-03</code> This is run 03 of the task
: <code>BOLD_<taskname>_run-03</code> This is run 03 of the task
: <code>fmap-B0_acq-<taskname>_run-03</code> This is the B0 sequence that goes with run 03
: <code>B0_acq-<taskname></code> This is the B0 sequence that goes with run 03. Note that phase-difference B0 maps are usually applied to multiple bold runs in a session.


Standard Anatomy
Standard Anatomy
: <code>run-01_anat-T1w</code> This is the first T1 weighted anatomical
: <code>T1w_run-01</code> This is the first T1 weighted anatomical
: <code>run-02_anat-T1w</code> This is the second T1 weighted anatomical
: <code>T1w_run-02</code> This is the second T1 weighted anatomical
: <code>anat-T2w</code> This is the ''only'' T2 weighted anatomical
: <code>T2w</code> This is the ''only'' T2 weighted anatomical
: <code>anat-T2starw</code> This is the ''only'' T2* weighted anatomical
: <code>T2starw</code> This is the ''only'' T2* weighted anatomical
 
: <code>Dw</code> This is the ''only'' diffusion weighted anatomical
Fancy anatomy -- tentative (BIDS specification has changed and ReproIn is unclear)
Fancy anatomy -- tentative (BIDS specification has changed and ReproIn is unclear)
: <code>anat-T1map_acq-MEMP2RAGE</code> This is the only T1 map
: <code>T1map</code> This is the only T1 map
: <code>anat-T2*map_acq-MEMP2RAGE</code> This is the only T2* map
: <code>T2*map</code> This is the only T2* map
: <code>anat-MEMP2RAGE_[_echo-<index>]inv-1_part-mag</code> This is the magnitude map of the first inversion in an MP2RAGE
: <code>MEMP2RAGE_[_echo-<index>]inv-1_part-mag</code> This is the magnitude map of the first inversion in an MP2RAGE
: <code>anat-MEMP2RAGE_[_echo-<index>]inv-1_part-phase</code> This is the phase map of the first inversion in an MP2RAGE
: <code>MEMP2RAGE_[_echo-<index>]inv-1_part-phase</code> This is the phase map of the first inversion in an MP2RAGE
: <code>anat-MEMP2RAGE_[_echo-<index>]inv-2_part-mag</code> This is the magnitude map of the second inversion in an MP2RAGE
: <code>MEMP2RAGE_[_echo-<index>]inv-2_part-mag</code> This is the magnitude map of the second inversion in an MP2RAGE
: <code>anat-MEMP2RAGE_[_echo-<index>]inv-2_part-phase</code> This is the phase map of the second inversion in an MP2RAGE
: <code>MEMP2RAGE_[_echo-<index>]inv-2_part-phase</code> This is the phase map of the second inversion in an MP2RAGE

Latest revision as of 20:08, 8 January 2023

Once you've gotten your project approved, you will have to set up a scanning protocol that your project's scanning sessions will follow. An important part of this is how you name your acquisitions, since adequate naming will ensure an easy transition to BIDS (see the Data Export page).

Naming convention for exam cards

To enable correct file naming and conversion, exam card names should adhere to the following convention:

<researchgroup>_<project>_<extra info if need be>

E.g. Dumoulin_SDVICI, Zwaag_Cerebellum, or SC-develop_VASO etc.

Naming convention for subjects

To enable correct dicom naming, subject IDs should adhere to one these four formats: <subjectID>, <subjectID>_<sessionID> E.g. sub-01, sub-01_ses-01 etc.

Do not use:

<projectID>_<subjectID> as this will lead to problems with subsequent automatic conversions.

Also, make sure that you use a new subjectID / sessionID for each subject in the project.

Naming convention for sequences (optional, only needed for automatic conversion)

Functional MRI with topup

BOLD_<taskname>_run-01 This is run 01 of the task
FMAP_<taskname>_run-01 This is the topup sequence that goes with run 01
BOLD_<taskname>_run-02 This is run 02 of the task
FMAP_<taskname>_run-02 This is the topup sequence that goes with run 02

Make sure that your runs are consecutively named _run-XX, where XX is the index of the run.

Functional MRI with B0

BOLD_<taskname>_run-03 This is run 03 of the task
B0_acq-<taskname> This is the B0 sequence that goes with run 03. Note that phase-difference B0 maps are usually applied to multiple bold runs in a session.

Standard Anatomy

T1w_run-01 This is the first T1 weighted anatomical
T1w_run-02 This is the second T1 weighted anatomical
T2w This is the only T2 weighted anatomical
T2starw This is the only T2* weighted anatomical
Dw This is the only diffusion weighted anatomical

Fancy anatomy -- tentative (BIDS specification has changed and ReproIn is unclear)

T1map This is the only T1 map
T2*map This is the only T2* map
MEMP2RAGE_[_echo-<index>]inv-1_part-mag This is the magnitude map of the first inversion in an MP2RAGE
MEMP2RAGE_[_echo-<index>]inv-1_part-phase This is the phase map of the first inversion in an MP2RAGE
MEMP2RAGE_[_echo-<index>]inv-2_part-mag This is the magnitude map of the second inversion in an MP2RAGE
MEMP2RAGE_[_echo-<index>]inv-2_part-phase This is the phase map of the second inversion in an MP2RAGE