add_geo_events: Add geological event bands (e.g., GOE, NOE) to a tree plot

View source: R/timescale.R

add_geo_eventsR Documentation

Add geological event bands (e.g., GOE, NOE) to a tree plot

Description

Events are drawn as semi-transparent vertical bands covering the full vertical extent of the tree (but not the geological timescale panels).

Usage

add_geo_events(p, tree, events = NULL)

Arguments

p

ggplot object

tree

phylo object (edge lengths in Ma)

events

Event specification. Can be:

  • NULL (default): shows built-in events (GOE = 2400–2000 Ma, NOE = 800–550 Ma).

  • A data.frame with columns name, age_min (Ma), age_max (Ma), and optionally color.

  • A list of named lists, each with elements name, age_min, age_max, and optionally color.

  • A named list with a single event (shorthand).

If only age is provided (instead of age_min/age_max), a default bandwidth of +/- 200 Ma is used.

Value

ggplot object


Rclade documentation built on Sept. 26, 2026, 5:07 p.m.