diff --git a/docs/sdc.rst b/docs/sdc.rst index eee20e845..ff442b0d9 100644 --- a/docs/sdc.rst +++ b/docs/sdc.rst @@ -62,9 +62,37 @@ In order to select the appropriate estimation workflow, the input BIDS dataset i first queried to find the available field-mapping techniques (see :py:func:`~sdcflows.workflows.base.init_sdc_estimate_wf`). Once the field-map (or the corresponding displacement field) is estimated, the -distortion can be accounted for +distortion can be accounted for (see :py:func:`~sdcflows.workflows.unwarp.init_sdc_unwarp_wf`). +Automatic selection of the appropriate susceptibility-distortion correction (SDC) method +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +If the dataset metadata indicate that more than one field map acquisition is +``IntendedFor`` (see the `BIDS Specification +`__), +the following priority will be used: + + 1. :ref:`sdc_pepolar` (or **blip-up/blip-down**) + + 2. :ref:`sdc_direct_b0` + + 3. :ref:`sdc_phasediff` + + 4. :ref:`sdc_fieldmapless` + + +Table of behavior (fieldmap use-cases): + +=============== =========== ============= =============== +Fieldmaps found ``use_syn`` ``force_syn`` Action +=============== =========== ============= =============== +True * True Fieldmaps + SyN +True * False Fieldmaps +False * True SyN +False True False SyN +False False False HMC only +=============== =========== ============= =============== + Calculating the effective echo-spacing and total-readout time ............................................................. To solve :ref:`(1) `, all methods (with the exception of the