nmrML is an open mark-up language for NMR data. This is the official repository for development of the nmrML schema and NMR ontology.
HTML R Python Java XSLT Matlab Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
MI-Recommendations R nmrML reader Jan 9, 2018
docs moved Jan 23, 2018
examples updates of converter Jun 25, 2018
lib R nmrML reader Jan 9, 2018
mappings R nmrML reader Jan 9, 2018
ontologies R nmrML reader Jan 9, 2018
tools updates of converter Jun 25, 2018
xml-schemata updates of converter Jun 25, 2018
.gitignore R nmrML reader Jan 9, 2018
AUTHORS R nmrML reader Jan 9, 2018
HISTORY.md R nmrML reader Jan 9, 2018
LICENSE R nmrML reader Jan 9, 2018
Makefile R nmrML reader Jan 9, 2018
README.md Update README.md Feb 15, 2018
VERSION R nmrML reader Jan 9, 2018


nmrML logo

nmrML is an open mark-up language for NMR raw and spectral data. It has recently seen its first release, ready for public use. The development of this standard was previously coordinated by the COSMOS FP7- COordination Of Standards In MetabOlomicS Project. It is now maintained within the PhenoMeNal H2020 project, setting up metabolomics data analysis e-infrastructures. The nmrML data standard is approved by the Metabolomics Standards Initiative and was derived from an earlier NMR XML format that was developed by the Metabolomics Innovation Centre (TMIC). It follows design principles of its role model, the mzML data standard, created by HUPO-PSI community for mass spectrometry.

nmrML links

Development Partners & Contributions

The Metabolomics Innovation Centre

The Metabolomics Innovation Centre (TMIC) is a Canadian-funded core facility that has a unique combination of infrastructure and personnel to perform a wide range of cutting-edge metabolomic studies for clinical trials research, biomedical studies, bioproducts studies, nutrient profiling and environmental testing. The TMIC platform is led by Dr. David Wishart (University of Alberta), Dr. Christoph Borchers (University of Victoria) and Dr. Liang Li (University of Alberta). This group delivered the nmrML predecessor that is amended and extended in the COSMOS Project.

Leibniz-Institute of Plant Biochemistry

The Institute of Plant Biochemistry (IPB) is a non-university research centre of the Leibniz Association (www.wgl.de), It investigates in a multidisciplinary style structure and function of natural products from plants and fungi, analyse interactions of plants with pathogenic and symbiotic microorganisms and study molecular interactions as part of complex biological processes. At the IPB, plant metabolomics has been an important area of research for many years. The IPB leads the standards development workpackage within the COSMOS project.

The Metabolome Facility of Bordeaux Functional Genomics Centre

The Metabolome Facility of Bordeaux Functional Genomics Centre (MFB) is mostly dedicated to plant and plant-derived products metabolomics. MFB is implicated in the French Metabolomics and Fluxomics Network and is a partner of MetaboHUB project aiming at the development of a French Metabolome Infrastructure. MFB provides expertise and tools along the complete metabolomics pipeline. In collaboration with the Bioinformatics Facility of Bordeaux, it has developed MeRy-B database for NMR plant metabolome data. Recent dry-lab developments of MFB concern 1H-NMR spectra processing. MFB participates in the NMR group within the COSMOS project.



The versioning follow the [Major].[Minor].[Build], the version number is tracked inthe VERSION file in the root of the nmrML directory. Versioning is tracked using the taggin feature of git. All previous versions can be viewed here.

Follow these intructions to create release a tagged version:

  1. Commit changes in your working directory that you want in this release. It is a good idea to push these changes to GitHub before continuing. Make sure the changes you want in this release are merged with master.
  2. Make sure the HISTORY.md file is updated with the changes in this release. Follow the format in the file.
  3. Bump the version, rebuild the docs, tag the release and push the release to Github with one of the following commands:
    • For a major release: make release_major
    • For a minor release: make release_minor
    • For a build release: make release_build
  4. Now you can push the release with: git push --tags

Directory Structure

  • docs
  • examples
    • vendor - Useful example files from other software and data formats
    • nmrML - Example files for different use cases of nmrML
  • lib - Scripts/code used for generating docs, etc.
  • mappings - Files that map variable names in other formats to variable names in nmrML. Used by conversion software.
  • ontologies - The ontology files describing the controlled vocabulary
  • xml-schemata - The .xsd files describing the nmrML schema
  • tools - Example software using nmrML