Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



67 Commits

Repository files navigation

jmzTab: Java library for reading and writing mzTab

Java CI with Maven DOI

The jmzTab library provide reading and writing capabilities, as well as supporting the validation of mzTab and the conversion of mzIdentML files to mzTab. Currently, the library contains converter for


  • jmzTabValidator, a command line interface (CLI), which provides a more flexible way of processing mzTab files in a batch mode. It also has validation and conversion functionality.

Currently, the tool can be downloaded from the releases section:

java -jar jmztab-{version}.jar -help

The output will like following:

usage: jmztab
 -check inFile=<inFile>             Choose a file from input directory. This parameter should not be null!
 -convert inFile=<inFile format=<format>   Converts the given format file (mzIdentML) to an mztab file.
 -h,--help                   print help message
 -message code=<code>             print Error/Warn detail message based on code number.
 -outFile <arg>              Dump output data to the given file. If not set, output data will be dumped on stdout.


The jmzTab library can easily be used in Maven projects. You can include the following snippets in your Maven pom file.

For parsing and writing mzTab


    <!-- based on mzTab specification version 1.0 -->

The jmzTab library can currently only be found in the [maven central]'s maven repository:



MZTabColumnFactory prh = MZTabColumnFactory.getInstance(Section.Protein_Header);
// add other optional columns
prh.addBestSearchEngineScoreOptionalColumn(ProteinColumn.BEST_SEARCH_ENGINE_SCORE, 1);

MZTabColumnFactor peh = MZTabColumnFactory.getInstance(Section.Peptide_Header);
// add other optional columns
peh.addBestSearchEngineScoreOptionalColumn(ProteinColumn.BEST_SEARCH_ENGINE_SCORE, 1);

MZTabColumnFactory psh = MZTabColumnFactory.getInstance(Section.PSM_Header);
// add other optional columns
psh.addSearchEngineScoreOptionalColumn(PSMColumn.SEARCH_ENGINE_SCORE, 1, null);

MZTabColumnFactory smh = MZTabColumnFactory.getInstance(Section.PSM_Header);
// add other optional columns
smh.addSearchEngineScoreOptionalColumn(PSMColumn.SEARCH_ENGINE_SCORE, 1, null);

mzTab Specification Document 1.0 RC 5 - (11. December 2013)

  • A completely updated version of the mzTab format specification
  • Version currently submitted to the PSI document process

For more information please see the ReleaseNote.


Perez-Riverol, Y. (2021). JmzTab 3.0: Java library to parse, validate and convert mztab proteomics files (Version 3.0.12) [Computer software]. DOI