比赛
- 作者仓库星标 2,523
- 作者仓库 OpenClaw-Medical-Skills
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @FreedomIntelligence · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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.
章节与文件索引
按说明文件中的顺序排列。
概述
1. 导入和导出质谱数据
2. 频谱过滤与处理
3. 计算光谱相似度
4. 建设处理管道
文件/命令 -> references/importing_exporting.md · references/filtering.md · references/similarity.md · Spectrum · references/workflows.md · references/ · filtering.md · similarity.md
内容校验值 -> 4d30682bedd5
当前原文的自动摘译,尚未人工审校。
概述
Matchms 是一个用于质谱数据处理和分析的开源 Python 库。从各种格式导入光谱、标准化元数据、过滤峰值、计算光谱相似性并构建可重复的分析工作流程。
1. 导入和导出质谱数据
从多种文件格式加载谱图并导出处理后的数据: 支持的格式:mzML 和 mzXML(原始质谱格式) MGF(Mascot 通用格式) MSP(谱库格式)
2. 频谱过滤与处理
应用全面的过滤器来标准化元数据并细化峰数据: 过滤器类别: 元数据处理: 协调化合物名称、派生化学结构、标准化加合物、校正电荷 峰过滤: 标准化强度、按 m/z 或强度选择、删除前体峰 质量控制: 要求最小峰、验证前体 m/z、确保元数据完整性
3. 计算光谱相似度
使用各种相似性指标比较光谱: 可用相似性函数:CosineGreedy/CosineHungarian:使用不同匹配算法的基于峰值的余弦相似性 ModifiedCosine:考虑前体质量差异的余弦相似性 NeutralLossesCosine:基于中性损失模式的相似性
4. 建设处理管道
创建可重复的多步骤分析工作流程: