From e124cb1dc7b74208aed3000fd00f79607d284443 Mon Sep 17 00:00:00 2001 From: Oscar Esteban Date: Fri, 20 Nov 2020 16:05:09 +0100 Subject: [PATCH] DOC: Bring ``IntendedFor`` heuristic table from SDCFlows The heuristic table will not be pertinent at the level of SDCFlows, as the workflow will be staged for each fieldmap in the structure and will not then be applied to correct the data - that will be the responsibility of the host workflow (i.e., *fMRIPrep* for the case at hand). Since this table will be removed in the context of nipreps/sdcflows#123, I'm bringing it here temporarily. --- docs/sdc.rst | 30 +++++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) 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