Multi-Omics Integration
Coordinate and integrate multiple omics datasets for comprehensive systems biology analysis. Orchestrates specialized ToolUniverse skills to perform cross-omics correlation, multi-omics clustering, pathway-level integration, and unified interpretation.
Domain Reasoning
Multi-omics integration asks whether different molecular layers tell a concordant story. If a gene is upregulated in RNA-seq AND its protein is elevated in proteomics, that is concordant evidence of true biological change. Discordance — high mRNA but low protein, or elevated protein without matching mRNA — may indicate post-transcriptional regulation (miRNA silencing, protein degradation, translational control) and is itself a meaningful finding worth reporting. Not every discordance is noise; some are the most interesting biology.
LOOK UP DON'T GUESS
- Expected RNA-protein correlation ranges: compute Spearman r from the actual data; the typical range (0.4-0.6) is a guide, not a guarantee.
- Pathway enrichment results: run
ReactomeAnalysis_pathway_enrichment or gseapy on the actual gene lists; never list enriched pathways from memory.
- eQTL associations: query GTEx or eQTL databases for the specific variant and tissue; do not assume regulatory relationships.
- Methylation-expression directionality at specific loci: retrieve experimental data; promoter repression is the canonical model but exceptions exist.
When to Use This Skill
- User has multiple omics datasets (RNA-seq + proteomics, methylation + expression, etc.)
- Cross-omics correlation queries (e.g., "How does methylation affect expression?")
- Multi-omics biomarker discovery or patient subtyping
- Systems biology questions requiring multiple molecular layers
- Precision medicine applications with multi-omics patient data
Workflow Overview
Phase 1: Data Loading & QC
Load each omics type, format-specific QC, normalize
Supported: RNA-seq, proteomics, methylation, CNV/SNV, metabolomics
Phase 2: Sample Matching
Harmonize sample IDs, find common samples, handle missing omics
Phase 3: Feature Mapping
Map features to common gene-level identifiers
CpG->gene (promoter), CNV->gene, metabolite->enzyme
Phase 4: Cross-Omics Correlation
RNA vs Protein (translation efficiency)
Methylation vs Expression (epigenetic regulation)
CNV vs Expression (dosage effect)
eQTL variants vs Expression (genetic regulation)
Phase 5: Multi-Omics Clustering
MOFA+, NMF, SNF for patient subtyping
Phase 6: Pathway-Level Integration
Aggregate omics evidence at pathway level
Score pathway dysregulation with combined evidence
Phase 7: Biomarker Discovery
Feature selection across omics, multi-omics classification
Phase 8: Integrated Report
Summary, correlations, clusters, pathways, biomarkers
See: phase_details.md for complete code and implementation details.
Supported Data Types
| Omics |
Formats |
QC Focus |
| Transcriptomics |
CSV/TSV, HDF5, h5ad |
Low-count filter, normalize (TPM/DESeq2), log-transform |
| Proteomics |
MaxQuant, Spectronaut, DIA-NN |
Missing value imputation, median/quantile normalization |
| Methylation |
IDAT, beta matrices |
Failed probes, batch correction, cross-reactive filter |
| Genomics |
VCF, SEG (CNV) |
Variant QC, CNV segmentation |
| Metabolomics |
Peak tables |
Missing values, normalization |
Core Operations
Sample Matching
def match_samples_across_omics(omics_data_dict):
"""Match samples across multiple omics datasets."""
sample_ids = {k: set(df.columns) for k, df in omics_data_dict.items()}
common_samples = set.intersection(*sample_ids.values())
matched_data = {k: df[sorted(common_samples)] for k, df in omics_data_dict.items()}
return sorted(common_samples), matched_data
Cross-Omics Correlation
from scipy.stats import spearmanr, pearsonr
# RNA vs Protein: expect positive r ~ 0.4-0.6
# Methylation vs Expression: expect negative r (promoter repression)
# CNV vs Expression: expect positive r (dosage effect)
for gene in common_genes:
r, p = spearmanr(rna[gene], protein[gene])
Pathway Integration
# Score pathway dysregulation using combined evidence from all omics
# Aggregate per-gene evidence, then per-pathway
pathway_score = mean(abs(rna_fc) + abs(protein_fc) + abs(meth_diff) + abs(cnv))
See: phase_details.md for full implementations of each operation.
Multi-Omics Clustering Methods
| Method |
Description |
Best For |
| MOFA+ |
Latent factors explaining cross-omics variation |
Identifying shared/omics-specific drivers |
| Joint NMF |
Shared decomposition across omics |
Patient subtype discovery |
| SNF |
Similarity network fusion |
Integrating heterogeneous data types |
ToolUniverse Skills Coordination
| Skill |
Used For |
Phase |
tooluniverse-rnaseq-deseq2 |
RNA-seq analysis |
1, 4 |
tooluniverse-epigenomics |
Methylation, ChIP-seq |
1, 4 |
tooluniverse-variant-analysis |
CNV/SNV processing |
1, 3, 4 |
tooluniverse-protein-interactions |
Protein network context |
6 |
tooluniverse-gene-enrichment |
Pathway enrichment |
6 |
tooluniverse-expression-data-retrieval |
Public data retrieval |
1 |
tooluniverse-target-research |
Gene/protein annotation |
3, 8 |
Use Cases
Cancer Multi-Omics
Integrate TCGA RNA-seq + proteomics + methylation + CNV to identify patient subtypes, cross-omics driver genes, and multi-omics biomarkers.
eQTL + Expression + Methylation
Identify SNP -> methylation -> expression regulatory chains (mediation analysis).
Drug Response Multi-Omics
Predict drug response using baseline multi-omics profiles; identify resistance/sensitivity pathways.
See: phase_details.md "Use Cases" for detailed step-by-step workflows.
Quantified Minimums
| Component |
Requirement |
| Omics types |
At least 2 datasets |
| Common samples |
At least 10 across omics |
| Cross-correlation |
Pearson/Spearman computed |
| Clustering |
At least one method (MOFA+, NMF, or SNF) |
| Pathway integration |
Enrichment with multi-omics evidence scores |
| Report |
Summary, correlations, clusters, pathways, biomarkers |
Limitations
- Sample size: n >= 20 recommended for integration
- Missing data: Pairwise integration if not all samples have all omics
- Batch effects: Different platforms require careful normalization
- Computational: Large datasets may require significant memory
- Interpretation: Results require domain expertise for validation
References
Detailed Reference
- phase_details.md - Complete code for all phases, correlation functions, clustering, pathway integration, biomarker discovery, report template, and detailed use cases
1---23name: tooluniverse-multi-omics-integration-24description: "Multi-omics integration — orchestrate per-layer analysis (transcriptomics, proteomics, epigenomics, genomics, metabolomics) then perform cross-omics correlation, multi-omics clustering, and pathway-level integration. Use for integrative systems-biology analysis, multi-modal disease characterization, and cross-omics biomarker discovery."5metadata:6 source: https://skillmd.com/skills/mims-harvard/tooluniverse-multi-omics-integration-27---89# Multi-Omics Integration1011Coordinate and integrate multiple omics datasets for comprehensive systems biology analysis. Orchestrates specialized ToolUniverse skills to perform cross-omics correlation, multi-omics clustering, pathway-level integration, and unified interpretation.1213---1415## Domain Reasoning1617Multi-omics integration asks whether different molecular layers tell a concordant story. If a gene is upregulated in RNA-seq AND its protein is elevated in proteomics, that is concordant evidence of true biological change. Discordance — high mRNA but low protein, or elevated protein without matching mRNA — may indicate post-transcriptional regulation (miRNA silencing, protein degradation, translational control) and is itself a meaningful finding worth reporting. Not every discordance is noise; some are the most interesting biology.1819## LOOK UP DON'T GUESS2021- Expected RNA-protein correlation ranges: compute Spearman r from the actual data; the typical range (0.4-0.6) is a guide, not a guarantee.22- Pathway enrichment results: run `ReactomeAnalysis_pathway_enrichment` or gseapy on the actual gene lists; never list enriched pathways from memory.23- eQTL associations: query GTEx or eQTL databases for the specific variant and tissue; do not assume regulatory relationships.24- Methylation-expression directionality at specific loci: retrieve experimental data; promoter repression is the canonical model but exceptions exist.2526---2728## When to Use This Skill2930- User has multiple omics datasets (RNA-seq + proteomics, methylation + expression, etc.)31- Cross-omics correlation queries (e.g., "How does methylation affect expression?")32- Multi-omics biomarker discovery or patient subtyping33- Systems biology questions requiring multiple molecular layers34- Precision medicine applications with multi-omics patient data3536---3738## Workflow Overview3940```41Phase 1: Data Loading & QC42 Load each omics type, format-specific QC, normalize43 Supported: RNA-seq, proteomics, methylation, CNV/SNV, metabolomics4445Phase 2: Sample Matching46 Harmonize sample IDs, find common samples, handle missing omics4748Phase 3: Feature Mapping49 Map features to common gene-level identifiers50 CpG->gene (promoter), CNV->gene, metabolite->enzyme5152Phase 4: Cross-Omics Correlation53 RNA vs Protein (translation efficiency)54 Methylation vs Expression (epigenetic regulation)55 CNV vs Expression (dosage effect)56 eQTL variants vs Expression (genetic regulation)5758Phase 5: Multi-Omics Clustering59 MOFA+, NMF, SNF for patient subtyping6061Phase 6: Pathway-Level Integration62 Aggregate omics evidence at pathway level63 Score pathway dysregulation with combined evidence6465Phase 7: Biomarker Discovery66 Feature selection across omics, multi-omics classification6768Phase 8: Integrated Report69 Summary, correlations, clusters, pathways, biomarkers70```7172See: phase_details.md for complete code and implementation details.7374---7576## Supported Data Types7778| Omics | Formats | QC Focus |79|-------|---------|----------|80| Transcriptomics | CSV/TSV, HDF5, h5ad | Low-count filter, normalize (TPM/DESeq2), log-transform |81| Proteomics | MaxQuant, Spectronaut, DIA-NN | Missing value imputation, median/quantile normalization |82| Methylation | IDAT, beta matrices | Failed probes, batch correction, cross-reactive filter |83| Genomics | VCF, SEG (CNV) | Variant QC, CNV segmentation |84| Metabolomics | Peak tables | Missing values, normalization |8586---8788## Core Operations8990### Sample Matching9192```python93def match_samples_across_omics(omics_data_dict):94 """Match samples across multiple omics datasets."""95 sample_ids = {k: set(df.columns) for k, df in omics_data_dict.items()}96 common_samples = set.intersection(*sample_ids.values())97 matched_data = {k: df[sorted(common_samples)] for k, df in omics_data_dict.items()}98 return sorted(common_samples), matched_data99```100101### Cross-Omics Correlation102103```python104from scipy.stats import spearmanr, pearsonr105106# RNA vs Protein: expect positive r ~ 0.4-0.6107# Methylation vs Expression: expect negative r (promoter repression)108# CNV vs Expression: expect positive r (dosage effect)109110for gene in common_genes:111 r, p = spearmanr(rna[gene], protein[gene])112```113114### Pathway Integration115116```python117# Score pathway dysregulation using combined evidence from all omics118# Aggregate per-gene evidence, then per-pathway119pathway_score = mean(abs(rna_fc) + abs(protein_fc) + abs(meth_diff) + abs(cnv))120```121122See: phase_details.md for full implementations of each operation.123124---125126## Multi-Omics Clustering Methods127128| Method | Description | Best For |129|--------|-------------|----------|130| **MOFA+** | Latent factors explaining cross-omics variation | Identifying shared/omics-specific drivers |131| **Joint NMF** | Shared decomposition across omics | Patient subtype discovery |132| **SNF** | Similarity network fusion | Integrating heterogeneous data types |133134---135136## ToolUniverse Skills Coordination137138| Skill | Used For | Phase |139|-------|----------|-------|140| `tooluniverse-rnaseq-deseq2` | RNA-seq analysis | 1, 4 |141| `tooluniverse-epigenomics` | Methylation, ChIP-seq | 1, 4 |142| `tooluniverse-variant-analysis` | CNV/SNV processing | 1, 3, 4 |143| `tooluniverse-protein-interactions` | Protein network context | 6 |144| `tooluniverse-gene-enrichment` | Pathway enrichment | 6 |145| `tooluniverse-expression-data-retrieval` | Public data retrieval | 1 |146| `tooluniverse-target-research` | Gene/protein annotation | 3, 8 |147148---149150## Use Cases151152### Cancer Multi-Omics153Integrate TCGA RNA-seq + proteomics + methylation + CNV to identify patient subtypes, cross-omics driver genes, and multi-omics biomarkers.154155### eQTL + Expression + Methylation156Identify SNP -> methylation -> expression regulatory chains (mediation analysis).157158### Drug Response Multi-Omics159Predict drug response using baseline multi-omics profiles; identify resistance/sensitivity pathways.160161See: phase_details.md "Use Cases" for detailed step-by-step workflows.162163---164165## Quantified Minimums166167| Component | Requirement |168|-----------|-------------|169| Omics types | At least 2 datasets |170| Common samples | At least 10 across omics |171| Cross-correlation | Pearson/Spearman computed |172| Clustering | At least one method (MOFA+, NMF, or SNF) |173| Pathway integration | Enrichment with multi-omics evidence scores |174| Report | Summary, correlations, clusters, pathways, biomarkers |175176---177178## Limitations179180- **Sample size**: n >= 20 recommended for integration181- **Missing data**: Pairwise integration if not all samples have all omics182- **Batch effects**: Different platforms require careful normalization183- **Computational**: Large datasets may require significant memory184- **Interpretation**: Results require domain expertise for validation185186---187188## References189190- MOFA+: https://doi.org/10.1186/s13059-020-02015-1191- Similarity Network Fusion: https://doi.org/10.1038/nmeth.2810192- Multi-omics review: https://doi.org/10.1038/s41576-019-0093-7193- See individual ToolUniverse skill documentation for omics-specific methods194195---196197## Detailed Reference198199- **phase_details.md** - Complete code for all phases, correlation functions, clustering, pathway integration, biomarker discovery, report template, and detailed use cases