Skip to content

Gannet is a free, open-source MATLAB-based software toolkit for analyzing edited 1H magnetic resonance spectroscopy (MRS) data.

License

Notifications You must be signed in to change notification settings

markmikkelsen/Gannet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gannet

GitHub release (latest by date) GitHub commits since latest release (by date) for a branch Website Website GitHub DOI:10.1002/jmri.24478 Citation Badge

Gannet logo

Open-source, MATLAB-based software for automated data processing and quantification of edited 1H magnetic resonance spectroscopy (MRS) data.

Full software documentation can be found here.

Overview

Gannet is a free, open-source MATLAB-based software toolkit for analyzing edited single-voxel 1H magnetic resonance spectroscopy (MRS) data. Its largely automated functions cover all the essential steps of modern MRS analysis:

  • Loading raw data
  • Several preprocessing steps
  • Signal modeling
  • Voxel co-registration to and segmentation of structural MR images
  • Metabolite concentration estimation corrected for tissue composition

Several existing software packages for MRS data analysis require substantial user input or offer a wide selection of processing options. In contrast, the philosophy behind Gannet is to provide users with a complete automated pipeline without the need for significant user input.

Additionally, as open-source software, advanced users have the ability to modify the underlying routines for ad hoc purposes.

Installation

Prerequisites

Gannet runs in MATLAB. For best performance, we recommend using the latest release of MATLAB if possible. Additionally, Gannet requires that the following MATLAB toolboxes are installed:

  • Image Processing
  • Optimization
  • Signal Processing
  • Statistics and Machine Learning

You can check which toolboxes you have installed by typing ver in the MATLAB command window. To install any missing toolboxes, please follow these instructions.

To run the voxel co-registration and structural image segmentation modules, SPM12 must be installed.

Download

The simplest way to install Gannet is to download the code from the GitHub repository and move the Gannet-main/ directory into your MATLAB directory.

Alternatively, Git users can clone the Gannet repository into a directory of their choice:

git clone https://github.com/markmikkelsen/Gannet.git

The development version can be downloaded from the development branch on GitHub or by using the following Git command if the repository was cloned:

git checkout dev

Stable releases can be found here.

Setup

Open the Set Path dialog box from the MATLAB menu (or run the command pathtool in the Command Window), click Add with Subfolders..., find the downloaded Gannet directory and then select it. When done, press Save to permanently save the Gannet directory to MATLAB's default search path.

SPM12 can be installed in the same manner after it has been downloaded from the SPM website.

It is highly recommended that you only add the main SPM12 directory (spm12/) to your search path instead of including all the subdirectories. This prevents function conflicts.

If you have Osprey also installed on your computer, please ensure that you have either all the Gannet and SPM12 directories at the top of your search path or removed the Osprey directories from your search path. Gannet and Osprey share several functions that can lead to conflicts that result in Gannet not functioning correctly.

Compatibility

Gannet is currently being developed in MATLAB R2024b in macOS 15 Sequoia (Apple silicon). While reasonable effort is made to ensure legacy and cross-OS compatibility, an error-free user experience is not guaranteed.

Supported file formats

At present, the following MRS data file formats are supported:

  • DICOM (.dcm)
  • GE P-file (.7)
  • NIfTI-MRS (.nii[.gz])
  • Philips .data/.list
  • Philips .raw
  • Philips .sdat/.spar
  • Siemens DICOM (.ima)
  • Siemens .rda
  • Siemens TWIX (.dat)

For creating and co-registering voxel masks, structural images need to be in NIfTI format (DICOM files can also be used if processing GE P-files).

Philips users: Do not use structural images exported using the fsl-nifti option as this creates problems with co-registration in Gannet.

Getting help

If you encounter any problems, please first check the documentation website or the FAQ page for a solution.

Otherwise, you can post your query on the Gannet forum on the MRSHub.

The Gannet team can also be contacted directly. We will do our best to work with you to solve your issue.

Versioning

Gannet uses a form of semantic versioning in the style 'x.x.x' to mark code releases. Versioning is also conducted on a module-specific basis using the style 'YYMMDD'. That is, each Gannet module has its own release version. Users should note that module-specific versions sometimes are updated despite the semantic version number remaining unchanged (typically for minor updates/bug fixes).

Developers

  • Richard Edden (Johns Hopkins University) - creator
  • Mark Mikkelsen (Weill Cornell Medicine) - lead developer
  • Georg Oeltzschner (Johns Hopkins University) - contributor
  • Muhammad Saleh (Children's Hospital of Philadelphia) - contributor
  • C. John Evans (Cardiff University) - contributor
  • Ashley Harris (University of Calgary) - contributor
  • Nicolaas Puts (King's College London) - contributor

License and citing Gannet

This software is licensed under the open-source BSD-3-Clause License. Should you disseminate material that made use of Gannet, please cite the following publications, as appropriate:

If you perform frequency-and-phase correction (FPC) using:

Robust spectral registration (RobustSpecReg):

multi-step FPC (SpecRegHERMES):

or spectral registration (SpecReg):

If you perform tissue segmentation:

If you report water-referenced, tissue-corrected metabolite measurements using:

The Harris et al. method:

or the Gasparovic et al. method:

Acknowledgments

The development and dissemination of Gannet has been supported by the following National Institutes of Health (NIH) grants:

  • R01 EB016089
  • R01 EB023963
  • P41 EB015909
  • K99 EB028828
  • R01 MH106564
  • R21 MH098228
  • R21 NS077300
  • R01 MH096263

We wish to thank the following individuals for their direct or indirect contributions:

  • Yair Altman (Undocumented Matlab)
  • Peter Barker (Johns Hopkins University)
  • Alex Craven (University of Bergen)
  • Philipp Ehses (Max Planck Institute for Biological Cybernetics)
  • Robin de Graaf (Yale School of Medicine)
  • Xiangrui Li (Ohio State University)
  • Jamie Near (McGill University)
  • Ralph Noeske (GE HealthCare)
  • Wouter Potters (UMC Amsterdam)
  • Jan Simon (Heidelberg)

About

Gannet is a free, open-source MATLAB-based software toolkit for analyzing edited 1H magnetic resonance spectroscopy (MRS) data.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published