                 Changes in version 2.4.0 (2026-07-10)                  

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)

                 Changes in version 2.3.1 (2025-11-26)                  

Bug fixes:

  - Fixed behavior of the reverse argument for coord_geo_radial() for
    ggplot2 4.0.0 and up (#96)

Deprecation:

  - Soft deprecated the direction argument of coord_geo_radial() in
    favor of the reverse argument that was added in deeptime 2.2.0
  - Soft deprecated the r_axis_inside argument coord_geo_radial() in
    favor of the new r.axis.inside argument to maintain parity with
    ggplot2::coord_radial()
  - Soft deprecated the rotate_angle argument coord_geo_radial() in
    favor of the new rotate.angle argument to maintain parity with
    ggplot2::coord_radial()

                 Changes in version 2.3.0 (2025-11-20)                  

This new minor version of deeptime includes a small number of new
features and some minor housekeeping.

New features:

  - The pos argument for coord_geo() is now recycled when dat is a list,
    removing the need for repeated pos values when adding multiple time
    scales to the same side (#86)
  - Added built-in dataset fgdc_names which includes FGDC pattern codes
    and verbatim names for named patterns
  - Added fgdc_dict() which can be used to generate a labeling
    dictionary for FGDC pattern codes (#79)
  - Added an optional theme element (deeptime.scale.background) to
    customize the background of the time scale area in coord_geo() (#87)

Deprecation:

  - Removed getScaleData().
  - Advanced the deprecation of gggeo_scale(). This function has been
    fully deprecated from deeptime in favor of coord_geo().

Miscellaneous:

  - Updated citation information for the package (#89)
  - Updated package logo to reflect the recent inclusion of patterns
    (#90)
  - Added contribution docs (#91)

                 Changes in version 2.2.0 (2025-06-19)                  

This new minor version of deeptime introduces several new features and
bug fixes. It also is compatible with version 4 of ggplot2.

New features:

  - Added geom_text_phylo() for adding node/tip labels to phylogenies
    when using coord_geo_radial()
  - Updated built-in timescales to 2024/12 version of GTS
  - Removed the defaults for the colors argument in facet_grid_color(),
    facet_wrap_color(), facet_nested_color(), and
    facet_nested_wrap_color()
      - Added facet_grid_geo(), facet_wrap_geo(), facet_nested_geo(),
        and facet_nested_wrap_geo() which now serve as aliases for these
        functions with their original defaults (#81)
  - Added legends to the examples in the "Plotting
    geological/stratigraphical patterns" vignette (#78)
  - Added facetting examples to the "Plotting temporal data" vignette
    (#80)

Deprecation:

  - Advanced the deprecation of coord_geo_polar(). Use of this function
    will result in a warning. This function will be removed in a future
    version of deeptime.
  - Advanced the deprecation of getScaleData(). This function has been
    fully deprecated from deeptime in favor of get_scale_data().

Bug fixes:

  - Fixed gtable_frame2() and ggarrange2() for plots that use
    theme_void() (#74)
  - Fixed disparity_through_time() for rare edge cases (#71)
  - Updated GeomPointsRange to use the aesthetic defaults from
    ggplot2::GeomPointrange
  - Updated GeomTextPhylo to use the aesthetic defaults from
    ggplot2::GeomText

                 Changes in version 2.1.0 (2024-10-25)                  

This new minor version of deeptime introduces several new features and
bug fixes.

New features:

  - Added default label color values to all built-in data as a new
    lab_color column
      - The label colors are either white or black, whichever has better
        contrast with the background color based on recommendations by
        the International Telecommunication Union
  - get_scale_data() now returns label colors (as above) for Macrostrat
    timescales
  - Varying strip label colors can now be set with the lab_colors
    argument in facet_wrap_color() and facet_grid_color() (#68)
      - By default, the strip label colors are set to white or black (as
        above)
  - Added facet_nested_color() and facet_nested_wrap_color() to plot
    nested faceted plots with colored strips (#55)
  - get_scale_data() documentation now lists the available Macrostrat
    timescales (#69)
  - get_scale_data() now supports partial matching to Macrostrat
    timescales (e.g., get_scale_data("mammal") will retrieve the "North
    American land mammal ages" timescale)

Notable changes:

  - The FGDC pattern data added in deeptime 2.0.0 has been moved to a
    new data R package called deeptimedata to reduce the size of the
    deeptime package and the footprint of future deeptime updates

Bug fixes:

  - Fixed importing some functions from ggplot2 for coord_geo_radial()
    and coord_geo_polar()

                 Changes in version 2.0.0 (2024-08-19)                  

deeptime now requires ggplot2 version 3.5.0 or higher.
This new major version of deeptime includes several new features:

  - Added FGDC/USGS geologic patterns to internal data (#52)
  - Added functions to retrieve and plot FGDC/USGS geologic patterns
    (#52)
  - Added functions to use FGDC/USGS patterns as ggplot2 fills or with
    the ggpattern package (see new vignette) (#52)
  - Added the true_colors option to get_scale_data(), which, when set to
    FALSE, can be used to retrieve the custom Macrostrat colors that
    were previously in the built-in datasets (#62)
  - Updated built-in timescales to 2023/06 version of GTS
  - Added option to coord_geo() to abbreviate interval labels based on
    only the intervals that are being plotted (#64)
  - Added guide_geo() as an alternative to coord_geo(), mostly for use
    with radial plots (#53)

Bug fixes:

  - Fixed the built-in timescale datasets to have true CGMP colors for
    the Precambrian (#62)

Notable changes:

  - The phytools package is no longer required to install deeptime but
    is required to use the geom_phylomorpho() function
  - The geomtextpath package is no longer required to install deeptime
    but is required to add labels with the coord_geo_polar() or
    coord_geo_radial() functions
  - The gggeo_scale_old() function has been fully deprecated

                 Changes in version 1.1.1 (2024-03-08)                  

deeptime now requires rlang version 1.1.0 or higher. This patch version
includes several bug fixes:

  - Fixed several cases where vignette and documentation building and/or
    unit testing would fail when the Macrostrat API was down
  - Fixed coord_geo_polar() and coord_geo_radial() when the r-axis has
    expansion (#60)
  - Improved argument type checking and error handling across the entire
    package

                 Changes in version 1.1.0 (2024-03-05)                  

deeptime now requires ggplot2 version 3.4.0 or higher. This version
introduces several new features and bug fixes:

  - Added geom_points_range(), a function designed for visualizing
    temporal occurrence data
  - Added facet_grid_color() and facet_wrap_color() for changing strip
    background colors (#50)
  - Added coord_geo_radial(), an enhanced version of coord_geo_polar()
    (only works with ggplot2 version 3.5.0 and higher) (#56)
  - Added family and fontface arguments to coord_geo()
  - Added the ability to include interval labels with coord_geo_polar()
    (#48)
  - Fixed the interaction between coord_geo() and ggsave() (#49)
  - Fixed size = "auto" when center_end_labels = TRUE in coord_geo()
  - Updated several functions to work with ggplot2 version 3.5.0

Notable changes:

  - The names for the theme elements that are used for coord_geo_polar()
    are now prepended with "deeptime." (e.g., deeptime.axis.line.r)
    (#51)
  - ggplot2 version 3.5.0 has broken several edge cases of
    coord_trans_xy(). See the documentation for more details. This will
    be fixed in a future deeptime release.

                 Changes in version 1.0.1 (2023-02-16)                  

  - Fixed the bounds of the Kungurian stage in the built-in stages data
  - Updated License to GPL >= 3
  - Changed tidyverse to dplyr and magrittr in Suggests and vignettes

                 Changes in version 1.0.0 (2023-01-20)                  

  - Updated built-in timescales to 2022/10 version of GTS
  - Added a geom for making phylomorphospaces (geom_phylomorpho())
  - Added vignettes
  - Renamed getScaleData() to get_scale_data()
  - Soft deprecated gggeo_scale() and gggeo_scale_old()

                 Changes in version 0.3.0 (2022-11-09)                  

deeptime now requires ggplot2 version 3.3.0 or higher. Several new
features and fixed compatibility with various ggplot2 versions.

  - Added coord_geo_polar(), for adding timescales to polar plots (#33)
  - Added color and fill discrete scales that use the GTS colors (#43)
  - Fixed coord_geo_polar() and coord_trans_xy() for ggplot2
    version 3.4.0 (#44)
  - Fixed coord_geo() for ggplot2 version 3.4.0
  - Added tests for both ggplot2 version 3.3.6 and 3.4.0
  - Removed uses of getFromNamespace() (#45)

                 Changes in version 0.2.3 (2022-09-20)                  

  - Updated built-in timescales to 2022/02 version of GTS
  - Better name handling and documentation for getScaleData() (#42)

                 Changes in version 0.2.2 (2022-05-18)                  

  - Skip tests when suggested packages are unavailable
  - Added the ability to specify label color (#40)

                 Changes in version 0.2.1 (2022-01-10)                  

Updated built-in timescales

  - Updated the built-in timescales using the Macrostrat API (#39)
  - Fixed CRAN checks when ggtree is missing (#38)

                 Changes in version 0.2.0 (2021-09-02)                  

Several new features and bug fixes.

  - coord_geo() now works with discrete axes (#32 and #35)
  - Fixed a bug that prevented the use of custom interval data
  - Added option to use ggfittext to automatically resize labels (#19)
  - Added coord_trans_flip() (#20)
  - Fixed axis labels for coord_trans_xy() (#36)
  - Added tests with testthat (#34)

                 Changes in version 0.1.0 (2021-07-23)                  

First minor release (released on CRAN!)

  - Fixed ability to use text transformations (from scales) in
    coord_geo() (#30)
  - Added automatic R CMD check Github Actions
  - Fixed S3 method consistency and other R CMD check warnings and notes
  - Fixed coord_geo() when axis breaks were reversed or NULL (#23 and
    #29)
  - Added packages from examples and README to Suggests

                        Changes in version 0.0.6                        

Several bug fixes and minor features.

  - Added ability to specify a layout for ggarrange2() (#21)
  - Added ability to center labels for time intervals that are broken by
    axis limits (#18)
  - Fixed gggeo_scale() for ggplot2>=3.3.0 (#22)
  - Replaced README examples with examples using real data (#28)
  - Fixed using first letters for the pos argument
  - Fixed label order (#26)
  - Switched from Travis to Github Actions (#27)
  - Fixed handling of axis tick labels for coord_trans_xy (#31)

                        Changes in version 0.0.5                        

Added coord_geo(), which is a coordinate system for ggplot2 that allows
for adding highly customized timescales to ggplot objects. Both
gggeo_scale() and gggeo_scale_old are preserved but will receive notably
less maintenance moving forward.

  - Updated examples and documentation to use coord_geo()
  - Added coord_trans_xy(), which is a coordinate system for ggplot2
    that is similar to coord_trans() but allows for 2-dimensional
    transformations
  - Added disparity_through_time() which allows for
    plotting 2-dimensional data across a 3rd dimension (using lattice)

                        Changes in version 0.0.4                        

ggarrange2() now accepts geo_scale objects and other grobified ggplots

  - Fixed missing axes and axis titles

                        Changes in version 0.0.3                        

Minor release for bug fixes

  - Added options to customize borders and line width
  - Fixed abbreviations for stages named "Series X" (#9)
  - Fixed scale when x-axis crosses 0 (#10, #12)
  - Preserve margins of original plots (#13)
  - Fixed scale for plots with multiple panels

                        Changes in version 0.0.2                        

Complete redesign of gggeo_scale() that adds the scale outside of the
plotting space using gtable. The old version of gggeo_scale() is
preserved as gggeo_scale_old().

  - Can now pull timescales from the Macrostrat API (#8)

                        Changes in version 0.0.1                        

First full release. Adds scale onto the bottom of a ggplot.

  - Depends on R>3.4 (#1)
  - Fixed adding scales to faceted plots (#2)
  - Added timescale data from PBDB API (#3)
  - Fixed the use of ggtree when a geom has its own data (#5)
  - Fixed the stacking of multiple scales (#6)
  - Fixed documentation spelling (#7)
