https://github.com/openms/pyopenms_viz
Streamlining Mass Spectrometry Data Visualization with Pandas
https://github.com/openms/pyopenms_viz
mass-spectrometry pandas visualization
Last synced: about 1 month ago
JSON representation
Streamlining Mass Spectrometry Data Visualization with Pandas
- Host: GitHub
- URL: https://github.com/openms/pyopenms_viz
- Owner: OpenMS
- License: bsd-3-clause
- Created: 2024-04-15T16:00:05.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-25T12:30:28.000Z (2 months ago)
- Last Synced: 2025-04-18T11:03:51.524Z (about 1 month ago)
- Topics: mass-spectrometry, pandas, visualization
- Language: Jupyter Notebook
- Homepage:
- Size: 80.6 MB
- Stars: 14
- Watchers: 3
- Forks: 17
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pyOpenMS-viz: The Python Pandas-Based Mass Spectrometry Visualization Library
[](https://img.shields.io/pypi/pyversions/pyopenms_viz)
[](https://img.shields.io/pypi/v/pyopenms_viz
)
[](https://pypistats.org/packages/pyopenms_viz)
[](https://pyopenms-viz.readthedocs.io/en/latest/index.html)
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
## Suported 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 environemnt:
```bash
conda create --name=pyopenms_viz python=3.12
conda activate pyopenms_viz
```
Then in the new environment install pyopenms_viz.
```bash
pip install pyopenms_viz --upgrade
```
## Documentation
Documentation can be found [here](https://pyopenms-viz.readthedocs.io/en/latest/index.html)
## 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](https://pubs.acs.org/doi/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](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](https://doi.org/10.1002/pmic.201300246). PMID: [24420968](https://pubmed.ncbi.nlm.nih.gov/24420968/).