metabolomic-feature-table-interpretation
Summary
Interprets preprocessed LC-MS/MS metabolomic feature tables through univariate and multivariate statistical testing to identify metabolites with significant abundance differences across experimental groups, followed by pathway analysis to contextualize findings within biological systems.
When to use
After quality control, filtering, and normalization of an MS-DIAL-derived feature abundance matrix (e.g., Urine_RP_NEG_norm.txt or Urine_RP_POS_norm.txt), when you have samples assigned to discrete experimental classes (e.g., AA, DD, MM phenotypes) and need to identify which metabolic features show statistically significant differences in abundance across those classes and map them to affected biological pathways.
When NOT to use
- Input feature table has not been normalized or quality-filtered (run preprocessing steps first)
- Samples lack clear experimental class assignments or metadata (univariate testing requires group labels)
- Only exploratory/unsupervised analysis is planned (use PCA or clustering instead)
- Sample size per class is very small (n < 3 per group), reducing statistical power and validity of ANOVA assumptions
Inputs
- Normalized feature abundance matrix (e.g., Urine_RP_NEG_norm.txt, Urine_RP_POS_norm.txt format)
- Sample metadata table with experimental class assignments (e.g., AA/DD/MM phenotypes)
- margheRita data object (created via load and metadata assignment)
Outputs
- Univariate statistical results table (Feature_ID, metabolite name, ANOVA F-statistic, p-value, q-value, effect size)
- Filtered significant features list (q-value-thresholded)
- Pathway enrichment results (ORA or MSEA output with pathway names, p-values, and member features)
- Optional: heatmap visualization (via ComplexHeatmap integration) showing significant features across sample classes
How to apply
Load the normalized feature table and sample metadata into margheRita. Apply the univariate() function to compute ANOVA F-statistics and p-values (or non-parametric alternatives for non-normal data) across all class levels for each metabolite feature; margheRita automatically applies Benjamini–Hochberg FDR correction during this step. Use select_sign_features() to filter significant features at a chosen q-value cutoff (e.g., q < 0.05). Extract a results table containing Feature_ID, metabolite names, ANOVA statistics, p-values, q-values, and effect sizes. Subsequently apply pathway analysis using Over-Representation Analysis (ORA) or Metabolite Set Enrichment Analysis (MSEA) via clusterProfiler integration to assign significant features to metabolic pathways and databases, providing biological context for the statistical findings.
Related tools
- margheRita (Executes univariate ANOVA and non-parametric statistical tests; filters significant features; exports results tables and integrates pathway analysis via clusterProfiler) — https://github.com/emosca-cnr/margheRita
- clusterProfiler (Performs Over-Representation Analysis (ORA) and Metabolite Set Enrichment Analysis (MSEA) on significant feature lists to assign metabolic pathway membership)
- ComplexHeatmap (Generates heatmap visualizations of significant features across sample classes via margheRita's h_map() function)
- notame (Alternative/complementary R package for non-targeted LC-MS metabolomic profiling, including feature-wise statistical tests and multivariate models; margheRita can export to notame format via as.metaboset()) — https://github.com/hanhineva-lab/notame
- pcaMethods (Provides Principal Component Analysis capability used by margheRita's mR_pca() function for multivariate exploratory analysis alongside univariate testing)
Examples
univariate_results <- margheRita::univariate(mR_data, method='anova'); sig_features <- margheRita::select_sign_features(univariate_results, q_cutoff=0.05); pathway_enrich <- margheRita::pathway_analysis(sig_features, method='ORA', database='kegg')
Evaluation signals
- Results table contains non-null Feature_ID, metabolite names, q-values, and p-values for all tested features; no missing values in critical columns
- Q-values are greater than or equal to corresponding p-values (FDR correction validated); selected features meet the specified q-value threshold (e.g., all q < 0.05 in filtered output)
- Effect sizes or ANOVA F-statistics are reasonable (F > 1 and increasing with effect magnitude); feature counts post-filtering are consistent with statistical expectations for the experiment
- Pathway enrichment results reference recognized metabolic databases (e.g., KEGG, Reactome, BioCyc) and report significant pathways with p-values; member features in each pathway match the significant feature list
- Heatmap visualization (if generated) shows clear differential abundance patterns across experimental classes for significant features, visually confirming statistical results
Limitations
- ANOVA assumes normality of feature abundances within each class; if violated, non-parametric alternatives (Kruskal–Wallis) should be applied instead, which margheRita supports
- FDR correction (Benjamini–Hochberg) is appropriate for large feature sets but assumes independence of tests; highly correlated metabolites may reduce effective multiple-testing adjustment stringency
- Pathway enrichment depends on database completeness and metabolite annotation accuracy; unannotated or misidentified features will not map to pathways, reducing biological interpretability
- Statistical significance does not imply biological significance; effect sizes and pathway coherence should be examined to prioritize findings for validation
- MS-DIAL processing parameters (peak picking, alignment, m/z tolerance) upstream of normalization influence feature quality; severe artifacts or missing values pre-filtering can bias statistical results
Evidence
- [other] Apply univariate() function to compute ANOVA F-statistics and p-values across the three class levels for each metabolite feature. Use select_sign_features() to filter significant features based on q-value threshold (Benjamini–Hochberg FDR correction applied during univariate or select_sign_features step).: "Apply univariate() function to compute ANOVA F-statistics and p-values across the three class levels for each metabolite feature. Use select_sign_features() to filter significant features based on"
- [readme] simplified execution of parametric and non-parametric statistical tests over a large number of features; pathway analysis based on ORA and MSEA over various databases: "simplified execution of parametric and non-parametric statistical tests over a large number of features; pathway analysis based on ORA and MSEA over various databases"
- [other] Extract and tabulate the results including feature identifiers, ANOVA statistics, p-values, q-values, and effect sizes.: "Extract and tabulate the results including feature identifiers, ANOVA statistics, p-values, q-values, and effect sizes"
- [intro] margheRita implements both Over Representation Analysis (ORA) and Metabolite Set Enrichment Analysis (MSEA), based on clusterProfiler: "margheRita implements both Over Representation Analysis (ORA) and Metabolite Set Enrichment Analysis (MSEA), based on clusterProfiler"
- [intro] The R package margheRita addresses the complete workflow for metabolomic profiling in untargeted studies based on liquid chromatography (LC) coupled with tandem mass spectrometry (MS/MS).: "The R package margheRita addresses the complete workflow for metabolomic profiling in untargeted studies based on liquid chromatography (LC) coupled with tandem mass spectrometry (MS/MS)"
1---2name: metabolomic-feature-table-interpretation3description: Use when after quality control, filtering, and normalization of an MS-DIAL-derived feature abundance matrix (e.g., Urine_RP_NEG_norm.txt or Urine_RP_POS_norm.txt), when you have samples assigned to discrete experimental classes (e.4license: CC-BY-4.05---67# metabolomic-feature-table-interpretation89## Summary1011Interprets preprocessed LC-MS/MS metabolomic feature tables through univariate and multivariate statistical testing to identify metabolites with significant abundance differences across experimental groups, followed by pathway analysis to contextualize findings within biological systems.1213## When to use1415After quality control, filtering, and normalization of an MS-DIAL-derived feature abundance matrix (e.g., Urine_RP_NEG_norm.txt or Urine_RP_POS_norm.txt), when you have samples assigned to discrete experimental classes (e.g., AA, DD, MM phenotypes) and need to identify which metabolic features show statistically significant differences in abundance across those classes and map them to affected biological pathways.1617## When NOT to use1819- Input feature table has not been normalized or quality-filtered (run preprocessing steps first)20- Samples lack clear experimental class assignments or metadata (univariate testing requires group labels)21- Only exploratory/unsupervised analysis is planned (use PCA or clustering instead)22- Sample size per class is very small (n < 3 per group), reducing statistical power and validity of ANOVA assumptions2324## Inputs2526- Normalized feature abundance matrix (e.g., Urine_RP_NEG_norm.txt, Urine_RP_POS_norm.txt format)27- Sample metadata table with experimental class assignments (e.g., AA/DD/MM phenotypes)28- margheRita data object (created via load and metadata assignment)2930## Outputs3132- Univariate statistical results table (Feature_ID, metabolite name, ANOVA F-statistic, p-value, q-value, effect size)33- Filtered significant features list (q-value-thresholded)34- Pathway enrichment results (ORA or MSEA output with pathway names, p-values, and member features)35- Optional: heatmap visualization (via ComplexHeatmap integration) showing significant features across sample classes3637## How to apply3839Load the normalized feature table and sample metadata into margheRita. Apply the univariate() function to compute ANOVA F-statistics and p-values (or non-parametric alternatives for non-normal data) across all class levels for each metabolite feature; margheRita automatically applies Benjamini–Hochberg FDR correction during this step. Use select_sign_features() to filter significant features at a chosen q-value cutoff (e.g., q < 0.05). Extract a results table containing Feature_ID, metabolite names, ANOVA statistics, p-values, q-values, and effect sizes. Subsequently apply pathway analysis using Over-Representation Analysis (ORA) or Metabolite Set Enrichment Analysis (MSEA) via clusterProfiler integration to assign significant features to metabolic pathways and databases, providing biological context for the statistical findings.4041## Related tools4243- **margheRita** (Executes univariate ANOVA and non-parametric statistical tests; filters significant features; exports results tables and integrates pathway analysis via clusterProfiler) — https://github.com/emosca-cnr/margheRita44- **clusterProfiler** (Performs Over-Representation Analysis (ORA) and Metabolite Set Enrichment Analysis (MSEA) on significant feature lists to assign metabolic pathway membership)45- **ComplexHeatmap** (Generates heatmap visualizations of significant features across sample classes via margheRita's h_map() function)46- **notame** (Alternative/complementary R package for non-targeted LC-MS metabolomic profiling, including feature-wise statistical tests and multivariate models; margheRita can export to notame format via as.metaboset()) — https://github.com/hanhineva-lab/notame47- **pcaMethods** (Provides Principal Component Analysis capability used by margheRita's mR_pca() function for multivariate exploratory analysis alongside univariate testing)4849## Examples5051```52univariate_results <- margheRita::univariate(mR_data, method='anova'); sig_features <- margheRita::select_sign_features(univariate_results, q_cutoff=0.05); pathway_enrich <- margheRita::pathway_analysis(sig_features, method='ORA', database='kegg')53```5455## Evaluation signals5657- Results table contains non-null Feature_ID, metabolite names, q-values, and p-values for all tested features; no missing values in critical columns58- Q-values are greater than or equal to corresponding p-values (FDR correction validated); selected features meet the specified q-value threshold (e.g., all q < 0.05 in filtered output)59- Effect sizes or ANOVA F-statistics are reasonable (F > 1 and increasing with effect magnitude); feature counts post-filtering are consistent with statistical expectations for the experiment60- Pathway enrichment results reference recognized metabolic databases (e.g., KEGG, Reactome, BioCyc) and report significant pathways with p-values; member features in each pathway match the significant feature list61- Heatmap visualization (if generated) shows clear differential abundance patterns across experimental classes for significant features, visually confirming statistical results6263## Limitations6465- ANOVA assumes normality of feature abundances within each class; if violated, non-parametric alternatives (Kruskal–Wallis) should be applied instead, which margheRita supports66- FDR correction (Benjamini–Hochberg) is appropriate for large feature sets but assumes independence of tests; highly correlated metabolites may reduce effective multiple-testing adjustment stringency67- Pathway enrichment depends on database completeness and metabolite annotation accuracy; unannotated or misidentified features will not map to pathways, reducing biological interpretability68- Statistical significance does not imply biological significance; effect sizes and pathway coherence should be examined to prioritize findings for validation69- MS-DIAL processing parameters (peak picking, alignment, m/z tolerance) upstream of normalization influence feature quality; severe artifacts or missing values pre-filtering can bias statistical results7071## Evidence7273- [other] Apply univariate() function to compute ANOVA F-statistics and p-values across the three class levels for each metabolite feature. Use select_sign_features() to filter significant features based on q-value threshold (Benjamini–Hochberg FDR correction applied during univariate or select_sign_features step).: "Apply univariate() function to compute ANOVA F-statistics and p-values across the three class levels for each metabolite feature. Use select_sign_features() to filter significant features based on"74- [readme] simplified execution of parametric and non-parametric statistical tests over a large number of features; pathway analysis based on ORA and MSEA over various databases: "simplified execution of parametric and non-parametric statistical tests over a large number of features; pathway analysis based on ORA and MSEA over various databases"75- [other] Extract and tabulate the results including feature identifiers, ANOVA statistics, p-values, q-values, and effect sizes.: "Extract and tabulate the results including feature identifiers, ANOVA statistics, p-values, q-values, and effect sizes"76- [intro] margheRita implements both Over Representation Analysis (ORA) and Metabolite Set Enrichment Analysis (MSEA), based on clusterProfiler: "margheRita implements both Over Representation Analysis (ORA) and Metabolite Set Enrichment Analysis (MSEA), based on clusterProfiler"77- [intro] The R package margheRita addresses the complete workflow for metabolomic profiling in untargeted studies based on liquid chromatography (LC) coupled with tandem mass spectrometry (MS/MS).: "The R package margheRita addresses the complete workflow for metabolomic profiling in untargeted studies based on liquid chromatography (LC) coupled with tandem mass spectrometry (MS/MS)"