freesurfer-volume-reader/README.md

freesurfer-volume-reader

Python script & library to read hippocampal subfield volumes computed by Freesurfer

https://surfer.nmr.mgh.harvard.edu/fswiki/HippocampalSubfields

Install

pip3 install --user freesurfer-volume-reader
freesurfer-volume-reader --help

Usage

export SUBJECTS_DIR=/my/freesurfer/subjects
freesurfer-volume-reader

or

freesurfer-volume-reader /my/freesurfer/subjects
freesurfer-volume-reader /my/freesurfer/subjects /other/freesurfer/subjects

or

from freesurfer_volume_reader.freesurfer import HippocampalSubfieldsVolumeFile

for volume_file in HippocampalSubfieldsVolumeFile.find('/my/freesurfer/subjects'):
    print(volume_file.read_volumes_mm3())
    print(volume_file.read_volumes_dataframe())

Tests

pip3 install --user pipenv
git clone https://github.com/fphammerle/freesurfer-volume-reader.git
cd freesurfer-volume-reader
pipenv run pylint freesurfer_volume_reader
pipenv run pytest