pyopenms-viz 1.0.1

A package for visualizing mass spectrometry data using pandas dataframes

pyOpenMS-viz: The Python Pandas-Based Mass Spectrometry Visualization Library

pyOpenMS-Viz is a Python library that provides a simple interface for extending the plotting capabilities of Pandas DataFrames for creating static or interactive visualizations of mass spectrometry data. It integrates seamlessly with various plotting library backends (matpotlib, bokeh and plotly) and leverages the power of Pandas for data manipulation and representation.

Features

• Flexible plotting API that interfaces directly with Pandas DataFrames
• Support for multiple plotting backends: matplotlib (static), bokeh and plotly (interactive)
• Visualization of various mass spectrometry data types, including 1D chromatograms, spectra, and 2D peak maps
• Versatile column selection for easy adaptation to different data formats
• Consistent API across different plotting backends for easy switching between static and interactive plots
• Suitable for use in scripts, Jupyter notebooks, and web applications

Supported Plots

Plot Type	Required Dimensions	pyopenms_viz Name	Matplotlib	Bokeh	Plotly
Chromatogram	x, y	chromatogram	✓	✓	✓
Mobilogram	x, y	mobilogram	✓	✓	✓
Spectrum	x, y	spectrum	✓	✓	✓
PeakMap 2D	x, y, z	peakmap	✓	✓	✓
PeakMap 3D	x, y, z	peakmap (plot3d=True)	✓		✓

(Recommended) Pip Installation

The recommended way of installing pyopenms_viz is through the Python Package Index (PyPI). We recommend installing pyopenms_viz in its own virtual environment using Anaconda to avoid packaging conflicts.

First create a new environment:

conda create --name=pyopenms_viz python=3.12
conda activate pyopenms_viz 

Then in the new environment install pyopenms_viz.

pip install pyopenms_viz --upgrade

Documentation

Documentation can be found here

References

• Sing, J., Charkow, J., Walter, A. et al. pyOpenMS-viz: Streamlining Mass Spectrometry Data Visualization with pandas. Journal of Proteome Research, (2025) https://doi.org/10.1021/acs.jproteome.4c00873

• Pfeuffer, J., Bielow, C., Wein, S. et al. OpenMS 3 enables reproducible analysis of large-scale mass spectrometry data. Nat Methods 21, 365–367 (2024). https://doi.org/10.1038/s41592-024-02197-7

• Röst HL, Schmitt U, Aebersold R, Malmström L. pyOpenMS: a Python-based interface to the OpenMS mass-spectrometry algorithm library. Proteomics. 2014 Jan;14(1):74-7. https://doi.org/10.1002/pmic.201300246. PMID: 24420968.