A toolbox for quantitative MRI and in vivo histology using MRI (hMRI)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Merge branch 'master' into hMRIpaperRevis Nov 19, 2018
docs update release url in index.html Dec 21, 2018
etpm Fixing eTPM in code and readme Apr 7, 2017
examples Correct parameters for B1 example May 27, 2018
install Redirect config file for hMRI-Toolbox clean installation May 24, 2017
spm12 Updated spm_dicom_convert version number Dec 11, 2018
.gitignore add static version.txt Nov 14, 2017
CHANGELOG.md Updated CHANGELOG.md and version.txt Dec 20, 2018
LICENSE add LICENSE and README.md Nov 13, 2017
_config.yml Set theme jekyll-theme-slate Nov 5, 2018
hmri_autoreorient.m Updating local defaults and help text Oct 5, 2017
hmri_create_B1Map_process.m Continue metadata tidying up (UNICORT) Jun 10, 2018
hmri_create_B1Map_unwarp.m Renaming scripts May 4, 2017
hmri_create_FieldMap.m Renaming scripts May 4, 2017
hmri_create_MTProt.m Suffix MT saturation file name Nov 22, 2018
hmri_create_comm_adjust.m Use SPM progress bas in ACPC reorient May 11, 2017
hmri_create_pm_segment.m Unified segmentation - uniform usage Sep 20, 2017
hmri_get_defaults.m hMRI_get_defaults updated Feb 16, 2018
hmri_get_version.m Version output format Nov 23, 2018
hmri_log.m hmri_log: bug fixes Jul 7, 2018
hmri_run_create.m Small - but annoying - bug fix Jul 10, 2018
hmri_run_proc_US.m Including voxel size & BB selection Nov 13, 2017
hmri_run_proc_dartel_norm.m Use correct SPM-ver check Oct 9, 2017
hmri_run_proc_dartel_template.m Including output select into Dartel proc Oct 6, 2017
hmri_run_proc_smooth.m Output selection for smoothing module Oct 6, 2017
tbx_scfg_hmri_autoreorient.m Fixing small bug: output dependecies Apr 6, 2018
tbx_scfg_hmri_config.m Removed warning for UNIX/MAC users Aug 15, 2017
tbx_scfg_hmri_dicom_import.m New dictionary entries & matlab path... Sep 11, 2018
tbx_scfg_hmri_proc.m Improved naming + Defaut setting Apr 6, 2017
tbx_scfg_hmri_proc_pipeline.m change proc pipeline default to include Dartel Jun 12, 2018
tbx_scfg_hmri_proc_smooth.m Output selection for smoothing module Oct 6, 2017
version.txt Updated CHANGELOG.md and version.txt Dec 20, 2018


The hMRI-toolbox

A toolbox for quantitative MRI and in vivo histology using MRI (hMRI).


Neuroscience and clinical researchers are increasingly interested in quantitative magnetic resonance imaging (qMRI) due to its sensitivity to micro-structural properties of brain tissue such as axon, myelin, iron and water concentration (Weiskopf et al., 2015).

The hMRI-toolbox is an easy-to-use open-source and flexible tool, for qMRI data handling and processing. It allows the estimation of high-quality multi-parameter qMRI maps (longitudinal and effective transverse relaxation rates R1 and R2*, proton density PD and magnetisation transfer MT saturation) (Weiskopf et al., 2013), followed by spatial registration in common space for statistical analysis (Draganski et al., 2011).

Embedded in the Statistical Parametric Mapping (SPM) framework, it can be readily combined with existing SPM toolboxes for estimating diffusion MRI parameter maps, and it benefits from the extensive range of established SPM tools for high-accuracy spatial registration and statistical inferences.

The qMRI maps generated by the toolbox can be used for quantitative parameter analysis and accurate delineation of subcortical brain structures. They are key input parameters for biophysical models designed to estimate tissue microstructure properties such as the MR g-ratio and to derive standard and novel MRI biomarkers (Mohammadi et al., 2015). The hMRI toolbox is therefore a first step towards in vivo histology using MRI (hMRI) and is being extended further in this direction.


Online documentation is available as a Wiki. It provides guidelines and instructions for installation and usage of the hMRI-toolbox. These pages are work-in-progress and updated on a regular basis.

hMRI-Toolbox Paper

For a reference on the scientific background, methods and concepts please use this pre-print paper and cite it when publishing results compiled with the hMRI-toolbox.


The hMRI toolbox is free but copyright software, distributed under the terms of the GNU General Public Licence as published by the Free Software Foundation (either version 2, as given in file LICENSE, or at your option, any later version). Further details on "copyleft" can be found at http://www.gnu.org/copyleft/. In particular, the hMRI toolbox is supplied as is. No formal support or maintenance is provided or implied.


The latest release (and previous releases and pre-releases) of the hMRI-toolbox Matlab code can be downloaded as a zip archive from the releases page.

E-Mail List

We have created an e-mail list for users of the hMRI-toolbox: HMRI-TOOLBOX@JISCMAIL.AC.UK. Registered users can login to view the message archive on the list Home Page.

Developers of the hMRI-toolbox

The development of the hMRI toolbox is an international collaborative effort including the following sites and developers:

  • Tobias Leutritz, Enrico Reimer, Nikolaus Weiskopf (Max Planck Institute for Human Cognitive and Brain Sciences, Leipzig, Germany)
  • Evelyne Balteau, Christophe Phillips (University of Liege, Liege, Belgium)
  • Siawoosh Mohammadi (Medical Center Hamburg-Eppendorf, Hamburg, Germany)
  • Martina F Callaghan, John Ashburner (University College London, London, United Kingdom)
  • Karsten Tabelow (Weierstrass Institute for Applied Analysis and Stochastics, Berlin, Germany)
  • Bogdan Draganski, Ferath Kerif, Antoine Lutti (LREN, DNC - CHUV, University Lausanne, Lausanne, Switzerland)
  • Maryam Seif (University of Zurich, Zurich, Switzerland)
  • Gunther Helms (Department of Medical Radiation Physics, Lund University, Lund, Sweden)
  • Lars Ruthotto (Emory University, Atlanta, GA, United States)
  • Gabriel Ziegler (Otto-von-Guericke-University Magdeburg, Magdeburg, Germany)


  • Draganski, B., Ashburner, J., Hutton, C., Kherif, F., Frackowiak, R.S.J., Helms, G., Weiskopf, N., 2011. Regional specificity of MRI contrast parameter changes in normal ageing revealed by voxel-based quantification (VBQ). Neuroimage 55, 1423-1434. https://doi.org/10.1016/j.neuroimage.2011.01.052
  • Mohammadi, S., Carey, D., Dick, F., Diedrichsen, J., Sereno, M.I., Reisert, M., Callaghan, M.F., Weiskopf, N., 2015. Whole-Brain In-vivo Measurements of the Axonal G-Ratio in a Group of 37 Healthy Volunteers. Front Neurosci 9, 441. https://doi.org/10.3389/fnins.2015.00441
  • Weiskopf, N., Mohammadi, S., Lutti, A., Callaghan, M.F., 2015. Advances in MRI-based computational neuroanatomy: from morphometry to in-vivo histology. Curr. Opin. Neurol. 28, 313-322. https://doi.org/10.1097/WCO.0000000000000222
  • Weiskopf, N., Suckling, J., Williams, G., Correia, M.M., Inkster, B., Tait, R., Ooi, C., Bullmore, E.T., Lutti, A., 2013. Quantitative multi-parameter mapping of R1, PD*, MT, and R2* at 3T: a multi-center validation. Front. Neurosci. 7, 95. https://doi.org/10.3389/fnins.2013.00095

Acknowledgments and Funding

  • EB received funding from the European Structural and Investment Fund / European Regional Development Fund & the Belgian Walloon Government, project BIOMED-HUB (programme 2014-2020).
  • NW received funding from the European Research Council under the European Union's Seventh Framework Programme (FP7/2007-2013) / ERC grant agreement No 616905. This project has received funding from the European Union's Horizon 2020 research and innovation programme under the grant agreement No 681094, and is supported by the Swiss State Secretariat for Education, Research and Innovation (SERI) under contract number 15.0137.
  • SM received funding from the European Union's Horizon 2020 research and innovation programme under the Marie Sklodowska-Curie grant agreement No 658589.
  • NW and SM received funding from the BMBF (01EW1711A and B) in the framework of ERA-NET NEURON. BD is supported by the Swiss National Science Foundation (NCCR Synapsy, project grant Nr 32003B_159780) and Foundation Synapsis. LREN is very grateful to the Roger De Spoelberch and Partridge Foundations for their generous financial support.
  • MFC is supported by the MRC and Spinal Research Charity through the ERA-NET Neuron joint call (MR/R000050/1).
  • The Wellcome Centre for Human Neuroimaging is supported by core funding from the Wellcome [203147/Z/16/Z].
  • CP is supported by the F.R.S.-FNRS, Belgium.
  • The hMRI Toolbox project is supported by the Max Planck Society.