PeakPerformance - A tool for Bayesian inference-based fitting of LC-MS/MS peaks

PeakPerformance - A tool for Bayesian inference-based fitting of LC-MS/MS peaks - Published in JOSS (2024)

https://github.com/jubiotech/peak-performance

Science Score: 96.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 7 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org, zenodo.org
  • Academic email domains
  • Institutional organization owner
    Organization jubiotech has institutional domain (www.fz-juelich.de)
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

bayesian-inference hplc liquid-chromatography mass-spectrometry metabolomics

Scientific Fields

Engineering Computer Science - 40% confidence
Last synced: 6 months ago · JSON representation

Repository

A Python toolbox for Bayesian inference of peak areas.

Basic Info
Statistics
  • Stars: 6
  • Watchers: 4
  • Forks: 0
  • Open Issues: 2
  • Releases: 5
Topics
bayesian-inference hplc liquid-chromatography mass-spectrometry metabolomics
Created over 2 years ago · Last pushed 6 months ago
Metadata Files
Readme License Citation

README.md

PyPI version pipeline coverage documentation DOI DOI

About PeakPerformance

PeakPerformance employs Bayesian modeling for chromatographic peak data fitting. This has the innate advantage of providing uncertainty quantification while jointly estimating all peak parameters united in a single peak model. As Markov Chain Monte Carlo (MCMC) methods are utilized to infer the posterior probability distribution, convergence checks and the aformentioned uncertainty quantification are applied as novel quality metrics for a robust peak recognition.

Installation

It is highly recommended to follow the following steps and install PeakPerformance in a fresh Python environment: 1. Install the package manager Mamba. Choose the latest installer at the top of the page, click on "show all assets", and download an installer denominated by "Mambaforge-version number-name of your OS.exe", so e.g. "Mambaforge-23.3.1-1-Windows-x86_64.exe" for a Windows 64 bit operating system. Then, execute the installer to install mamba and activate the option "Add Mambaforge to my PATH environment variable".

If you have already installed Miniconda, you can install Mamba on top of it but there are compatibility issues with Anaconda.

The newest conda version should also work, just replace mamba with conda in step 2.

  1. Create a new Python environment in the command line using the provided environment.yml file from the repo. Download environment.yml first, then navigate to its location on the command line interface and run the following command: mamba env create -f environment.yml

Naturally, it is alternatively possible to just install PeakPerformance via pip:

bash pip install peak-performance

First steps

Be sure to check out our thorough documentation. It contains not only information on how to install PeakPerformance and prepare raw data for its application but also detailed treatises about the implemented model structures, validation with both synthetic and experimental data against a commercially available vendor software, exemplary usage of diagnostic plots and investigation of various effects. Furthermore, you will find example notebooks and data sets showcasing different aspects of PeakPerformance.

How to contribute

If you encounter bugs while using PeakPerformance, please bring them to our attention by opening an issue. When doing so, describe the problem in detail and add screenshots/code snippets and whatever other helpful material you can provide. When contributing code, create a local clone of PeakPerformance, create a new branch, and open a pull request (PR).

How to cite

Head over to Zenodo to generate a BibTeX citation for the latest release. In addition to the utilized software version, please cite our scientific publication over at the Journal of Open Source Software (JOSS). A detailed citation can be found in CITATION.cff and in the sidebar.

Owner

  • Name: IBG-1: Biotechnology
  • Login: JuBiotech
  • Kind: organization
  • Location: Forschungszentrum Jülich

JOSS Publication

PeakPerformance - A tool for Bayesian inference-based fitting of LC-MS/MS peaks
Published
December 13, 2024
Volume 9, Issue 104, Page 7313
Authors
Jochen Nießer ORCID
Institute for Bio- and Geosciences (IBG-1), Forschungszentrum Jülich GmbH, Jülich, Germany, RWTH Aachen University, Aachen, Germany
Michael Osthege ORCID
Institute for Bio- and Geosciences (IBG-1), Forschungszentrum Jülich GmbH, Jülich, Germany
Eric von Lieres ORCID
Institute for Bio- and Geosciences (IBG-1), Forschungszentrum Jülich GmbH, Jülich, Germany, Computational Systems Biotechnology, RWTH Aachen University, Aachen, Germany
Wolfgang Wiechert ORCID
Institute for Bio- and Geosciences (IBG-1), Forschungszentrum Jülich GmbH, Jülich, Germany, Computational Systems Biotechnology, RWTH Aachen University, Aachen, Germany
Stephan Noack ORCID
Institute for Bio- and Geosciences (IBG-1), Forschungszentrum Jülich GmbH, Jülich, Germany
Editor
Charlotte Soneson ORCID
Tags
Peak fitting Bayesian inference Chromatography LC-MS/MS Uncertainty quantification

GitHub Events

Total
  • Create event: 15
  • Release event: 1
  • Issues event: 13
  • Watch event: 4
  • Delete event: 13
  • Issue comment event: 22
  • Push event: 34
  • Pull request review comment event: 4
  • Pull request review event: 10
  • Pull request event: 30
  • Fork event: 2
Last Year
  • Create event: 15
  • Release event: 1
  • Issues event: 13
  • Watch event: 4
  • Delete event: 13
  • Issue comment event: 22
  • Push event: 34
  • Pull request review comment event: 4
  • Pull request review event: 10
  • Pull request event: 30
  • Fork event: 2

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 6
  • Total pull requests: 43
  • Average time to close issues: 6 days
  • Average time to close pull requests: 16 days
  • Total issue authors: 3
  • Total pull request authors: 5
  • Average comments per issue: 2.0
  • Average comments per pull request: 0.98
  • Merged pull requests: 39
  • Bot issues: 0
  • Bot pull requests: 12
Past Year
  • Issues: 5
  • Pull requests: 28
  • Average time to close issues: 6 days
  • Average time to close pull requests: 9 days
  • Issue authors: 2
  • Pull request authors: 5
  • Average comments per issue: 2.4
  • Average comments per pull request: 0.89
  • Merged pull requests: 26
  • Bot issues: 0
  • Bot pull requests: 5
Top Authors
Issue Authors
  • Adafede (4)
  • michaelosthege (2)
  • dependabot[bot] (1)
  • lazear (1)
Pull Request Authors
  • Y0dler (30)
  • michaelosthege (23)
  • dependabot[bot] (21)
  • lazear (2)
  • xuanxu (1)
Top Labels
Issue Labels
documentation (2) dependencies (1) github_actions (1)
Pull Request Labels
dependencies (25) github_actions (18) enhancement (6) documentation (5) python (5) refactoring (4) bug (3)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 74 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 4
  • Total maintainers: 1
pypi.org: peak-performance

A Python toolbox to fit chromatography peaks with uncertainty.

  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 74 Last month
Rankings
Dependent packages count: 10.2%
Downloads: 14.8%
Average: 30.7%
Dependent repos count: 67.1%
Maintainers (1)
Last synced: 6 months ago

Dependencies

.github/workflows/pre-commit.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v4 composite
  • pre-commit/action v3.0.0 composite
.github/workflows/release.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v4 composite
.github/workflows/tests.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v3 composite
.github/workflows/cla.yml actions
  • contributor-assistant/github-action v2.3.1 composite
docs/requirements.txt pypi
  • myst-nb *
  • nbsphinx *
  • numpydoc *
  • sphinx *
  • sphinx-book-theme *
  • sphinxcontrib.mermaid *
.github/workflows/draft-pdf.yml actions
  • actions/checkout v4 composite
  • actions/upload-artifact v4 composite
  • openjournals/openjournals-draft-action master composite
environment.yml conda
  • arviz
  • jupyter
  • matplotlib
  • numba
  • numpy <2
  • nutpie
  • openpyxl
  • pip
  • pymc
  • python 3.11.*
pyproject.toml pypi
requirements-dev.txt pypi
  • pytest * development
  • pytest-cov * development
  • twine * development
  • wheel * development
requirements.txt pypi
  • arviz *
  • matplotlib *
  • numpy <2
  • numpy *
  • openpyxl *
  • pandas *
  • pymc >=5.9.1
  • pytensor *
  • scipy *
setup.py pypi