geneplotter
Functions for plotting genomic data.
Dependencies & Environment
Package-intrinsic requirements from the Bioconductor landing page — reproduce in any R environment.
- Version: 1.90.0 · Bioconductor: 3.23 · R: ≥ 4.6
- Depends: Biobase, BiocGenerics, lattice, annotate
- Imports: AnnotationDbi, RColorBrewer
- System requirements: URL
- Install:
BiocManager::install("geneplotter")
When to Use
- Visualizing microarray or high-throughput genomic data along chromosomes using
cPlot and cColor.
- Plotting characteristics of expression levels over contiguous regions of a single chromosome using
alongChrom.
- Assembling and plotting
chromLocation objects to map experimental probe data to physical chromosome locations via buildChromLocation.
When NOT to Use
- For modern, highly customizable genomic track visualizations (e.g., plotting RNA-seq coverage, BAM alignments, and gene annotations together), use
Gviz or ggbio instead.
- For general-purpose high-dimensional data visualization (like PCA, t-SNE, or volcano plots), use
ggplot2 or ComplexHeatmap instead.
Data Requirements
- Input:
ExpressionSet objects (e.g., sample.ExpressionSet) or numeric matrices of genomic data.
- Annotation: Requires annotation packages (e.g.,
hu6800.db, hgu95av2.db) to build chromLocation objects and map probe IDs to chromosomal coordinates.
Key Parameters
- useChroms: A character vector specifying which chromosomes to plot in
cPlot.
- plotFormat: Format of the plot in
alongChrom (e.g., "cumulative").
- col: Color vector for distinguishing chromosomes or experimental groups in
cColor or alongChrom.
Best Practices
- Use
buildChromLocation with the appropriate Bioconductor annotation package name (e.g., "hu6800", "hgu95av2") to construct the chromLocation object.
- Reorder chromosomes in the
chromLocation object numerically before plotting with cPlot to ensure a logical layout.
- Set up appropriate device dimensions (e.g., using
layout or par) when using cPlot to ensure chromosome labels and data points do not overlap.
Common Pitfalls
- Mismatched genome builds: Mapping probe data using an outdated annotation package while comparing to coordinates from a newer genome build. Fix: Double-check the source of the metadata and use matching Bioconductor annotation packages.
- Genes mapped to multiple chromosomes: Some genes (e.g., in pseudoautosomal regions) may map to multiple chromosomes, causing issues. Fix: Filter or assign these genes to a single chromosome before building the location object.
Alternatives
- Gviz: For plotting highly customizable, publication-quality genomic tracks.
- ggbio: For grammar-of-graphics based genomic data visualization.
- RIdeogram: For idiogram-based visualization of genome-wide data across chromosomes.
Citations
- Gentleman R. (2023). "geneplotter: Graphic related functions for Bioconductor." R package version 1.84.0.
References
Run this on BioMate
This skill is the knowledge layer — when, why, and how to use geneplotter. To run this analysis on your own data with managed compute, automated QC, and reproducible outputs, use BioMate — free to start.
▶ Open geneplotter on BioMate →
1---2name: bioconductor-geneplotter3description: Functions for plotting genomic data4---56# geneplotter78Functions for plotting genomic data.910## Dependencies & Environment1112> Package-intrinsic requirements from the Bioconductor landing page — reproduce in any R environment.1314- **Version:** 1.90.0 · **Bioconductor:** 3.23 · **R:** ≥ 4.615- **Depends:** Biobase, BiocGenerics, lattice, annotate16- **Imports:** AnnotationDbi, RColorBrewer17- **System requirements:** URL18- **Install:** `BiocManager::install("geneplotter")`1920## When to Use21- Visualizing microarray or high-throughput genomic data along chromosomes using `cPlot` and `cColor`.22- Plotting characteristics of expression levels over contiguous regions of a single chromosome using `alongChrom`.23- Assembling and plotting `chromLocation` objects to map experimental probe data to physical chromosome locations via `buildChromLocation`.2425## When NOT to Use26- For modern, highly customizable genomic track visualizations (e.g., plotting RNA-seq coverage, BAM alignments, and gene annotations together), use `Gviz` or `ggbio` instead.27- For general-purpose high-dimensional data visualization (like PCA, t-SNE, or volcano plots), use `ggplot2` or `ComplexHeatmap` instead.2829## Data Requirements30- **Input**: `ExpressionSet` objects (e.g., `sample.ExpressionSet`) or numeric matrices of genomic data.31- **Annotation**: Requires annotation packages (e.g., `hu6800.db`, `hgu95av2.db`) to build `chromLocation` objects and map probe IDs to chromosomal coordinates.3233## Key Parameters34- **useChroms**: A character vector specifying which chromosomes to plot in `cPlot`.35- **plotFormat**: Format of the plot in `alongChrom` (e.g., `"cumulative"`).36- **col**: Color vector for distinguishing chromosomes or experimental groups in `cColor` or `alongChrom`.3738## Best Practices39- Use `buildChromLocation` with the appropriate Bioconductor annotation package name (e.g., `"hu6800"`, `"hgu95av2"`) to construct the `chromLocation` object.40- Reorder chromosomes in the `chromLocation` object numerically before plotting with `cPlot` to ensure a logical layout.41- Set up appropriate device dimensions (e.g., using `layout` or `par`) when using `cPlot` to ensure chromosome labels and data points do not overlap.4243## Common Pitfalls44- **Mismatched genome builds**: Mapping probe data using an outdated annotation package while comparing to coordinates from a newer genome build. *Fix*: Double-check the source of the metadata and use matching Bioconductor annotation packages.45- **Genes mapped to multiple chromosomes**: Some genes (e.g., in pseudoautosomal regions) may map to multiple chromosomes, causing issues. *Fix*: Filter or assign these genes to a single chromosome before building the location object.4647## Alternatives48- **Gviz**: For plotting highly customizable, publication-quality genomic tracks.49- **ggbio**: For grammar-of-graphics based genomic data visualization.50- **RIdeogram**: For idiogram-based visualization of genome-wide data across chromosomes.5152## Citations53- Gentleman R. (2023). "geneplotter: Graphic related functions for Bioconductor." *R package version 1.84.0*.5455## References56- Homepage: https://bioconductor.org/packages/geneplotter57- Vignette: https://bioconductor.org/packages/release/bioc/vignettes/geneplotter/inst/doc/visualizing.pdf5859<!-- biomate-cta -->60---6162## Run this on BioMate6364This skill is the **knowledge layer** — when, why, and how to use `geneplotter`. To **run this analysis on your own data** with managed compute, automated QC, and reproducible outputs, use **[BioMate](https://www.biomate.ai?ref=kb&pkg=geneplotter)** — free to start.6566▶ **[Open `geneplotter` on BioMate →](https://www.biomate.ai?ref=kb&pkg=geneplotter)**