鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册

matchms

面向质谱数据分析,支持多种格式光谱文件的导入导出、元数据标准化、峰强度归一化与过滤、谱图相似性计算(如余弦相似度及改进算法),并可构建可复现的处理流程,服务于代谢组学等领域的化合物鉴定与数据解析。

研究
访问 GitHub
文档Skills.MD
name
matchms
description
Mass spectrometry analysis. Process mzML/MGF/MSP, spectral similarity (cosine, modified cosine), metadata harmonization, compound ID, for metabolomics and MS data processing.

Matchms

Overview

Matchms is an open-source Python library for mass spectrometry data processing and analysis. Import spectra from various formats, standardize metadata, filter peaks, calculate spectral similarities, and build reproducible analytical workflows.

Core Capabilities

1. Importing and Exporting Mass Spectrometry Data

Load spectra from multiple file formats and export processed data:

▼
python
复制代码
from matchms.importing import load_from_mgf, load_from_mzml, load_from_msp, load_from_json from matchms.exporting import save_as_mgf, save_as_msp, save_as_json # Import spectra spectra = list(load_from_mgf("spectra.mgf")) spectra = list(load_from_mzml("data.mzML")) spectra = list(load_from_msp("library.msp")) # Export processed spectra save_as_mgf(spectra, "output.mgf") save_as_json(spectra, "output.json")

Supported formats:

  • mzML and mzXML (raw mass spectrometry formats)
  • MGF (Mascot Generic Format)
  • MSP (spectral library format)
  • JSON (GNPS-compatible)
  • metabolomics-USI references
  • Pickle (Python serialization)

For detailed importing/exporting documentation, consult references/importing_exporting.md.

2. Spectrum Filtering and Processing

Apply comprehensive filters to standardize metadata and refine peak data:

▼
python
复制代码
from matchms.filtering import default_filters, normalize_intensities from matchms.filtering import select_by_relative_intensity, require_minimum_number_of_peaks # Apply default metadata harmonization filters spectrum = default_filters(spectrum) # Normalize peak intensities spectrum = normalize_intensities(spectrum) # Filter peaks by relative intensity spectrum = select_by_relative_intensity(spectrum, intensity_from=0.01, intensity_to=1.0) # Require minimum peaks spectrum = require_minimum_number_of_peaks(spectrum, n_required=5)

Filter categories:

  • Metadata processing: Harmonize compound names, derive chemical structures, standardize adducts, correct charges
  • Peak filtering: Normalize intensities, select by m/z or intensity, remove precursor peaks
  • Quality control: Require minimum peaks, validate precursor m/z, ensure metadata completeness
  • Chemical annotation: Add fingerprints, derive InChI/SMILES, repair structural mismatches

Matchms provides 40+ filters. For the complete filter reference, consult references/filtering.md.

3. Calculating Spectral Similarities

Compare spectra using various similarity metrics:

▼
python
复制代码
from matchms import calculate_scores from matchms.similarity import CosineGreedy, ModifiedCosine, CosineHungarian # Calculate cosine similarity (fast, greedy algorithm) scores = calculate_scores(references=library_spectra, queries=query_spectra, similarity_function=CosineGreedy()) # Calculate modified cosine (accounts for precursor m/z differences) scores = calculate_scores(references=library_spectra, queries=query_spectra, similarity_function=ModifiedCosine(tolerance=0.1)) # Get best matches best_matches = scores.scores_by_query(query_spectra[0], sort=True)[:10]

Available similarity functions:

  • CosineGreedy/CosineHungarian: Peak-based cosine similarity with different matching algorithms
  • ModifiedCosine: Cosine similarity accounting for precursor mass differences
  • NeutralLossesCosine: Similarity based on neutral loss patterns
  • FingerprintSimilarity: Molecular structure similarity using fingerprints
  • MetadataMatch: Compare user-defined metadata fields
  • PrecursorMzMatch/ParentMassMatch: Simple mass-based filtering

For detailed similarity function documentation, consult references/similarity.md.

4. Building Processing Pipelines

Create reproducible, multi-step analysis workflows:

▼
python
复制代码
from matchms import SpectrumProcessor from matchms.filtering import default_filters, normalize_intensities from matchms.filtering import select_by_relative_intensity, remove_peaks_around_precursor_mz # Define a processing pipeline processor = SpectrumProcessor([ default_filters, normalize_intensities, lambda s: select_by_relative_intensity(s, intensity_from=0.01), lambda s: remove_peaks_around_precursor_mz(s, mz_tolerance=17) ]) # Apply to all spectra processed_spectra = [processor(s) for s in spectra]

5. Working with Spectrum Objects

The core Spectrum class contains mass spectral data:

▼
python
复制代码
from matchms import Spectrum import numpy as np # Create a spectrum mz = np.array([100.0, 150.0, 200.0, 250.0]) intensities = np.array([0.1, 0.5, 0.9, 0.3]) metadata = {"precursor_mz": 250.5, "ionmode": "positive"} spectrum = Spectrum(mz=mz, intensities=intensities, metadata=metadata) # Access spectrum properties print(spectrum.peaks.mz) # m/z values print(spectrum.peaks.intensities) # Intensity values print(spectrum.get("precursor_mz")) # Metadata field # Visualize spectra spectrum.plot() spectrum.plot_against(reference_spectrum)

6. Metadata Management

Standardize and harmonize spectrum metadata:

▼
python
复制代码
# Metadata is automatically harmonized spectrum.set("Precursor_mz", 250.5) # Gets harmonized to lowercase key print(spectrum.get("precursor_mz")) # Returns 250.5 # Derive chemical information from matchms.filtering import derive_inchi_from_smiles, derive_inchikey_from_inchi from matchms.filtering import add_fingerprint spectrum = derive_inchi_from_smiles(spectrum) spectrum = derive_inchikey_from_inchi(spectrum) spectrum = add_fingerprint(spectrum, fingerprint_type="morgan", nbits=2048)

Common Workflows

For typical mass spectrometry analysis workflows, including:

  • Loading and preprocessing spectral libraries
  • Matching unknown spectra against reference libraries
  • Quality filtering and data cleaning
  • Large-scale similarity comparisons
  • Network-based spectral clustering

Consult references/workflows.md for detailed examples.

Installation

▼
bash
复制代码
uv pip install matchms

For molecular structure processing (SMILES, InChI):

▼
bash
复制代码
uv pip install matchms[chemistry]

Reference Documentation

Detailed reference documentation is available in the references/ directory:

  • filtering.md - Complete filter function reference with descriptions
  • similarity.md - All similarity metrics and when to use them
  • importing_exporting.md - File format details and I/O operations
  • workflows.md - Common analysis patterns and examples

Load these references as needed for detailed information about specific matchms capabilities.

研究

快捷安装

复制到终端去安装 Skill

npxskillsadddavila7/claude-code-templates--skill"matchms"
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
朱雀AI检测助手朱雀AI检测助手
零感AI零感AI
Skills 推荐
prime-numbers
面向图论中的素数问题求解,提供素性判定、整数分解、素数分布分析及模运算定理验证等核心能力,支持从基础试除到概率化与确定性算法的多层次策略选择,适用于理论推导与计算验证相结合的研究场景。
research
面向技术方案的深度调研能力,通过网络搜索、GitHub 仓库分析和多源证据采集,支持在实施前全面评估技术选型,确保每个推荐方案均基于官方文档、活跃代码库及真实应用案例等至少两项可靠依据。
rank-tracker
持续监控关键词在传统搜索结果与AI生成内容中的排名变化,分析趋势波动并识别显著升降,支持多维度对比竞争格局与SERP特征占有情况,输出可视化报告及可执行优化建议,适用于搜索引擎营销策略的动态调整。
research-grants
面向 NSF、NIH、DOE 和 DARPA 等联邦机构的科研基金申请,提供从选题定位、立项依据、技术路线设计、创新性阐述、可行性论证到预算编制与合规性审查的全流程支持,强调科学严谨性、跨学科整合能力及社会价值转化路径。
gsea-enrichment
执行基因集富集分析时,需先将通路数据库文件加载为字典格式,再进行富集计算,确保使用正确的数据结构与物种参数,支持多类功能注释数据库的整合分析与可视化。