跳到正文
cccskills
免费在 GitHub 公开

bioconductor-metabocoreutils

MetaboCoreUtils defines metabolomics-related core functionality provided as low-level functions to allow a data structure-independent usage across various R packages. This includes functions to calculate between ion (adduct) and compound ma

中文简介正在准备中。当前显示原文说明。

实测评分 未实测

查看安装方法

包含的文件(1)

  • SKILL.md6.0 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

MetaboCoreUtils

Dependencies & Environment

Package-intrinsic requirements from the Bioconductor landing page — reproduce in any R environment.

  • Version: 1.20.1 · Bioconductor: 3.23 · R: ≥ 4.6
  • Imports: MsCoreUtils, BiocParallel
  • Install: BiocManager::install("MetaboCoreUtils")

When to Use

  • Mass and m/z Conversions: Converting between exact compound masses and ion mass-to-charge ratios ($m/z$) using mass2mz and mz2mass.
  • Chemical Formula Manipulation: Standardizing chemical formulas to Hill notation (standardizeFormula), adding/subtracting elements (addElements, subtractElements), and calculating exact masses (calculateMass).
  • Signal Drift Adjustment: Modeling and adjusting for injection order-dependent signal drift in LC-MS feature abundances using fit_lm and adjust_lm.
  • Kendrick Mass Defect Calculation: Identifying homologous series (e.g., lipids) by calculating Kendrick mass defects using calculateKmd and calculateRkmd.

When NOT to Use

  • Full LC-MS Preprocessing: For end-to-end raw data processing (peak picking, alignment, grouping); use high-level packages like xcms instead because MetaboCoreUtils only provides low-level utility functions.
  • Complex Statistical Modeling: For modeling non-linear batch effects or complex multi-covariate experimental designs; use dedicated statistical modeling packages because fit_lm is designed for simple linear drift adjustments.

Data Requirements

  • Input Format: Character vectors for chemical formulas (e.g., "C6H12O6"), numeric vectors for masses or $m/z$ values, and matrices for feature abundances.
  • Retention Indexing: A data.frame containing retention times and corresponding index values is required for indexRtime and correctRindex.
  • Signal Drift: A matrix of feature abundances (features in rows, samples in columns) and a data.frame of covariates (e.g., injection index).

Key Parameters

  • adduct: Character string or vector specifying the ESI ion adduct (e.g., "[M+H]+" or "[M+Na]+") for mass conversions.
  • data: A data.frame containing the covariates (e.g., injection_index) passed to fit_lm and adjust_lm.
  • minVals: The minimum number of non-missing values required in QC samples to fit a linear model in fit_lm.
  • y: The response variable (e.g., log2-transformed abundances) passed to fit_lm.
  • lm: A list of fitted linear models passed to adjust_lm to correct the data.

Best Practices

  • Always standardize chemical formulas using standardizeFormula before comparing them or counting elements (countElements) to ensure consistent formatting.
  • Use adductNames to view the exact spelling of all supported ESI ion adduct definitions before performing $m/z$ conversions.
  • When adjusting for signal drift, fit the linear models (fit_lm) exclusively on QC samples to ensure the estimated drift is independent of biological covariates.
  • Evaluate the estimated signal drifts (e.g., check p-values and R-squared) and filter out poor fits (e.g., p-value > 0.05) before applying adjust_lm.

Common Pitfalls

  • Unstable Drift Models: Fitting linear models on features with too few QC measurements leads to unstable adjustments; Fix: Increase the minVals parameter in fit_lm to require a strict minimum of non-missing QC values.
  • Adjusting Non-Drifting Features: Blindly applying adjust_lm to all features can introduce noise to features without true signal drift; Fix: Filter the list of models returned by fit_lm to remove fits with poor p-values before adjustment.
  • Incorrect Adduct Syntax: Conversions fail if the adduct string is misspelled; Fix: Query adductNames() to verify the exact string format (e.g., "[M+H]+").

Alternatives

  • xcms: Provides a comprehensive, high-level framework for LC-MS data preprocessing (peak picking, retention time alignment) rather than low-level utilities.
  • MsCoreUtils: Offers core utilities specifically for mass spectrometry data (e.g., spectra processing, noise estimation) rather than chemical formula and adduct calculations.
  • enviPat: Focuses on fine-grained isotopic pattern calculations and profile simulations rather than basic exact mass and $m/z$ conversions.

Citations

  • Rainer, M., Vicini, P., & Sigurdsson, S. (2022). MetaboCoreUtils: Core Utils for Metabolomics Data.
  • Wehrens, R., et al. (2016). Improved batch correction in untargeted MS-based metabolomics. Metabolomics, 12(5), 88.

References

<!-- biomate-cta -->

Run this on BioMate

This skill is the knowledge layer — when, why, and how to use metabocoreutils. To run this analysis on your own data with managed compute, automated QC, and reproducible outputs, use BioMate — free to start.

▶ Open metabocoreutils on BioMate →

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

The package contains functions for exploratory oligonucleotide array analysis. The dependence on tkWidgets only concerns few convenience functions. 'affy' is fully functional without it.

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

This tool uses the label-tree function from HyPhy to annotate a phylogenetic tree. It allows users to select a subset of leaves using either a regular expression or a list of sequence names, and then apply a specified label to these selecte

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

This package provides a client for the Bioconductor AnnotationHub web resource. The AnnotationHub web resource provides a central location where genomic files (e.g., VCF, bed, wig) and other resources from standard locations (e.g., UCSC, En

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

apeglm provides Bayesian shrinkage estimators for effect sizes for a variety of GLM models, using approximation of the posterior for individual coefficients.

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

ASURAT is a software for single-cell data analysis. Using ASURAT, one can simultaneously perform unsupervised clustering and biological interpretation in terms of cell type, disease, biological process, and signaling pathway activity. Inputting a single-cell RNA-seq data and knowledge-based databases, such as Cell Ontology, Gene Ontology, KEGG, etc., ASURAT transforms gene expression tables into original multivariate tables, termed sign-by-sample matrices (SSMs).

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

AUCell allows to identify cells with active gene sets (e.g. signatures, gene modules...) in single-cell RNA-seq data. AUCell uses the "Area Under the Curve" (AUC) to calculate whether a critical subset of the input gene set is enriched with

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

查看 bioMate-AI 的全部技能

报告此技能的问题