arXiv · 2609.30627
Contrast-Aware Annotation for Statistical Graphics: The ggtwotone Package for ggplot2
Abstract
Readable annotations are essential for interpreting statistical graphics, yet conventional single-color lines and labels can lose visibility when they cross backgrounds with heterogeneous luminance. We introduce a contrast-aware annotation framework implemented in the ggtwotone R package for ggplot2. The framework combines dual-stroke rendering, adaptive text-color selection, and perceptually guided highlight palettes to improve annotation visibility across light and dark regions. A shared contrast-adjustment engine supports WCAG- and APCA-based contrast criteria, reducing the need for manual color adjustment. The package provides contrast-aware geoms for segments, curves, paths, mathematical functions, regression overlays, and text while remaining compatible with standard ggplot2 workflows. A simulation-based evaluation across heterogeneous background colors demonstrates improved worst-case contrast for dual-stroke annotations and adaptive text selection, while also identifying trade-offs in perceptual separation as the number of requested highlight colors increases. Applications to statistical graphics and scientific images illustrate the framework in practical visualization settings. Together, these tools provide a reproducible approach for incorporating contrast considerations directly into graphical annotation.
Explore related subjects
Keep this discovery
Explore connections, maps & timelines
Beenu Sareena, Heike Hofmann. 2026-09-24. Contrast-Aware Annotation for Statistical Graphics: The ggtwotone Package for ggplot2. https://arxiv.org/abs/2609.30627
Cite the original work for its findings. Save a collection to share your selection of sources.