matchms

Process, normalize, and compare mass spectra for metabolite identification.

33.0k|3.2k|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/K-Dense-AI/scientific-agent-skills --skill matchms-k-dense-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matchms
Source: https://github.com/K-Dense-AI/scientific-agent-skills/tree/main/scientific-skills/matchms
Command: npx skills add https://github.com/K-Dense-AI/scientific-agent-skills --skill matchms-k-dense-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Matchms provides a programmable framework to process, normalize, and compare mass spectra for reliable metabolite identification from spectral libraries.

Core Features & Use Cases

  • Import spectra from multiple formats (MGF, MSP, mzML, JSON) and harmonize metadata
  • Compute multiple spectral similarity metrics (CosineGreedy, ModifiedCosine, NeutralLossesCosine) for library searching and annotation
  • Build reproducible processing pipelines, annotate chemical structures (InChI, InChIKey), and derive fingerprints for integrated analyses
  • Use cases include metabolite identification, library matching, QC, and multi-step workflows across biology and chemistry

Quick Start

Load a small library and query spectra, apply default filters, and compute cosine similarity to identify top matches.

Frequently Asked Questions about matchms

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I process mass spectrometry data for metabolite identification?

To identify metabolites from mass spectrometry data, import spectra from formats like MGF, MSP, mzML, or JSON, apply default filters to normalize metadata, and compute cosine similarity scores against a reference library to retrieve top matches.

What is spectral matching for metabolomics and how does it work?

Spectral matching compares query mass spectra against reference libraries using similarity scoring algorithms like CosineGreedy, ModifiedCosine, and NeutralLossesCosine to robustly annotate chemical structures and identify metabolites.

Can I use mzML and MGF files for library searching in the same pipeline?

Yes, you can import and harmonize spectra from multiple formats including mzML, MGF, MSP, and JSON within the same reproducible pipeline to perform comprehensive library searching across diverse data sources.

What is the best way to normalize mass spectra metadata before comparison?

The best way to normalize mass spectra metadata is to apply programmable filtering pipelines that harmonize metadata fields across imported formats, ensuring consistent annotation linking to chemical structures like InChI and InChIKey before comparison.

Which spectral similarity metrics should I use for library searching?

For library searching, use multi-metric scoring with CosineGreedy, ModifiedCosine, and NeutralLossesCosine to evaluate different structural alignment properties, providing robust metabolite identification across diverse spectral data.

Why do I need to derive fingerprints during metabolite annotation?

Deriving fingerprints during metabolite annotation links matched spectra to chemical structures for integrated analyses, enabling structural comparison and validation alongside the similarity scores obtained from your library search.