Skip to content

NOMspectra/NOMspectra

Repository files navigation

PyPI Documentation Status Python package DOI

nomspectra

logo

nomspectra is an open-source Python package for processing high resolution mass spectra. The name is an acronym for Natural Organic Matter & Humic Substances Mass Spectrometry, so package designed for analysis natural organic matter (NOM) which are represent such substances as dissolve organic matter (DOM), humic substances, lignin, biochar and other objects of oxidative destruction of natural compounds which are characterized by thousands of signals in the mass spectrum and require special methods for analysis. The package implements a full-fledged workflow for processing, analysis and visualization of mass spectrum. Various algorithms for filtering spectra, recalibrating and assignment of elemental composition to ions are presented. The package implements methods for calculating different molecular descriptors and methods for data visualization. A graphical user interface (GUI) for package has been implemented, which makes this package convenient for a wide range of users.

Main operation

  • Assigning element composition to signal by mass with desirable ranges of elements (include isotopes)
  • Fine recalibrate spectrum
  • Working with spectra as with sets (intersection, union, etc.)
  • Plot spectrum and different kind of scatter and density diagram such as Van Krevelen diagram
  • Calculate similarity metrics between spectra
  • Calculate molecular descriptors (DBE, AI, NOSC, CRAM and other) for spectra

figures

Documentation

Documentation and examples of usage is placed here. Also, you can explore jupyter notebooks

Install

Requirements:

  • Python 3.8 or higher

Install nomspectra and dependences by pip:

pip install nomspectra

Graphical interface

After installation nomspectra you can run GUI by the command:

python -m nomspectra

The GUI is pretty basic and not very flexible but it supports all basic operation.

How to contribute or ask question

If you want to ask question or contribute to the development of nomspectra, have a look at the contribution guidelines.

License

Distributed under license GPLv3

Citate us

When using NOMspectra, please cite : A. Volikov, G. Rukhovich, I.V. Perminova. NOMspectra: An Open-Source Python Package for Processing High Resolution Mass Spectrometry Data on Natural Organic Matter. J. Am. Soc. Mass Spectrom. 2023. https://doi.org/10.1021/jasms.3c00003