Package: hipsta
HIPpocampal Shape and Thickness Analysis - HIPSTAPurpose:This repository contains the Hipsta package, a collection of scripts for
hippocampal shape and thickness analysis as described in our recentpublication.Documentation:Please see the documentation pages for a general overview, usage information and
examples, and output description. Brief usage information is also availablehere.
Some suggestions for running the script can be found in thetutorial.Current status:The hippocampal shape and thickness analysis package is currently in its beta
stage, which means that it's open for testing, but may still contain unresolved
issues. Future changes with regard to the algorithms, interfaces, and package
structure are to be expected.Feedback:Questions, suggestions, and feedback are welcome, and should preferably be
submitted as anissue.Installation:It is recommended to run this pipeline within its own virtual environment. A
virtual environment can, for example, be created using Python'svirtualenvcommand:virtualenv /path/to/a/new/directory/of/your/choiceActivate the virtual environment as follows:source /path/to/a/new/directory/of/your/choice/bin/activateUse the following code to download this package from its GitHub repository (this
will create a 'Hipsta' directory within the current working directory):git clone https://github.com/Deep-MI/Hipsta.gitThe next step is to install hipsta as a python package (after changing into the
'Hipsta' directory). This will automatically install all required dependencies:pip install .As soon as the package is available onpypi.org, it will also be installable directly and downloading from GitHub is not necessary in this case:pip install hipstaThe above steps are not necessary when running theDockerorSingularityversions of the package.Requirements:Unless using theDockerorSingularityversions of the package, the following conditions need to be met for running an
analysis:A FreeSurfer version (6.x or 7.x) must be sourced, i.e. FREESURFER_HOME must
exist as an environment variable and point to a valid FreeSurfer installation.A hippocampal subfield segmentation created by FreeSurfer 7.11 or later
or the ASHS software. A custom segmentation is also permissible (some restrictions
and settings apply; seeSupported Segmentations).Python 3.8 or higher including the lapy, numpy, scipy, nibabel, pyvista, and
pyacvd libraries, among others. Seerequirements.txtfor a full list, and usepip install -r requirements.txtto install.The gmsh package (version 2.x;http://gmsh.info) must be installed. Can be
downloaded e.g. as binaries forlinuxorMacOSX. The 'gmsh' binary must
be on the $PATH:export PATH=${PATH}:/path/to/gmsh-directory/binReferences:Please cite the following publications if you use these scripts in your work:Diers, K., Baumeister, H., Jessen, F., Düzel, E., Berron, D., & Reuter, M. (2023). An automated, geometry-based method for hippocampal shape and thickness analysis. Neuroimage, 276:120182. doi:10.1016/j.neuroimage.2023.120182.Please also consider citing the these publications:Geuzaine, C., & Remacle, J.-F. (2009). Gmsh: a three-dimensional finite element mesh generator with built-in pre- and post-processing facilities. International Journal for Numerical Methods in Engineering, 79, 1309-1331.Andreux, M., Rodola, E., Aubry, M., & Cremers, D. (2014). Anisotropic Laplace-Beltrami operators for shape analysis. In European Conference on Computer Vision (pp. 299-312). Springer, Cham.Iglesias, J. E., Augustinack, J. C., Nguyen, K., Player, C. M., Player, A., Wright, M., ... & Fischl, B. (2015). A computational atlas of the hippocampal formation using ex vivo, ultra-high resolution MRI: application to adaptive segmentation of in vivo MRI. Neuroimage, 115, 117-137.Yushkevich, P. A., Pluta, J., Wang, H., Ding, S.L., Xie, L., Gertje, E., Mancuso, L., Kliot, D., Das, S. R., & Wolk, D.A. (2015). Automated Volumetry and Regional Thickness Analysis of Hippocampal Subfields and Medial Temporal Cortical Structures in Mild Cognitive Impairment. Human Brain Mapping, 36, 258-287.