pymzml

General information

Module to parse mzML data in Python based on cElementTree

M. Kösters,

J. Leufken,

T. Bald,

A. Niehues,

S. Schulze,

K. Sugimoto,

R.P. Zahedi,

M. Hippler,

S.A. Leidel,

C. Fufezan,

Contact information

Please refer to:

Dr. Christian Fufezan

Group Leader Experimental Bioinformatics

Cellzome GmbH

R&D Platform Technology & Science

GSK

Germany

eMail: christian@fufezan.net

https://fufezan.net

Summary

pymzML is an extension to Python that offers

1. easy access to mass spectrometry (MS) data that allows the rapid development of tools
1. a very fast parser for mzML data, the standard mass spectrometry data format
1. a set of functions to compare and/or handle spectra
1. random access in compressed files
1. interactive data visualization

Implementation

pymzML requires Python3.13+. The module is freely available on pymzml.github.com or pypi, published under MIT license and only requires numpy and regex, however there are several optional dependencies for extended functionality like interactive plotting and deconvolution.

Download

Get the latest version via github: https://github.com/pymzml/pymzML
The complete Documentation can be found here: https://pymzml.github.io/pymzML/

Citation

M Kösters, J Leufken, S Schulze, K Sugimoto, J Klein, R P Zahedi, M Hippler, S A Leidel, C Fufezan; pymzML v2.0: introducing a highly compressed and seekable gzip format, Bioinformatics, doi: https://doi.org/10.1093/bioinformatics/bty046

Installation

pymzML requires Python 3.13 or higher.

Download pymzML using GitHub or the zip file:

GitHub version: Start by cloning the GitHub repository:

user@localhost:~$ git clone https://github.com/pymzML/pymzml.git
user@localhost:~$ cd pymzml
user@localhost:~$ pip install -r requirements.txt
user@localhost:~$ python setup.py install

pypi version:

user@localhost:~$ pip install pymzml # install standard version
user@localhost:~$ pip install "pymzml[plot]" # with plotting support
user@localhost:~$ pip install "pymzml[pynumpress]" # with pynumpress support
user@localhost:~$ pip install "pymzml[deconvolution]" # with deconvolution support using ms_deisotope
user@localhost:~$ pip install "pymzml[full]" # full featured

If you have troubles installing the dependencies, install numpy first separately, since pynumpress requires numpy to be installed.

If you use Windows 7 please use the ‘SDK7.1 command prompt’ for installation of pymzML to assure correct compiling of the C extensions.

Testing

To test the package and correct installation:

tox

Contributing

Please read the contribution guidelines before contributing here

Code of Conduct

Since pymzML is an open source project maintained by the community, we established a code of conduct in order to facilitate an inclusive environment for all users, contributors and project memebers. Before contributing to pymzML, please read the code of conduct here

Metadata

Release files for pymzml 2.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pymzml 2.7.0
File	Size	Uploaded
pymzml-2.7.0.tar.gz	25.3 MB	Sep 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pymzml 2.7.0
File	Interpreter	ABI	Platform	Reset
pymzml-2.7.0-py3-none-any.whl 17.8 MB Sep 7, 2026	Python 3	none	any	Details

Total release size: 43.1 MB

Release files / pymzml-2.7.0.tar.gz

Download URL	pymzml-2.7.0.tar.gz
Size	25.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`daba6ab5f91719de549ecd29d49789abd4678f43bef021c97a8ef84b96de25da`
BLAKE2b-256 checksum How to use checksums	`3fc94f0be3dff579711339e333229481748b99818b5dd9f3e176b65d3f20f417`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / pymzml-2.7.0-py3-none-any.whl

Download URL	pymzml-2.7.0-py3-none-any.whl
Size	17.8 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`0ae9148c1a1501ff727f8c01890edc5101325bf6feb0480db938da7f85435b81`
BLAKE2b-256 checksum How to use checksums	`58e673ad27f53258a05e23043a3d4fd70ab8589ad999495f2d1259405cfc07f8`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`