The MRS4Brain Toolbox is developed by MRS4Brain research group @ CIBM MRI EPFL AIT and was designed to offer advanced functionalities for Bruker preclinical MRSI data, encompassing preprocessing, fitting, quantification, semi-automatic quality control, co-registration and segmentation of metabolic maps using anatomical images, all conveniently integrated within a single open-source graphical user interface (GUI). The development of this user-friendly toolbox aims to streamline the processing workflow and enhance the accessibility of MRSI for researchers in the preclinical field.
The MRS4Brain Toolbox is written in MATLAB 2023a (MathWorks, USA) and encompasses three distinct spectroscopy modalities (MRSI, single voxel MRS, dMRS), with our primary focus directed towards MRSI.
- raw Bruker Paravision 360 (version 1.1 (fid) and 3.3 (fid_proc.64)) data
- 1H-FID-MRSI, 1H-PRESS-MRSI
- 1H-SVS
- 1H-dMRS
-
The main functionalities are described in the document MRS4Brain_Toolbox.pdf , recently submitted manuscript to NMR Biomed (https://arxiv.org/abs/2307.03261, under revision) and in the accepted abstract at ISMRM 2024 (Briand G., Alves B., Mosso J, Pierzchala K., Near J., Lanz B., Cudalbu C. MRS4Brain Toolbox: an harmonized and accessible workflow for preclinical MRSI data processing, ISMRM 2024 Singapore)
-
External software:
-
The MRS4Brain Toolbox utilizes an additional software, ANTs, for registration and segmentation purposes. ANTs is designed for the UNIX environment. To facilitate this on non-UNIX systems, we employ another tool called Docker Desktop, enabling the containerization of Linux-built software. Details can be found here: Registration_MRS4Brain_Toolbox.pdf
-
ANTs is combined with an in-house developed template (Wistar adult rat brain, acquisitions at 14.1T) based on the SIGMA atlas, customized to handle the dimensions of the rodent brain.
-
LCModel (version 6.2) is used for metabolite fitting. LCModel is now freely available and can be downloaded from here: http://s-provencher.com/lcmodel.shtml or schorschinho/LCModel: A collection of compiled LCModel binaries for various operating systems. (github.com)
-
The preprocessing steps in SVS are based on FID-A functions CIC-methods/FID-A: Toolbox for simulation and processing of in-vivo magnetic resonance spectroscopy (MRS) data (github.com)
-
-
Live Demos on how to use the toolbox can be found here: https://www.epfl.ch/labs/mrs4brain/links/live-demos/
-
Data sets are available here:
- RAW data
- Same RAW data + processing
- Control Files for LCModel
- Metabolite basis set (for AD=1.3ms)
- MATLAB version 2023a or later version (on all operating systems)
- ANTs (on all operating systems)
- LCModel version 6.2 (on all operating systems)
- Docker (for Windows & MAC OS, https://www.docker.com/products/docker-desktop/)
- On Windows & MAC OS:
- Download and install docker desktop (no account is required)
- Start docker desktop
- Run in Windows Powershell:
wsl --update
(ifwsl
is not installed, please runwsl --install
) - Run in Windows Powershell:
docker pull antsx/ants:latest
- Check that the image is successfully installed on docker by running in Windows Powershell :
docker run --rm antsx/ants /opt/ants/bin/antsRegistration
. If the console returns something akin to what is seen in the printscreen below, ANTs has been successfully installed on your computer docker !
-
On Linux : No need for docker desktop. Just launch the MRS4BRAIN_toolbox.mlapp
-
For all operating systems:
- Launch your version of MATLAB
- Add to path the folder containing the MRS4Brain_toolbox (Selected folders and subfolders)
- Launch the MRS4BRAIN_toolbox command (either via your MATLAB console or with any commands you would use in your operating system)
- After selecting the modality of your choice, click on parameters button (symbolized with the symbol below) and select the necessary folders for your task (LCModel location, Template masks, Config files, etc.)
Brayan Alves
Guillaume Briand
Jessie Mosso
For more details please check Contributors file
Should you publish material that made use of MRS4Brain toolbox, please cite the following publication:
“Fast high-resolution metabolite mapping in the rat brain using 1 H-FID-MRSI at 14.1T”
Dunja Simicic, Brayan Alves, Jessie Mosso, Guillaume Briand, Thanh Phong Lê, Ruud B. van Heeswijk, Jana Starčuková, Bernard Lanz, Antoine Klauser, Bernhard Strasser, Wolfgang Bogner, Cristina Cudalbu
under review in NMR in Biomed
“Noise-reduction techniques for 1H-FID-MRSI at 14.1T: Monte-Carlo validation & in vivo application”
Brayan Alves, Dunja Simicic, Jessie Mosso, Thanh Phong Lê, Guillaume Briand, Wolfgang Bogner, Bernard Lanz, Bernhard Strasser, Antoine Klauser, Cristina Cudalbu
Under review in NMR in Biomed
Thanks for your interest in our MRS4Brain toolbox. For any sort of questions, feedback, suggestions, or critique, please contact us brayan.alves@epfl.ch, cristina.cudalbu@epfl.ch. We also welcome your direct contributions to MRS4Brain toolbox here in the GitHub repository.
Financial support was provided by the Swiss National Science Foundation (Project No. 310030_201218).
We acknowledge access to the facilities and expertise of the CIBM Center for Biomedical Imaging founded and supported by Lausanne University Hospital (CHUV), University of Lausanne (UNIL), Ecole polytechnique fédérale de Lausanne (EPFL), University of Geneva (UNIGE) and Geneva University Hospitals (HUG).
MRS4Brain toolbox is licensed under a non-commercial license. If you need more information, please contact us brayan.alves@epfl.ch, cristina.cudalbu@epfl.ch