Skip to content

deeptime

2.4.0Package record

Plotting Tools for Anyone Working in Deep Time

3packages dependsuggested by 2
11.1Kdownloads / year
48.9%test coverage
11/13flavors OK

Overview

About

Extends the functionality of other plotting packages (notably 'ggplot2') to help facilitate the plotting of data over long time intervals, including, but not limited to, geological, evolutionary, and ecological data. The primary goal of 'deeptime' is to enable users to add highly customizable timescales to their visualizations. Other functions are also included to assist with other areas of deep time visualization.

Changes in 2.4.0

__deeptime now requires R version 4.1 or higher__.

This new minor version of deeptime includes a new feature, some major bug fixes, and some minor housekeeping.

New features:

  • Added geom_text_clade() for adding clade labels to phylogenies when using coord_geo_radial() (#96)

Bug fixes:

  • Fixed several edge cases of coord_trans_xy() including ggforce::reflect() transformations, _reverse_ scales, and capped axes (#57, #102)
  • Fixed coord_geo() scale placement to now always be added outwards from the plot region (#47)
  • Previously, scales on the left and top were added inwards

Deprecation:

  • Soft deprecated disparity_through_time() and panel.disparity(). These functions were never well supported and will be removed in a future version of deeptime to reduce maintenance overhead. Users are encouraged to use coord_trans_xy() to achieve a similar plot with ggplot2.

Miscellaneous:

  • Swapped usage of the magrittr pipe operator (%>%) to the base R pipe operator (|>) (#100)

From NEWS.md in the release

Install

Health

CRAN checks
2ERROR11OK
Check messages
ERRORexamplesr-oldrel-macos-x86_64
Running examples in ‘deeptime-Ex.R’ failed
The error most likely occurred in:

> ### Name: geom_text_clade
> ### Title: Label clades on a phylogenetic tree plotted with ggtree
> ### Aliases: geom_text_clade
> 
> ### ** Examples
> 
> library(ggplot2)
> ## Don't show: 
> if (require(ggtree) && require(phytools)) withAutoprint({ # examplesIf
+ ## End(Don't show)
+ library(ggtree)
+ library(phytools)
+ data(primate.tree)
+ # single annotation
+ revts(ggtree(primate.tree)) +
+   geom_text_clade(label = "Hominoidea", node = 114, extend = c(0.1, 0.1)) +
+   coord_geo_radial()
+ 
+ # data frame of clade labels
+ clades.df <- data.frame(
+   clade = c("Lorisoidea", "Lemuroidea", "Tarsioidea", "Ceboidea",
+             "Cercopithecoidea", "Hominoidea"),
+   node = c(166, 146, 144, 120, 95, 114)
+ )
+ revts(ggtree(primate.tree)) %<+% clades.df +
+   geom_text_clade(aes(label = clade), extend = c(0.1, 0.1)) +
+   coord_geo_radial()
+ 
+ # display with other tip data
+ data(primate.data)
+ activity
...[truncated]...
, 
+     extend = c(0.1, 0.1)) + coord_geo_radial()
Warning in fortify(data, ...) : Arguments in `...` must be used.
✖ Problematic arguments:
• as.Date = as.Date
• yscale_mapping = yscale_mapping
• hang = hang
ℹ Did you misspell an argument name?
> data(primate.data)
> activity <- subset(primate.data, select = "Activity_pattern")
> revts(gheatmap(ggtree(primate.tree), activity, offset = -70, colnames = FALSE, 
+     width = 0.03, color = NA)) %<+% clades.df + geom_text_clade(aes(label = clade), 
+     extend = c(0.1, 0.1), position = position_nudge(x = 10)) + coord_geo_radial()
Warning in fortify(data, ...) : Arguments in `...` must be used.
✖ Problematic arguments:
• as.Date = as.Date
• yscale_mapping = yscale_mapping
• hang = hang
ℹ Did you misspell an argument name?
Scale for y is already present.
Adding another scale for y, which will replace the existing scale.
Error: <ggtree> object properties are invalid:
- @mapping must be <ggplot2::mapping>, not S3<data.frame>
Execution halted
ERRORre-building of vignette outputsr-devel-windows-x86_64
Error(s) in re-building vignettes:
--- re-building 'coord.Rmd' using rmarkdown
--- finished re-building 'coord.Rmd'

--- re-building 'coord_geo.Rmd' using rmarkdown
--- finished re-building 'coord_geo.Rmd'

--- re-building 'geo.Rmd' using rmarkdown

Quitting from geo.Rmd:34-40 [unnamed-chunk-3]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/rlang_error>
Error in `GET_macrostrat()`:
! Content not found. Check your request.
---
Backtrace:
    ▆
 1. └─rmacrostrat::get_units(column_id = 489, interval_name = "Cretaceous")
 2.   └─rmacrostrat:::GET_macrostrat(...)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Error: processing vignette 'geo.Rmd' failed with diagnostics:
Content not found. Check your request.
--- failed re-building 'geo.Rmd'

--- re-building 'ggarrange2.Rmd' using rmarkdown
--- finished re-building 'ggarrange2.Rmd'

--- re-building 'phylogenies.Rmd' using rmarkdown
--- finished re-building 'phylogenies.Rmd'

--- re-building 'time.Rmd' using rmarkdown
--- finished re-building 'time.Rmd'

--- re-building 'traits.Rmd' using rmarkdown
--- finished re-building 'traits.Rmd'

SUMMARY: processing the following file failed:
  'geo.Rmd'

Error: Vignette re-building failed.
Execution halted

CRAN check page ↗

Slowest check: 8.6 min · r-oldrel-windows-x86_64
Status changes
  • ERROR11 OK, 2 ERRORNow
  • ERROR12 OK, 1 ERROR2026-07-11
  • OK13 OK2026-06-22
  • ERROR12 OK, 1 ERROR2026-06-19
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-08
Show 7 earlier changesHide 7 earlier changes
  • OK13 OK2026-05-24
  • ERROR11 OK, 2 ERROR2026-05-17
  • OK13 OK2026-05-10
  • ERROR12 OK, 1 ERROR2026-05-03
  • OK14 OK2026-04-10
  • ERROR13 OK, 1 ERROR2026-04-09
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 2.4.0
READMEYes · 201 wordsVignettesYes · 7 · dynamicNEWSYes · 100% structured · mentions 2.4.0Citation fileYes · cites a publicationWebsiteYes · pkgdown
Help pages
33 (3 internal)includes a package overview page
Examples that run
100%22 run in a plain check (8 of them under a condition)
Exported functions with examples
85%
Documented parameters
85%
Return-value docs
35%
Help pages citing references
0%

Downloads

11.1K
CRAN downloads in the past year
Rank #3,787 · ~31/day · ~928/mo
Daily download trend is not available in this view yet.
90330 days
2.5K90 days
11.1K1 year
Compare downloads with other packages →
Also on234 r2u6 autocran751 conda_forge55 c2d4u

Repository

108Stars
12Forks
7Open issues
5Open PRs
22Releases
499Commits
6Commit identities
geologyggplot2paleontologyrvisualization
License file reads as GPL-3.0 · 499 commits · Last activity 2026-10-14 · +1.9% stars, 30d · Default branch at 2.4.0.9000, ahead of CRAN 2.4.0 (checked 2026-10-18)
Responsiveness
How these are sampled
PRs merged (all time)
86%
Median days to close, 50 most recently updated closed issues
29
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-09-09 · 1022026-10-08 · 108
PracticesBeta

15 development-tooling and community-health practices detected across 9 families in the upstream repository

Checks run against github.com/willgearty/deeptime on 2026-10-18.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (3)
Code of conductContributing guide

The repository owner accepts GitHub Sponsors

Docs source (3)
pkgdown

GitHub Pages site last deployed 2026-10-14 · The repository has a site deploy workflow

pkgdown site last built 2026-07-10

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 5 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (1)
cran-comments.md
Research and citation (1)
Zenodo
Automation and maintenance (1)
Dependabot
Lint, format, editor (2)
Lint workflowRStudio project
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-10-13
    Pull request it wrote: opened by a project member
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
33 external dependencies (excludes base and recommended)

Installing deeptime adds 44 packages (25 with compiled code, 38 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, deeptimedata 2.6 MB.

Depends (1)
R >= 4.1
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
3direct
0indirect
Imports 3
Suggested by 2
Depends, Imports or LinkingTo, most downloaded first
Suggests, most downloaded first

Datasets

People & History

People (1)
Author, Maintainer since 0.1.0 (2021)
Releases (16)

Pick two releases to compare their code metrics.

  • 2.4.0Latest
    record
    2026-07-10 · current release · diff ↗ ·
    added 1 export
    geom_text_clade
  • R
    R 4.6.0 released · 2026-04-24
  • 2.3.1
    record
    2025-11-26 · diff ↗
  • 2.3.0
    record
    2025-11-20 · diff ↗ ·
    removed 1 export
    getScaleData
    added 1 export
    fgdc_dict
  • 2.2.0
    record
    2025-06-19 · diff ↗ ·
    added 5 exports
    facet_grid_geo, facet_nested_geo, facet_nested_wrap_geo, facet_wrap_geo, geom_text_phylo
  • R
    R 4.5.0 released · 2025-04-11
  • 2.1.0
    record
    2024-10-26 · diff ↗ ·
    added 4 exports
    FacetNestedColor, FacetNestedWrapColor, facet_nested_color, facet_nested_wrap_color
  • 2.0.0
    record
    2024-08-19 · diff ↗ ·
    added 6 exports
    GuideGeo, geo_grob, geo_pattern, grid.pattern_geo, guide_geo, scale_fill_geopattern
  • R
    R 4.4.0 released · 2024-04-24
  • 1.1.1
    record
    2024-03-08 · diff ↗
  • 1.1.0
    record
    2024-03-05 · diff ↗ ·
    added 8 exports
    CoordGeoRadial, FacetGridColor, FacetWrapColor, coord_geo_radial, facet_grid_color, facet_wrap_color, geom_points_range, stat_points_range
  • R
    R 4.3.0 released · 2023-04-21
  • 1.0.1
    record
    2023-02-16 · diff ↗ ·
    removed 1 export
    .dummy_gtable
  • 1.0.0
    record
    2023-01-21 · diff ↗ ·
    added 2 exports
    geom_phylomorpho, get_scale_data
  • 0.3.0
    record
    2022-11-09 · diff ↗ ·
    added 6 exports
    CoordGeoPolar, coord_geo_polar, scale_color_geo, scale_colour_geo, scale_discrete_geo, scale_fill_geo
  • 0.2.3
    record
    2022-09-20 · diff ↗
Show 6 earlier eventsHide 6 earlier events
  • 0.2.2
    record
    2022-05-18 · diff ↗
  • R
    R 4.2.0 released · 2022-04-22
  • 0.2.1
    record
    2022-01-11 · diff ↗
  • 0.2.0
    record
    2021-09-02 · diff ↗ ·
    added 2 exports
    CoordTransFlip, coord_trans_flip
  • 0.1.0
    record
    2021-07-23
  • R
    R 4.1.0 released · 2021-05-18

Package metadata

First published
2021-07-23
Total releases
16 / 5 yrs
License
GPL (>= 3) OSI
Minimum R
≥ 4.1
Bundled data
6.2 KB / 6 files
Download size
7.4 MB
Appears in task views

Cite

Cite this package

Run in R for the authors' entry:

citation("deeptime")

The package provides a citation file, so citation() returns the authors' own entry.

It points to 10.1080/20964471.2025.2537516.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for deeptime version 2.4.0 [Data set]. HJJB, LLC. Data release v2026-10-21. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-21, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy