library(ggtwotone)
library(ggplot2)

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 ggplot2 workflows.

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")

- Introduction