Skip to content

SLINGhub/MRMhub

Repository files navigation

MRMhub MRMhub logo

Version License: AGPL v3 bioRxiv R-CMD-check Codecov test coverage

MRMhub is an open-source, one-stop framework for reproducible, automated processing of targeted metabolomics and lipidomics data acquired by liquid chromatography–mass spectrometry (LC–MS) in Multiple Reaction Monitoring (MRM) mode. Addressing well-known gaps in the robustness and scalability of existing software, it takes an experiment from raw instrument data to quality-controlled quantitative results, processing population-scale studies within minutes on standard hardware while recording a full digital footprint of every step for reproducibility and traceability. Built for both analytical and bioinformatics scientists, MRMhub provides modular functions and defined data structures that adapt to diverse study designs and data formats, supporting customizable, fully documented end-to-end workflows across two complementary modules:

  • INTEGRATOR (the MRMhub binary) - a fast, memory-efficient, multithreaded standalone application for consensus-based peak integration across large analysis sequences, with per-feature integration settings. It reads mzML (vendor raw files converted via msconvert) and exports integrated peak areas that feed directly into QUANT or other post-processing tools. Learn more ↗
  • QUANT (the mrmhub R package) - a programmatic library for building tailored, reproducible post-processing and quality-control pipelines. It reads INTEGRATOR results directly, or feature-intensity data from other sources (CSV, mzTab-M, Skyline). Learn more ↗

MRMhub processing overview: four pipeline stages. Peak Integration (retention time alignment, peak identification and selection, peak border refinement, integration, reporting) is performed by INTEGRATOR; Quantitation, Quality Control, and Reporting are performed by QUANT.

Installation

  • INTEGRATOR: download the macOS or Windows build from Releases, but read the INTEGRATOR installation guide first (for first-launch security warnings and project setup).

  • QUANT: install from GitHub in a fresh RStudio/Positron session (requires R ≥ 4.1). Please read the QUANT installation guide first for full instructions and troubleshooting.

    if (!require("pak")) install.packages("pak")
    pak::pak("SLINGhub/MRMhub")
    library(mrmhub)

Getting started

Browse analyses - MRMhub-workflows ↗ shows annotated, end-to-end data-processing reports from large-scale lipidomics analyses and a fully quantitative assay.

Run the demo - download the latest release ↗ and follow the bundled readme.txt to process the demo project end-to-end with both modules.

Documentation

QUANT module usage

INTEGRATOR runs as a desktop app (see Quick Start ↗). QUANT is an R package. The example below runs on the bundled demo data and can be extended in the same way to quantitation, drift/batch correction, QC metrics, and feature filtering:

library(mrmhub)

demo_file <- system.file("extdata", "MRMhub_demo.tsv", package = "mrmhub")

# `mexp` is the container holding all data and results across the script
mexp <- MRMhubExperiment() |>
  import_data_mrmhub(path = demo_file, import_metadata = TRUE) |>
  normalize_by_istd()

# Inspect ISTD-normalized signal for selected lipid classes (2 x 3 panel)
plot_runscatter(
  mexp,
  variable = "norm_intensity",
  rows_page = 2, cols_page = 3,
  include_feature_filter = "^(Cer|PC)"   # names as a vector or regex
)

# Export a multi-sheet QC report
save_report_xlsx(mexp, path = "results.xlsx")

Authors & Contact

Contributing

Bug reports and feature requests are welcome via GitHub issues. The project follows the Contributor Code of Conduct.

Citation

Burla B. et al. (2025). MRMhub: one-stop solution for automated processing of large-scale targeted metabolomics data. bioRxiv. doi:10.64898/2025.12.20.695370

License

Dual-licensed - non-commercial under GNU AGPLv3. For commercial use contact Jonathan Tan (jonathan_tan@nus.edu.sg).

Releases

Packages

Contributors

Languages