Segmentation of hippocampal subfields

Author: Koen Van Leemput

DEPRECATED - This functionality is found only in v5.2 and v5.3.

See HippocampalSubfieldsAndNucleiOfAmygdala for the functionality found in v7.0 and downloadable.

See also: GEMS

Automated segmentation of the subfields of the hippocampus, using models built from manual segmentations of the right hippocampus in 0.38x0.38x0.8 mm^3 in vivo MRI scans in 10 subjects. For the left hippocampus, the model for the right side is simply mirrored. The exact algorithm is described in the paper:

recon-all stream

To generate the hippocampal subfield segmentations as part of the normal FreeSurfer processing stream, simply add the "-hippo-subfields" flag to the recon-all script:

 recon-all -s bert -all -hippo-subfields

It is also possible to only run the hippocampal subfield segmentation for a subject that has already undergone the standard volumetric FreeSurfer pipeline (in particular, the program needs the FreeSurfer-generated files "aseg.mgz", "nu.mgz" and "talairach.xfm"):

 recon-all -s bert -hippo-subfields

The output consists of a collection of images $SUBJECTS_DIR/bert/mri/posterior_* that indicate each voxel's posterior probability of belonging to different subregions. The estimated volumes of these subregions can be obtained using the "kvlQuantifyHippocampalSubfieldSegmentations.sh" script. Doing

 kvlQuantifyHippocampalSubfieldSegmentations.sh

will create the text files "nonPartialVolumeStatsLeft.txt" and "nonPartialVolumeStatsRight.txt" in the directory $SUBJECTS_DIR, containing tables that summarize the volumes of the hippocampal subfield segmentations of the left and right side, respectively, in all of the subjects in $SUBJECTS_DIR. The reported volumes are given in number of voxels, where each voxel is of the size "0.5x0.5x0.5mm^3". It is expected that the "-hippo-subfields" flag has been used for each subject in $SUBJECTS_DIR; if this is not the case the "kvlQuantifyHippocampalSubfieldSegmentations.sh" script will fail and no (or incomplete) output files will be generated.

The estimated hippocampal subfield volumes can also be computed for one specific subject only: For the right hippocampus, the command is

 cd $SUBJECTS_DIR/bert/mri
 kvlQuantifyPosteriorProbabilityImages $FREESURFER_HOME/data/GEMS/compressionLookupTable.txt \
  posterior_right_* posterior_Right-Hippocampus.mgz

and for the left

 cd $SUBJECTS_DIR/bert/mri
 kvlQuantifyPosteriorProbabilityImages $FREESURFER_HOME/data/GEMS/compressionLookupTable_left.txt \
  posterior_left_* posterior_Left-Hippocampus.mgz 

Visualizing the subregion segmentations on top of the MRI data can be achieved by doing

 cd $SUBJECTS_DIR/bert/mri
 freeview nu.mgz \
  -p-labels posterior_left_* posterior_Left-Hippocampus.mgz \
  -p-labels posterior_right_* posterior_Right-Hippocampus.mgz \
  -p-prefix posterior_ -p-lut $FREESURFER_HOME/FreeSurferColorLUT.txt

The segmentation results are given as probability maps: a (unsigned 8-bit) value of 0 means a probability is 0, 225 means a probability of 1, and everthing in between scales linearly.

Log files

Since the console output generated during subfields segmentation is long, the log is written in an alternate file - $SUBJECTS_DIR/bert/scripts/hippo-subfields.log. The file recon-all.log simply shows the invocation of various commands during the subfields generation.

Report bugs to <freesurfer@nmr.mgh.harvard.edu>

HippocampalSubfieldSegmentation (last edited 2020-05-08 11:52:23 by JuanIglesias)