Introduction
ggtwotone extends ggplot2 with
dual-stroke and contrast-aware geoms designed to improve the visibility
of graphical annotations on complex backgrounds.
The package is particularly useful for scientific figures containing images, maps, microscopy data, and heatmaps, where standard single-color annotations may become difficult to distinguish.
Design Philosophy
The package follows three guiding principles:
- Improve visibility across heterogeneous backgrounds.
- Support accessibility through contrast-aware color selection.
- Integrate naturally with existing
ggplot2workflows.
Main Functions
| Function | Description |
|---|---|
geom_segment_dual() |
Dual-stroke line segments |
geom_curve_dual() |
Dual-stroke curved annotations |
geom_path_dual() |
Dual-stroke paths |
geom_function_dual() |
Dual-stroke mathematical functions |
geom_lm_dual() |
Dual-tone regression lines |
geom_text_contrast() |
Contrast-aware text labels |
highlight_colors() |
High-contrast highlight palettes |
adjust_contrast_pair() |
Contrast-aware color utilities |
Typical Applications
ggtwotone is particularly useful for:
- microscopy and biomedical imaging;
- thematic maps and spatial visualizations;
- heatmaps;
- annotated photographs;
- scientific figures intended for publication;
- graphics that must remain readable in grayscale.
Documentation
Detailed examples and complete function documentation are available in:
- the package reference website;
- the individual help pages (
?geom_segment_dual); - the package README.
Citation
If you use ggtwotone in published work, please cite the
package using
citation("ggtwotone")