Skip to contents

Adding geological timescales to plots

The original purpose of deeptime, coord_geo() adds a highly customizable timescale to any ggplot2 plot. Other functions now supplement it to aid in the visualization of data over long time scales.

coord_geo()
Transformed coordinate system with geological timescale
scale_color_geo() scale_fill_geo() scale_discrete_geo()
Geological Time Scale color scales
get_scale_data()
Get geological timescale data
guide_geo()
Geological timescale axis guide

Built-in interval data

deeptime includes a selection of built-in interval data from the most up-to-date Geological Time Scale. These dataframes include name, max age, min age, abbreviation, and color columns.

eons
Eon data from the International Commission on Stratigraphy (v2023/06)
eras
Era data from the International Commission on Stratigraphy (v2023/06)
periods
Period data from the International Commission on Stratigraphy (v2023/06)
epochs
Epoch data from the International Commission on Stratigraphy (v2023/06)
stages
Stage data from the International Commission on Stratigraphy (v2023/06)

Deprecated functions

The following function(s) represent early iterations of what is now coord_geo(). These function(s) still work but are considered “deprecated”. They will be removed in a future version of deeptime, and users are strongly encouraged to use coord_geo() instead, which has more features and is still under active development.

gggeo_scale() print(<geo_scale>) deprecated
Add a geologic scale below ggplots using grid

Adding geological timescales to phylogenies

These functions can be used to add timescales specifically to phylogenies that are plotted with ggtree.

coord_geo()
Transformed coordinate system with geological timescale
coord_geo_radial()
Enhanced polar coordinate system with geological timescale
coord_geo_polar() deprecated
Polar coordinate system with geological timescale
scale_color_geo() scale_fill_geo() scale_discrete_geo()
Geological Time Scale color scales
get_scale_data()
Get geological timescale data
guide_geo()
Geological timescale axis guide

Transforming coordinate systems

These functions can be used to modify the way that your data is plotted by ggplot2.

coord_trans_flip()
Transformed and flipped Cartesian coordinate system
coord_trans_xy()
Transformed XY Cartesian coordinate system

Plotting trait data

These functions can be used for visualizing species trait data.

geom_phylomorpho()
Plot a 2-D phylomorphospace in ggplot2
disparity_through_time()
Disparity through time plot using lattice
panel.disparity()
Combined wireframe and cloud panel
coord_trans_xy()
Transformed XY Cartesian coordinate system

Plotting temporal data

These functions can be used for visualizing categorical temporal data.

geom_points_range() stat_points_range()
Display points and their range
facet_grid_color()
Lay out panels in a grid with colored strips
facet_wrap_color()
Wrap a 1d ribbon of panels into 2d with colored strips
facet_nested_color()
Layout panels in a grid with nested colored strips
facet_nested_wrap_color()
Ribbon of panels with nested colored strips

Plotting geologic data

These functions can be used for visualizing geologic/stratigraphic data.

grid.pattern_geo()
Plot an individual FGDC pattern using grid
geo_pattern() geo_grob()
Get a FGDC geologic plotting pattern
scale_fill_geopattern()
Geologic pattern fill scale

Combining and arranging plots

These functions can be used to combine and arrange plots into publishable-quality figures.

ggarrange2()
Combine and arrange multiple ggplot-like objects
gtable_frame2()
Decompose a ggplot gtable