@@ -6,7 +6,6 @@ FAQ, Tips, and Tricks
66
77Should I run quality control of my images before running *fMRIPrep *?
88--------------------------------------------------------------------
9-
109Yes. You should do so before any processing/analysis takes place.
1110
1211Oftentimes (more often than we would like), images have fatal artifacts and problems.
@@ -27,7 +26,6 @@ some kind of preprocessing (see next question).
2726
2827What if I find some images have undergone some pre-processing already (e.g., my T1w image is already skull-stripped)?
2928---------------------------------------------------------------------------------------------------------------------
30-
3129These images imply an unknown level of preprocessing (e.g. was it already bias-field corrected?),
3230which makes it difficult to decide on best-practices for further processing.
3331Hence, supporting such images was considered very low priority for *fMRIPrep *.
@@ -40,7 +38,6 @@ reverting to the original, defaced, T1w images to ensure more uniform preprocess
4038
4139My *fMRIPrep * run is hanging...
4240-------------------------------
43-
4441When running on Linux platforms (or containerized environments, because they are built around
4542Ubuntu), there is a Python bug that affects *fMRIPrep * that drives the Linux kernel to kill
4643processes as a response to running out of memory.
@@ -62,7 +59,6 @@ Additionally, consider using the ``--low-mem`` flag, which will make some memory
6259
6360ERROR: it appears that ``recon-all `` is already running
6461-------------------------------------------------------
65-
6662When running FreeSurfer _'s ``recon-all ``, an error may say *it appears it is already running *.
6763FreeSurfer creates files (called ``IsRunning.{rh,lh,lh+rh} ``, under the ``scripts/ `` folder)
6864to determine whether it is already executing ``recon-all `` on that particular subject
@@ -117,7 +113,6 @@ In general, please be cautious of deleting files and mindful why a file may exis
117113
118114Running subjects in parallel
119115----------------------------
120-
121116When running several subjects in parallel, and depending on your settings, fMRIPrep may
122117fall into race conditions.
123118A symptomatic output looks like: ::
@@ -155,7 +150,6 @@ number of CPUs divided by the number of subjects is most efficient.
155150
156151A new version of *fMRIPrep * has been published, when should I upgrade?
157152----------------------------------------------------------------------
158-
159153We follow a philosophy of releasing very often, although the pace is slowing down
160154with the maturation of the software.
161155It is very likely that your version gets outdated over the extent of your study.
@@ -169,3 +163,16 @@ using the latest version of the tool.
169163In any case, if you can find your release listed as *flagged * in `this file
170164of our repo <https://github.com/poldracklab/fmriprep/blob/master/.versions.json> `__,
171165then please update as soon as possible.
166+
167+ What is *TemplateFlow * for?
168+ ---------------------------
169+ *TemplateFlow * enables *fMRIPrep * to generate preprocessed outputs spatially normalized to
170+ a number of different neuroimaging templates (e.g. MNI).
171+ For further details, please check `its documentation section <spaces.html#templateflow >`__.
172+
173+ I'm running *fMRIPrep * via Singularity containers - how can I troubleshoot problems?
174+ ------------------------------------------------------------------------------------
175+ We have extended `this documentation <singularity.html >`__ to cover some of the most
176+ frequent issues other Singularity users have been faced with.
177+ Generally, users have found it hard to `get TemplateFlow and Singularity to work
178+ together <singularity.html#singularity-tf> `__.
0 commit comments