agentsclimarketplace

Ancova peak association analysis

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/ancova-peak-association-analysis

Use when when you have preprocessed metabolomics peak tables (feature matrix with samples × peaks) and sample metadata (phenotype/grouping information and optional continuous covariates), and your research question is to identify which peaks differ significantly between groups while accounting for.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill ancova-peak-association-analysis

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as CC-BY-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

7.3 KB, ~1.3k tokens by cl100k_base, as published. Nobody here has run it

ancova-peak-association-analysis

Summary

Apply analysis-of-covariance (ANCOVA) models to metabolomics peak intensity data to identify features associated with group membership while controlling for continuous covariates. This skill detects significant peaks by fitting linear models with group as a fixed effect and extracting test statistics, p-values, and effect sizes.

When to use

When you have preprocessed metabolomics peak tables (feature matrix with samples × peaks) and sample metadata (phenotype/grouping information and optional continuous covariates), and your research question is to identify which peaks differ significantly between groups while accounting for confounding continuous variables (e.g., age, BMI). Use ANCOVA instead of PLS/PLS-DA when the goal is association analysis rather than classification or pathway enrichment.

When NOT to use

  • Input data are already a statistical summary table or p-value list — use downstream filtering/visualization instead.
  • The research question is classification or prediction of group membership — use PLS/PLS-DA.
  • The goal is pathway enrichment or integrative multi-omic analysis — use IOPA.
  • Peak intensity data violate ANCOVA assumptions (normality, homogeneity of variance) severely and cannot be transformed — consider non-parametric alternatives.

Inputs

  • Preprocessed peak intensity table (feature matrix: samples × peaks, numeric)
  • Sample metadata with group/phenotype labels (factor/categorical)
  • Optional: continuous covariate data (e.g., age, BMI, batch effects)

Outputs

  • ANCOVA results table with peak identifiers, F-statistics, p-values, and effect sizes
  • Multiple-testing corrected p-values (adjusted p-values)
  • Optional: visualization of significant peaks by group

How to apply

Load the preprocessed peak table (feature matrix) and sample metadata into R. Parse the group membership and any continuous covariate values from the phenotype file. For each peak, fit an analysis-of-covariance model with peak intensity as the response variable, group membership as the fixed effect, and continuous covariates as additional predictors. Extract the F-statistic, p-value, and effect size (e.g., eta-squared) for the group effect from each model. Aggregate results into a single output table with peak identifiers and test-specific metrics (F-statistics, p-values, effect sizes). Apply multiple-testing correction (e.g., FDR or Bonferroni) to p-values to control false discovery rate.

Related tools

  • R (Statistical computing environment used to implement ANCOVA model fitting and extract F-statistics, p-values, and effect sizes for each peak) — https://www.r-project.org/
  • SMART (Integrated metabolomics analysis software that encapsulates ANCOVA as one of three statistical analysis dispatch methods) — https://github.com/YuJenL/SMART
  • R GUI (User-friendly graphical interface to SMART that facilitates ANCOVA parameter specification and results visualization) — https://github.com/YuJenL/SMART

Evaluation signals

  • For each peak, verify that F-statistic, p-value, and effect size are numerically valid and within expected ranges (e.g., F ≥ 0, 0 ≤ p ≤ 1, 0 ≤ eta-squared ≤ 1).
  • Check that adjusted p-values are monotonically non-decreasing with respect to unadjusted p-values (i.e., multiple-testing correction was applied correctly).
  • Verify that peak count in results matches peak count in input feature matrix.
  • For positive control peaks (known to differ between groups), confirm they appear in the top-ranked results by p-value.
  • Compare results to univariate t-tests without covariates; ANCOVA p-values should be smaller (more significant) for peaks where covariates explain confounding variation.
  • Inspect volcano plot or forest plot of effect sizes vs. p-values for expected patterns (e.g., high effect sizes corresponding to low p-values).

Limitations

  • ANCOVA assumes linear relationships between peak intensity and covariates; non-linear associations may be missed.
  • Large imbalances in group sizes or covariate distributions can reduce statistical power and inflate type I error.
  • ANCOVA assumes homogeneity of variance across groups; heteroscedastic peaks may violate this assumption and require transformation or Welch-type correction.
  • Results are marginal associations for each peak in isolation; no interaction effects between peaks or pathway-level patterns are captured.
  • Multiple testing on thousands of peaks inflates family-wise error; uncorrected p-values will lead to false positives.

Evidence

  • [other] For ANCOVA: fit analysis-of-covariance models with peak intensity as response, group membership as fixed effect, and continuous covariates as needed; extract F-statistics, p-values, and effect sizes for each peak.: "For ANCOVA: fit analysis-of-covariance models with peak intensity as response, group membership as fixed effect, and continuous covariates as needed; extract F-statistics, p-values, and effect sizes"
  • [intro] Statistical Analysis: Perform association analysis (ANCOVA), classification analysis (PLS/PLS-DA), and integrative omics pathway analysis (IOPA): "Statistical Analysis: Perform association analysis (ANCOVA), classification analysis (PLS/PLS-DA), and integrative omics pathway analysis (IOPA)"
  • [other] Load the preprocessed peak table (feature matrix with samples × peaks) into R.: "Load the preprocessed peak table (feature matrix with samples × peaks) into R."
  • [other] Parse the analysis type parameter (ANCOVA, PLS/PLS-DA, or IOPA) and sample metadata (phenotype/grouping information).: "Parse the analysis type parameter (ANCOVA, PLS/PLS-DA, or IOPA) and sample metadata (phenotype/grouping information)."
  • [other] Aggregate results (p-values, effect sizes, importance scores, or pathway statistics) into a single results table with peak identifiers and test-specific metrics.: "Aggregate results (p-values, effect sizes, importance scores, or pathway statistics) into a single results table with peak identifiers and test-specific metrics."

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,871. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.