Skip to content

Commit 767744a

Browse files
committed
doc: update anatomical template section
1 parent f1b009a commit 767744a

File tree

1 file changed

+14
-7
lines changed

1 file changed

+14
-7
lines changed

docs/workflows.rst

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -174,15 +174,22 @@ Your ``.bidsignore`` file should include the following line::
174174

175175
Longitudinal processing
176176
~~~~~~~~~~~~~~~~~~~~~~~
177-
In the case of multiple T1w images (across sessions and/or runs), T1w images are
178-
merged into a single template image using FreeSurfer's `mri_robust_template`_.
179-
This template may be *unbiased*, or equidistant from all source images, or
180-
aligned to the first image (determined lexicographically by session label).
177+
In the case of multiple T1w images (across sessions and/or runs), *fMRIPrep* provides
178+
a few choices on how to generate the reference anatomical space.
179+
180+
If ``--subject-anatomical-reference first-lex`` is used, all T1w images are
181+
merged into a single template image using FreeSurfer's `mri_robust_template`_, aligned
182+
aligned to the first image (determined lexicographically by session label). This is
183+
the default behavior.
184+
185+
If ``--subject-anatomical-reference unbiased`` is used, all T1w images are merged into
186+
a an *unbiased* template, or equidistant from all source images.
181187
For two images, the additional cost of estimating an unbiased template is trivial,
182188
but aligning three or more images is too expensive to justify being the default behavior.
183-
For consistency, in the case of multiple images, *fMRIPrep* constructs
184-
templates aligned to the first image, unless passed the ``--longitudinal``
185-
flag, which forces the estimation of an unbiased template.
189+
190+
If ``--subject-anatomical-reference sessionwise`` is used, a reference template will be
191+
generated for each session independently. If multiple T1w images are found within a session,
192+
other images will align to the first lexicographical image.
186193

187194
.. note::
188195

0 commit comments

Comments
 (0)