DOWNLOAD

Code: Click here to request.

Cite:

** Updates 01/12/2021:

We have a new version of the pipeline available that was built against 7.1.1 dev with the below main feature updates:

A couple of other things

** Updates 02/10/2020:

a new version of the infant pipeline has been created for your use. See below for details about the new features.

EXECUTION

The most basic command line that you can run in order to execute the pipeline is the following.

setenv SUBJECTS_DIR your_data_path      ** OR **    export SUBJECTS_DIR=your_data_path

Make sure that your_data_path is the *absolute* path to your data!

infant_recon_all --s SUBJ --age age_in_months

You can run this release from both tcsh or bash.

Just like before, the script will expect the input file to be located at $SUBJECTS_DIR/$subj/mprage.nii.gz or $SUBJECTS_DIR/$subj/mprage.mgz by default. If the --masked flag is used, we recommend also running intensity normalization. One example would be using

mri_nu_correct.mni --i $infile --o $nufile --n 2


** Below are Notes from the original release **

Current skullstripping code: PICASSO -- need to get it independently, from NITRC. With questions related to this tool, contact Dr Ou ( yangming.ou@childrens.harvard.edu ).

EXECUTION

source set_babydev_packages.csh

setenv SUBJECTS_DIR your_data_path

infant_recon_all --s SUBJ --age age_in_months

Note, run everything from tcsh. Bash scripts are not yet ready for this distribution.

Before execution, you will need install FSL [https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/FslInstallation] and dramms [www.nitrc.org].

The script will expect the input file to be located at $SUBJECTS_DIR/$subj/mprage.nii.gz or $SUBJECTS_DIR/$subj/mprage.mgz by default. If the --masked flag is used, we recommend also running intensity normalization using

mri_nu_correct.mni --i $infile --o $nufile --n 2

Other useful flags:

--masked (using a skullstripped input)

--outdir (redirecting output)

--kneigh (number of training examples to use)

See infant_recon_all --help for more information

NOTES Currently, aparc is provided for sake of completeness, but has not been fully validated. It is a projected version of the adult atlas, so it does not originate from the infant training data set!

FAQs (02/18/2022)

Q: Can we use infantFS for data acquired on 1.5T?

A: Yes, the pipeline can be applied to that data.

Q: Can we rename/reorganize the input file for Infant FS recon all?

A: infantFS expects the input file to be called mprage.nii.gz. If one does not want to rename the original data file, symlinks can be used instead.

Q: What is unit for Age input for infant recon all?

A: The age-at-scan input is expected in months.

Q: What does the Aparc flag do?

A: The --aparc flag will produce cortical parcellations (along with full brain segmentations).

Q: How is –gmwm2 flag used?

A: The --gmwm2 flag would be used to make sure that the GM/WM information is definitely propagated from the training subjects to the test subject. In the most recent version of the code, this option is on by default. If you use an older version of the pipeline, there are scenarios where this might not happen since some of the training subjects do not have a GM/WM separation.

Q: Thalamus region is missing from the aseg stat export. How to fix it?

A: The older pipeline labels thalamus with a label value different from the currently expected one (48 for right thalamus and 9 for left thalamus). The following commands can be run to switch the old labels to the new ones. After this is done, you will need to rerun the stats file generation.

Q: Can –bigventricle flag be used for infant recon_all?

A: There is no –bigventricle flag in infantFS

Q: Brainstem seems to be split into multiple sub-regions, is it possible to get the entire brainstem volume in the aseg stat export?

A: In order to do so, the brainstem labels of interest would need to first be merged by the user and the stats be generated by running a separate command.

Q: Is corpus callosum out of the Infant FreeSurfer atlases?

A: The Corpus Callosum is a part of the aseg segmentation in the most recent version of the tools.

Q: Is it possible to get the mean cortical thickness for the labels you are providing?

A: The mean cortical thickness for the labels can be found in surface stats files.

Q: Can recon-all be used for pediatric subjects?

A: The (adult) recon all pipeline uses an adult atlas a reference. It has been used in the past by expert users for pediatric subjects down to 4.5 years of age (Ghosh, S.S. et al, 2010). Below this age running the (adult) recon pipeline is not recommended. A better option is to use the infant_recon pipeline.

For LCN Faculty/staff, this information is also documented here: Please refer to this site/make edits here for the most updated information: https://partnershealthcare.sharepoint.com/sites/LCN/SitePages/Infant-FreeSurfer.aspx