batch-effect-correction-combat-sva
Summary
Removes known batch effects from count matrices (typically Salmon-derived expression data) using ComBat or SVA algorithms, with batch source specified via sample metadata columns. This step is essential after normalization to ensure that technical or experimental batch factors do not confound downstream differential expression analysis.
When to use
Apply this skill when you have a normalized count matrix (from Salmon or similar quantification tool) with sample metadata that documents batch variables (e.g., sequencing run, processing date, lab site), and you observe or suspect that batch effects—not biological signal—are driving variance across samples. Use it before differential expression analysis to prevent batch confounding.
When NOT to use
- Input count matrix has not yet been filtered or normalized—apply filtering and normalization first.
- No batch variables are documented in the sample metadata—batch correction requires explicit specification of batch source.
- Batch effects are confounded with biological treatment; in this case, correction risks removing true signal and requires careful design review.
Inputs
- Normalized count matrix (RData or text format, typically output from quantile normalization step)
- Sample metadata/samplesheet file with batch and condition columns
Outputs
- Batch-corrected count matrix (RData format)
- Batch-corrected count matrix (text format)
- Optional: diagnostic plots (PCA, heatmap) showing batch effect removal
How to apply
After filtering and quantile normalization, specify the batch and condition columns in your sample metadata (samplesheet). Load the normalized count matrix and the metadata into R. Select a batch-correction method (ComBat for known batch factors, or SVA/comsva/svacom for unsupervised/surrogate variable estimation). Pass the condition variable (e.g., treatment group) to preserve biological signal while removing batch-associated variance. Apply the chosen correction method, then output the corrected matrix in both RData and text formats for downstream differential expression tools (DESeq2, edgeR). Evaluate success by visual inspection (PCA/heatmap before and after correction) to confirm batch clustering is eliminated.
Related tools
- sva (R package providing SVA, ComBat, and surrogate variable estimation methods for batch effect removal)
- limma (R package used in conjunction with batch correction for normalization and downstream analysis)
- edgeR (R package for count matrix filtering and normalization prior to batch correction)
- Nextflow (Workflow orchestration framework that runs batch correction as a containerized process in the preprocessing subworkflow) — https://www.nextflow.io
Evaluation signals
- PCA plot or heatmap shows reduced clustering by batch variable after correction, while biological replicates/treatment groups cluster together.
- Batch-corrected matrix maintains expected count distributions and variance structure (no artificial zero-inflation or extreme negative values).
- Downstream differential expression results show improved consistency and reduced batch-driven false positives when batch-corrected matrix is used versus uncorrected.
- Corrected matrix schema matches input (same rows/genes, same columns/samples) with numeric values in expected range.
- Optional: ComBat/SVA algorithm converges without warnings; surrogate variables (if SVA) explain residual variance orthogonal to batch.
Limitations
- Requires accurate specification of batch and condition columns in metadata; misspecification can remove biological signal.
- ComBat assumes batch effects are additive; may fail if batch-by-treatment interactions are strong.
- SVA requires sufficient sample size per batch and group; small sample designs may yield unreliable surrogate variables.
- Batch correction is not reversible; always retain the original normalized (pre-correction) matrix for sensitivity analysis.
Evidence
- [other] The preprocess_matrix subworkflow supports three configurable preprocessing operations: filtering via filterByExp or cutoff values, normalization using calcNorm or quantile methods, and batch effect correction using combat, sva, comsva, or svacom approaches, with parameters specifying the condition and batch columns from the samplesheet.: "batch effect correction using combat, sva, comsva, or svacom approaches, with parameters specifying the condition and batch columns from the samplesheet"
- [other] Apply batch-effect correction using ComBat or SVA (as configured in params_genes.yml) to remove known batch effects specified in the sample metadata.: "Apply batch-effect correction using ComBat or SVA (as configured in params_genes.yml) to remove known batch effects specified in the sample metadata"
- [methods] Data preprocessing | R packages: edger, limma, sva, ggplot2, ComplexHeatmap: "Data preprocessing | R packages: edger, limma, sva, ggplot2, ComplexHeatmap"
- [other] Output the normalized and batch-corrected matrix in RData and text formats for downstream differential expression analysis.: "Output the normalized and batch-corrected matrix in RData and text formats for downstream differential expression analysis"
1---2name: batch-effect-correction-combat-sva3description: Use when you have a normalized count matrix (from Salmon or similar quantification tool) with sample metadata that documents batch variables (e.g., sequencing run, processing date, lab site), and you observe or suspect that batch effects—not biological signal—are driving variance across samples.4license: CC-BY-4.05---67# batch-effect-correction-combat-sva89## Summary1011Removes known batch effects from count matrices (typically Salmon-derived expression data) using ComBat or SVA algorithms, with batch source specified via sample metadata columns. This step is essential after normalization to ensure that technical or experimental batch factors do not confound downstream differential expression analysis.1213## When to use1415Apply this skill when you have a normalized count matrix (from Salmon or similar quantification tool) with sample metadata that documents batch variables (e.g., sequencing run, processing date, lab site), and you observe or suspect that batch effects—not biological signal—are driving variance across samples. Use it before differential expression analysis to prevent batch confounding.1617## When NOT to use1819- Input count matrix has not yet been filtered or normalized—apply filtering and normalization first.20- No batch variables are documented in the sample metadata—batch correction requires explicit specification of batch source.21- Batch effects are confounded with biological treatment; in this case, correction risks removing true signal and requires careful design review.2223## Inputs2425- Normalized count matrix (RData or text format, typically output from quantile normalization step)26- Sample metadata/samplesheet file with batch and condition columns2728## Outputs2930- Batch-corrected count matrix (RData format)31- Batch-corrected count matrix (text format)32- Optional: diagnostic plots (PCA, heatmap) showing batch effect removal3334## How to apply3536After filtering and quantile normalization, specify the batch and condition columns in your sample metadata (samplesheet). Load the normalized count matrix and the metadata into R. Select a batch-correction method (ComBat for known batch factors, or SVA/comsva/svacom for unsupervised/surrogate variable estimation). Pass the condition variable (e.g., treatment group) to preserve biological signal while removing batch-associated variance. Apply the chosen correction method, then output the corrected matrix in both RData and text formats for downstream differential expression tools (DESeq2, edgeR). Evaluate success by visual inspection (PCA/heatmap before and after correction) to confirm batch clustering is eliminated.3738## Related tools3940- **sva** (R package providing SVA, ComBat, and surrogate variable estimation methods for batch effect removal)41- **limma** (R package used in conjunction with batch correction for normalization and downstream analysis)42- **edgeR** (R package for count matrix filtering and normalization prior to batch correction)43- **Nextflow** (Workflow orchestration framework that runs batch correction as a containerized process in the preprocessing subworkflow) — https://www.nextflow.io4445## Evaluation signals4647- PCA plot or heatmap shows reduced clustering by batch variable after correction, while biological replicates/treatment groups cluster together.48- Batch-corrected matrix maintains expected count distributions and variance structure (no artificial zero-inflation or extreme negative values).49- Downstream differential expression results show improved consistency and reduced batch-driven false positives when batch-corrected matrix is used versus uncorrected.50- Corrected matrix schema matches input (same rows/genes, same columns/samples) with numeric values in expected range.51- Optional: ComBat/SVA algorithm converges without warnings; surrogate variables (if SVA) explain residual variance orthogonal to batch.5253## Limitations5455- Requires accurate specification of batch and condition columns in metadata; misspecification can remove biological signal.56- ComBat assumes batch effects are additive; may fail if batch-by-treatment interactions are strong.57- SVA requires sufficient sample size per batch and group; small sample designs may yield unreliable surrogate variables.58- Batch correction is not reversible; always retain the original normalized (pre-correction) matrix for sensitivity analysis.5960## Evidence6162- [other] The preprocess_matrix subworkflow supports three configurable preprocessing operations: filtering via filterByExp or cutoff values, normalization using calcNorm or quantile methods, and batch effect correction using combat, sva, comsva, or svacom approaches, with parameters specifying the condition and batch columns from the samplesheet.: "batch effect correction using combat, sva, comsva, or svacom approaches, with parameters specifying the condition and batch columns from the samplesheet"63- [other] Apply batch-effect correction using ComBat or SVA (as configured in params_genes.yml) to remove known batch effects specified in the sample metadata.: "Apply batch-effect correction using ComBat or SVA (as configured in params_genes.yml) to remove known batch effects specified in the sample metadata"64- [methods] Data preprocessing | R packages: edger, limma, sva, ggplot2, ComplexHeatmap: "Data preprocessing | R packages: edger, limma, sva, ggplot2, ComplexHeatmap"65- [other] Output the normalized and batch-corrected matrix in RData and text formats for downstream differential expression analysis.: "Output the normalized and batch-corrected matrix in RData and text formats for downstream differential expression analysis"
HolobiomicsLab