Skip to content
Compare
Choose a tag to compare

This is a very small release focusing on fixing a couple of untenable issues
that surfaced with the 3.3.4 release

  • Revert changes made in #4434 (apply transform to intercept in geom_abline())
    as it introduced undesirable issues far worse than the bug it fixed
    (@thomasp85, #4514)
  • Fixes an issue in ggsave() when producing emf/wmf files (@yutannihilation,
    #4521)
  • Warn when grDevices specific arguments are passed to ragg devices (@thomasp85,
    #4524)
  • Fix an issue where coord_sf() was reporting that it is non-linear
    even when data is provided in projected coordinates (@clauswilke, #4527)
d79a2c6
Compare
Choose a tag to compare

This is a larger patch release fixing a huge number of bugs and introduces a
small selection of feature refinements.

Features

  • Alt-text can now be added to a plot using the alt label, i.e
    + labs(alt = ...). Currently this alt text is not automatically propagated,
    but we plan to integrate into Shiny, RMarkdown, and other tools in the future.
    (@thomasp85, #4477)

  • Add support for the BrailleR package for creating descriptions of the plot
    when rendered (@thomasp85, #4459)

  • coord_sf() now has an argument default_crs that specifies the coordinate
    reference system (CRS) for non-sf layers and scale/coord limits. This argument
    defaults to NULL, which means non-sf layers are assumed to be in projected
    coordinates, as in prior ggplot2 versions. Setting default_crs = sf::st_crs(4326)
    provides a simple way to interpret x and y positions as longitude and latitude,
    regardless of the CRS used by coord_sf(). Authors of extension packages
    implementing stat_sf()-like functionality are encouraged to look at the source
    code of stat_sf()'s compute_group() function to see how to provide scale-limit
    hints to coord_sf() (@clauswilke, #3659).

  • ggsave() now uses ragg to render raster output if ragg is available. It also
    handles custom devices that sets a default unit (e.g. ragg::agg_png)
    correctly (@thomasp85, #4388)

  • ggsave() now returns the saved file location invisibly (#3379, @eliocamp).

  • The scale arguments limits, breaks, minor_breaks, labels, rescaler
    and oob now accept purrr style lambda notation (@teunbrand, #4427). The same
    is true for as_labeller() (and therefore also labeller())
    (@netique, #4188).

  • Manual scales now allow named vectors passed to values to contain fewer
    elements than existing in the data. Elements not present in values will be set
    to NA (@thomasp85, #3451)

  • Date and datetime position scales support out-of-bounds (oob) arguments to
    control how limits affect data outside those limits (@teunbrand, #4199).

Fixes

  • Fix a bug that after_stat() and after_scale() cannot refer to aesthetics
    if it's specified in the plot-global mapping (@yutannihilation, #4260).

  • Fix bug in annotate_logticks() that would cause an error when used together
    with coord_flip() (@thomasp85, #3954)

  • Fix a bug in geom_abline() that resulted in intercept not being subjected
    to the transformation of the y scale (@thomasp85, #3741)

  • Extent the range of the line created by geom_abline() so that line ending
    is not visible for large linewidths (@thomasp85, #4024)

  • Fix bug in geom_dotplot() where dots would be positioned wrong with
    stackgroups = TRUE (@thomasp85, #1745)

  • Fix calculation of confidence interval for locfit smoothing in geom_smooth()
    (@topepo, #3806)

  • Fix bug in geom_text() where "outward" and "inward" justification for
    some angle values was reversed (@aphalo, #4169, #4447)

  • ggsave() now sets the default background to match the fill value of the
    plot.background theme element (@karawoo, #4057)

  • It is now deprecated to specify guides(<scale> = FALSE) or
    scale_*(guide = FALSE) to remove a guide. Please use
    guides(<scale> = "none") or scale_*(guide = "none") instead
    (@yutannihilation, #4094).

  • Fix a bug in guide_bins() where keys would disappear if the guide was
    reversed (@thomasp85, #4210)

  • Fix bug in guide_coloursteps() that would repeat the terminal bins if the
    breaks coincided with the limits of the scale (@thomasp85, #4019)

  • Make sure that default labels from default mappings doesn't overwrite default
    labels from explicit mappings (@thomasp85, #2406)

  • Fix bug in labeller() where parsing was turned off if .multiline = FALSE
    (@thomasp85, #4084)

  • Make sure label_bquote() has access to the calling environment when
    evaluating the labels (@thomasp85, #4141)

  • Fix a bug in the layer implementation that introduced a new state after the
    first render which could lead to a different look when rendered the second
    time (@thomasp85, #4204)

  • Fix a bug in legend justification where justification was lost of the legend
    dimensions exceeded the available size (@thomasp85, #3635)

  • Fix a bug in position_dodge2() where NA values in thee data would cause an
    error (@thomasp85, #2905)

  • Make sure position_jitter() creates the same jittering independent of
    whether it is called by name or with constructor (@thomasp85, #2507)

  • Fix a bug in position_jitter() where different jitters would be applied to
    different position aesthetics of the same axis (@thomasp85, #2941)

  • Fix a bug in qplot() when supplying c(NA, NA) as axis limits
    (@thomasp85, #4027)

  • Remove cross-inheritance of default discrete colour/fill scales and check the
    type and aesthetic of function output if type is a function
    (@thomasp85, #4149)

  • Fix bug in scale_[x|y]_date() where custom breaks functions that resulted in
    fracional dates would get misaligned (@thomasp85, #3965)

  • Fix bug in scale_[x|y]_datetime() where a specified timezone would be
    ignored by the scale (@thomasp85, #4007)

  • Fix issue in sec_axis() that would throw warnings in the absence of any
    secondary breaks (@thomasp85, #4368)

  • stat_bin()'s computed variable width is now documented (#3522).

  • stat_count() now computes width based on the full dataset instead of per
    group (@thomasp85, #2047)

  • Extended stat_ecdf() to calculate the cdf from either x or y instead from y
    only (@jgjl, #4005)

  • Fix a bug in stat_summary_bin() where one more than the requested number of
    bins would be created (@thomasp85, #3824)

  • Only drop groups in stat_ydensity() when there are fewer than two data
    points and throw a warning (@andrewwbutler, #4111).

  • Fixed a bug in strip assembly when theme has strip.text = element_blank()
    and plots are faceted with multi-layered strips (@teunbrand, #4384).

  • Using theme(aspect.ratio = ...) together with free space in facet_grid()
    now crrectly throws an error (@thomasp85, #3834)

  • Fixed a bug in labeller() so that .default is passed to as_labeller()
    when labellers are specified by naming faceting variables. (@waltersom, #4031)

  • Updated style for example code (@rjake, #4092)

  • ggplot2 now requires R >= 3.3 (#4247).

  • ggplot2 now uses rlang::check_installed() to check if a suggested package is
    installed, which will offer to install the package before continuing (#4375,
    @malcolmbarrett)

  • Improved error with hint when piping a ggplot object into a facet function
    (#4379, @mitchelloharawild).

Compare
Choose a tag to compare

This is a small patch release mainly intended to address changes in R and CRAN.
It further changes the licensing model of ggplot2 to an MIT license.

  • Update the ggplot2 licence to an MIT license (#4231, #4232, #4233, and #4281)
  • Use vdiffr conditionally so ggplot2 can be tested on systems without vdiffr
  • Update tests to work with the new all.equal() defaults in R >4.0.3
0a72828
Compare
Choose a tag to compare

This is a small release focusing on fixing regressions introduced in 3.3.1.

  • Added an outside option to annotation_logticks() that places tick marks
    outside of the plot bounds. (#3783, @kbodwin)

  • annotation_raster() adds support for native rasters. For large rasters,
    native rasters render significantly faster than arrays (@kent37, #3388)

  • Facet strips now have dedicated position-dependent theme elements
    (strip.text.x.top, strip.text.x.bottom, strip.text.y.left,
    strip.text.y.right) that inherit from strip.text.x and strip.text.y,
    respectively. As a consequence, some theme stylings now need to be applied to
    the position-dependent elements rather than to the parent elements. This
    change was already introduced in ggplot2 3.3.0 but not listed in the
    changelog. (@thomasp85, #3683)

  • Facets now handle layers containing no data (@yutannihilation, #3853).

  • A newly added geom geom_density_2d_filled() and associated stat
    stat_density_2d_filled() can draw filled density contours
    (@clauswilke, #3846).

  • A newly added geom_function() is now recommended to use in conjunction
    with/instead of stat_function(). In addition, stat_function() now
    works with transformed y axes, e.g. scale_y_log10(), and in plots
    containing no other data or layers (@clauswilke, #3611, #3905, #3983).

  • Fixed a bug in geom_sf() that caused problems with legend-type
    autodetection (@clauswilke, #3963).

  • Support graphics devices that use the file argument instead of fileneame
    in ggsave() (@bwiernik, #3810)

  • Default discrete color scales are now configurable through the options() of
    ggplot2.discrete.colour and ggplot2.discrete.fill. When set to a character
    vector of colour codes (or list of character vectors) with sufficient length,
    these colours are used for the default scale. See help(scale_colour_discrete)
    for more details and examples (@cpsievert, #3833).

  • Default continuous colour scales (i.e., the options()
    ggplot2.continuous.colour and ggplot2.continuous.fill, which inform the
    type argument of scale_fill_continuous() and scale_colour_continuous())
    now accept a function, which allows more control over these default
    continuous_scale()s (@cpsievert, #3827).

  • A bug was fixed in stat_contour() when calculating breaks based on
    the bins argument (@clauswilke, #3879, #4004).

  • Data columns can now contain Vector S4 objects, which are widely used in the
    Bioconductor project. (@teunbrand, #3837)

dc3b103
Compare
Choose a tag to compare

This is a small release with no code change. It removes all malicious links to a
site that got hijacked from the readme and pkgdown site.

625a03a
Compare
Choose a tag to compare

This is a minor release but does contain a range of substantial new features,
along with the standard bug fixes. The release contains a few visual breaking
changes, along with breaking changes for extension developers due to a shift in
internal representation of the position scales and their axes. No user breaking
changes are included.

This release also adds Dewey Dunnington (@paleolimbot) to the core team.

Breaking changes

There are no user-facing breaking changes, but a change in some internal
representations that extension developers may have relied on, along with a few
breaking visual changes which may cause visual tests in downstream packages to
fail.

  • The panel_params field in the Layout now contains a list of list of
    ViewScale objects, describing the trained coordinate system scales, instead
    of the list object used before. Any extensions that use this field will likely
    break, as will unit tests that checks aspects of this.

  • element_text() now issues a warning when vectorized arguments are provided,
    as in colour = c("red", "green", "blue"). Such use is discouraged and not
    officially supported (@clauswilke, #3492).

  • Changed theme_grey() setting for legend key so that it creates no border
    (NA) rather than drawing a white one. (@annennenne, #3180)

  • geom_ribbon() now draws separate lines for the upper and lower intervals if
    colour is mapped. Similarly, geom_area() and geom_density() now draw
    the upper lines only in the same case by default. If you want old-style full
    stroking, use outline.type = "full" (@yutannihilation, #3503 / @thomasp85, #3708).

New features

  • The evaluation time of aesthetics can now be controlled to a finer degree.
    after_stat() supersedes the use of stat() and ..var..-notation, and is
    joined by after_scale() to allow for mapping to scaled aesthetic values.
    Remapping of the same aesthetic is now supported with stage(), so you can
    map a data variable to a stat aesthetic, and remap the same aesthetic to
    something else after statistical transformation (@thomasp85, #3534)

  • All coord_*() functions with xlim and ylim arguments now accept
    vectors with NA as a placeholder for the minimum or maximum value
    (e.g., ylim = c(0, NA) would zoom the y-axis from 0 to the
    maximum value observed in the data). This mimics the behaviour
    of the limits argument in continuous scale functions
    (@paleolimbot, #2907).

  • Allowed reversing of discrete scales by re-writing get_limits()
    (@AnneLyng, #3115)

  • All geoms and stats that had a direction (i.e. where the x and y axes had
    different interpretation), can now freely choose their direction, instead of
    relying on coord_flip(). The direction is deduced from the aesthetic
    mapping, but can also be specified directly with the new orientation
    argument (@thomasp85, #3506).

  • Position guides can now be customized using the new guide_axis(), which can
    be passed to position scale_*() functions or via guides(). The new axis
    guide (guide_axis()) comes with arguments check.overlap (automatic removal
    of overlapping labels), angle (easy rotation of axis labels), and
    n.dodge (dodge labels into multiple rows/columns) (@paleolimbot, #3322).

  • A new scale type has been added, that allows binning of aesthetics at the
    scale level. It has versions for both position and non-position aesthetics and
    comes with two new guides (guide_bins and guide_coloursteps)
    (@thomasp85, #3096)

  • scale_x_continuous() and scale_y_continuous() gains an n.breaks argument
    guiding the number of automatic generated breaks (@thomasp85, #3102)

  • Added stat_contour_filled() and geom_contour_filled(), which compute
    and draw filled contours of gridded data (@paleolimbot, #3044).
    geom_contour() and stat_contour() now use the isoband package
    to compute contour lines. The complete parameter (which was undocumented
    and has been unused for at least four years) was removed (@paleolimbot, #3044).

  • Themes have gained two new parameters, plot.title.position and
    plot.caption.position, that can be used to customize how plot
    title/subtitle and plot caption are positioned relative to the overall plot
    (@clauswilke, #3252).

Extensions

  • Geom now gains a setup_params() method in line with the other ggproto
    classes (@thomasp85, #3509)

  • The newly added function register_theme_elements() now allows developers
    of extension packages to define their own new theme elements and place them
    into the ggplot2 element tree (@clauswilke, #2540).

Minor improvements and bug fixes

  • coord_trans() now draws second axes and accepts xlim, ylim,
    and expand arguments to bring it up to feature parity with
    coord_cartesian(). The xtrans and ytrans arguments that were
    deprecated in version 1.0.1 in favour of x and y
    were removed (@paleolimbot, #2990).

  • coord_trans() now calculates breaks using the expanded range
    (previously these were calculated using the unexpanded range,
    which resulted in differences between plots made with coord_trans()
    and those made with coord_cartesian()). The expansion for discrete axes
    in coord_trans() was also updated such that it behaves identically
    to that in coord_cartesian() (@paleolimbot, #3338).

  • expand_scale() was deprecated in favour of expansion() for setting
    the expand argument of x and y scales (@paleolimbot).

  • geom_abline(), geom_hline(), and geom_vline() now issue
    more informative warnings when supplied with set aesthetics
    (i.e., slope, intercept, yintercept, and/or xintercept)
    and mapped aesthetics (i.e., data and/or mapping).

  • Fix a bug in geom_raster() that squeezed the image when it went outside
    scale limits (#3539, @thomasp85)

  • geom_sf() now determines the legend type automatically (@microly, #3646).

  • geom_sf() now removes rows that can't be plotted due to NA aesthetics
    (#3546, @thomasp85)

  • geom_sf() now applies alpha to linestring geometries
    (#3589, @yutannihilation).

  • gg_dep() was deprecated (@perezp44, #3382).

  • Added function ggplot_add.by() for lists created with by(), allowing such
    lists to be added to ggplot objects (#2734, @Maschette)

  • ggplot2 no longer depends on reshape2, which means that it no longer
    (recursively) needs plyr, stringr, or stringi packages.

  • Increase the default nbin of guide_colourbar() to place the ticks more
    precisely (#3508, @yutannihilation).

  • manual_scale() now matches values with the order of breaks whenever
    values is an unnamed vector. Previously, unnamed values would match with
    the limits of the scale and ignore the order of any breaks provided. Note
    that this may change the appearance of plots that previously relied on the
    unordered behaviour (#2429, @idno0001).

  • scale_manual_*(limits = ...) now actually limits the scale (#3262,
    @yutannihilation).

  • Fix a bug when show.legend is a named logical vector
    (#3461, @yutannihilation).

  • Added weight aesthetic option to stat_density() and made scaling of
    weights the default (@annennenne, #2902)

  • stat_density2d() can now take an adjust parameter to scale the default
    bandwidth. (#2860, @haleyjeppson)

  • stat_smooth() uses REML by default, if method = "gam" and
    gam's method is not specified (@ikosmidis, #2630).

  • stacking text when calculating the labels and the y axis with
    stat_summary() now works (@ikosmidis, #2709)

  • stat_summary() and related functions now support rlang-style lambda functions
    (#3568, @dkahle).

  • The data mask pronoun, .data, is now stripped from default labels.

  • Addition of partial themes to plots has been made more predictable;
    stepwise addition of individual partial themes is now equivalent to
    addition of multple theme elements at once (@clauswilke, #3039).

  • Facets now don't fail even when some variable in the spec are not available
    in all layers (@yutannihilation, #2963).

3eb4087
Compare
Choose a tag to compare

This is a patch release fixing a few regressions introduced in 3.2.0 as well as
fixing some unit tests that broke due to upstream changes.

  • position_stack() no longer changes the order of the input data. Changes to
    the internal behaviour of geom_ribbon() made this reordering problematic
    with ribbons that spanned y = 0 (#3471)
  • Using qplot() with a single positional aesthetic will no longer title the
    non-specified scale as "NULL" (#3473)
  • Fixes unit tests for sf graticule labels caused by chages to sf
a4785c8
Compare
Choose a tag to compare

This is a minor release with an emphasis on internal changes to make ggplot2
faster and more consistent. The few interface changes will only affect the
aesthetics of the plot in minor ways, and will only potentially break code of
extension developers if they have relied on internals that have been changed.
This release also sees the addition of Hiroaki Yutani (@yutannihilation) to the
core developer team.

With the release of R 3.6, ggplot2 now requires the R version to be at least 3.2,
as the tidyverse is committed to support 5 major versions of R.

Breaking changes

  • Two patches (#2996 and #3050) fixed minor rendering problems. In most cases,
    the visual changes are so subtle that they are difficult to see with the naked
    eye. However, these changes are detected by the vdiffr package, and therefore
    any package developers who use vdiffr to test for visual correctness of ggplot2
    plots will have to regenerate all reference images.

  • In some cases, ggplot2 now produces a warning or an error for code that previously
    produced plot output. In all these cases, the previous plot output was accidental,
    and the plotting code uses the ggplot2 API in a way that would lead to undefined
    behavior. Examples include a missing group aesthetic in geom_boxplot() (#3316),
    annotations across multiple facets (#3305), and not using aesthetic mappings when
    drawing ribbons with geom_ribbon() (#3318).

New features

  • This release includes a range of internal changes that speeds up plot
    generation. None of the changes are user facing and will not break any code,
    but in general ggplot2 should feel much faster. The changes includes, but are
    not limited to:

    • Caching ascent and descent dimensions of text to avoid recalculating it for
      every title.

    • Using a faster data.frame constructor as well as faster indexing into
      data.frames

    • Removing the plyr dependency, replacing plyr functions with faster
      equivalents.

  • geom_polygon() can now draw polygons with holes using the new subgroup
    aesthetic. This functionality requires R 3.6.0 (@thomasp85, #3128)

  • Aesthetic mappings now accept functions that return NULL (@yutannihilation,
    #2997).

  • stat_function() now accepts rlang/purrr style anonymous functions for the
    fun parameter (@dkahle, #3159).

  • geom_rug() gains an "outside" option to allow for moving the rug tassels to
    outside the plot area (@njtierney, #3085) and a length option to allow for
    changing the length of the rug lines (@daniel-wells, #3109).

  • All geoms now take a key_glyph paramter that allows users to customize
    how legend keys are drawn (@clauswilke, #3145). In addition, a new key glyph
    timeseries is provided to draw nice legends for time series
    (@mitchelloharawild, #3145).

Extensions

  • Layers now have a new member function setup_layer() which is called at the
    very beginning of the plot building process and which has access to the
    original input data and the plot object being built. This function allows the
    creation of custom layers that autogenerate aesthetic mappings based on the
    input data or that filter the input data in some form. For the time being, this
    feature is not exported, but it has enabled the development of a new layer type,
    layer_sf() (see next item). Other special-purpose layer types may be added
    in the future (@clauswilke, #2872).

  • A new layer type layer_sf() can auto-detect and auto-map sf geometry
    columns in the data. It should be used by extension developers who are writing
    new sf-based geoms or stats (@clauswilke, #3232).

  • x0 and y0 are now recognized positional aesthetics so they will get scaled
    if used in extension geoms and stats (@thomasp85, #3168)

  • Continuous scale limits now accept functions which accept the default
    limits and return adjusted limits. This makes it possible to write
    a function that e.g. ensures the limits are always a multiple of 100,
    regardless of the data (@econandrew, #2307).

Minor improvements and bug fixes

  • cut_width() now accepts ... to pass further arguments to base::cut.default()
    like cut_number() and cut_interval() already did (@cderv, #3055)

  • coord_map() now can have axes on the top and right (@karawoo, #3042).

  • coord_polar() now correctly rescales the secondary axis (@linzi-sg, #3278)

  • coord_sf(), coord_map(), and coord_polar() now squash -Inf and Inf
    into the min and max of the plot (@yutannihilation, #2972).

  • coord_sf() graticule lines are now drawn in the same thickness as panel grid
    lines in coord_cartesian(), and seting panel grid lines to element_blank()
    now also works in coord_sf()
    (@clauswilke, #2991, #2525).

  • economics data has been regenerated. This leads to some changes in the
    values of all columns (especially in psavert), but more importantly, strips
    the grouping attributes from economics_long.

  • element_line() now fills closed arrows (@yutannihilation, #2924).

  • Facet strips on the left side of plots now have clipping turned on, preventing
    text from running out of the strip and borders from looking thicker than for
    other strips (@karawoo, #2772 and #3061).

  • ggplot2 now works in Turkish locale (@yutannihilation, #3011).

  • Clearer error messages for inappropriate aesthetics (@clairemcwhite, #3060).

  • ggplot2 no longer attaches any external packages when using functions that
    depend on packages that are suggested but not imported by ggplot2. The
    affected functions include geom_hex(), stat_binhex(),
    stat_summary_hex(), geom_quantile(), stat_quantile(), and map_data()
    (@clauswilke, #3126).

  • geom_area() and geom_ribbon() now sort the data along the x-axis in the
    setup_data() method rather than as part of draw_group() (@thomasp85,
    #3023)

  • geom_hline(), geom_vline(), and geom_abline() now throw a warning if the
    user supplies both an xintercept, yintercept, or slope value and a
    mapping (@RichardJActon, #2950).

  • geom_rug() now works with coord_flip() (@has2k1, #2987).

  • geom_violin() no longer throws an error when quantile lines fall outside
    the violin polygon (@thomasp85, #3254).

  • guide_legend() and guide_colorbar() now use appropriate spacing between legend
    key glyphs and legend text even if the legend title is missing (@clauswilke, #2943).

  • Default labels are now generated more consistently; e.g., symbols no longer
    get backticks, and long expressions are abbreviated with ...
    (@yutannihilation, #2981).

  • All-Inf layers are now ignored for picking the scale (@yutannihilation,
    #3184).

  • Diverging Brewer colour palette now use the correct mid-point colour
    (@dariyasydykova, #3072).

  • scale_color_continuous() now points to scale_colour_continuous() so that
    it will handle type = "viridis" as the documentation states (@hlendway,
    #3079).

  • scale_shape_identity() now works correctly with guide = "legend"
    (@malcolmbarrett, #3029)

  • scale_continuous will now draw axis line even if the length of breaks is 0
    (@thomasp85, #3257)

  • stat_bin() will now error when the number of bins exceeds 1e6 to avoid
    accidentally freezing the user session (@thomasp85).

  • sec_axis() now places ticks accurately when using nonlinear transformations (@dpseidel, #2978).

  • facet_wrap() and facet_grid() now automatically remove NULL from facet
    specs, and accept empty specs (@yutannihilation, #3070, #2986).

  • stat_bin() now handles data with only one unique value (@yutannihilation
    #3047).

  • sec_axis() now accepts functions as well as formulas (@yutannihilation, #3031).

  • New theme elements allowing different ticks lengths for each axis. For instance,
    this can be used to have inwards ticks on the x-axis (axis.ticks.length.x) and
    outwards ticks on the y-axis (axis.ticks.length.y) (@pank, #2935).

  • The arguments of Stat*$compute_layer() and Position*$compute_layer() are
    now renamed to always match the ones of Stat$compute_layer() and
    Position$compute_layer() (@yutannihilation, #3202).

  • geom_*() and stat_*() now accepts purrr-style lambda notation
    (@yutannihilation, #3138).

  • geom_tile() and geom_rect() now draw rectangles without notches at the
    corners. The style of the corner can be controlled by linejoin parameters
    (@yutannihilation, #3050).

Compare
Choose a tag to compare

This is a minor release with internal code changes to support the coming changes in the grid unit specification. This release includes no new features and no breaking changes

Compare
Choose a tag to compare

ggplot2 3.1.0

Breaking changes

This is a minor release and breaking changes have been kept to a minimum. End users of ggplot2 are unlikely to encounter any issues. However, there are a few items that developers of ggplot2 extensions should be aware of. For additional details, see also the discussion accompanying issue #2890.

  • In non-user-facing internal code (specifically in the aes() function and in
    the aesthetics argument of scale functions), ggplot2 now always uses the British
    spelling for aesthetics containing the word "colour". When users specify a "color"
    aesthetic it is automatically renamed to "colour". This renaming is also applied
    to non-standard aesthetics that contain the word "color". For example, "point_color"
    is renamed to "point_colour". This convention makes it easier to support both
    British and American spelling for novel, non-standard aesthetics, but it may require
    some adjustment for packages that have previously introduced non-standard color
    aesthetics using American spelling. A new function standardise_aes_names() is
    provided in case extension writers need to perform this renaming in their own code
    (@clauswilke, #2649).

  • Functions that generate other functions (closures) now force the arguments that are
    used from the generated functions, to avoid hard-to-catch errors. This may affect
    some users of manual scales (such as scale_colour_manual(), scale_fill_manual(),
    etc.) who depend on incorrect behavior (@krlmlr, #2807).

  • Coord objects now have a function backtransform_range() that returns the
    panel range in data coordinates. This change may affect developers of custom coords,
    who now should implement this function. It may also affect developers of custom
    geoms that use the range() function. In some applications, backtransform_range()
    may be more appropriate (@clauswilke, #2821).

New features

  • coord_sf() has much improved customization of axis tick labels. Labels can now
    be set manually, and there are two new parameters, label_graticule and
    label_axes, that can be used to specify which graticules to label on which side
    of the plot (@clauswilke, #2846, #2857, #2881).

  • Two new geoms geom_sf_label() and geom_sf_text() can draw labels and text
    on sf objects. Under the hood, a new stat_sf_coordinates() calculates the
    x and y coordinates from the coordinates of the sf geometries. You can customize
    the calculation method via fun.geometry argument (@yutannihilation, #2761).

Minor improvements and fixes

  • benchplot() now uses tidy evaluation (@dpseidel, #2699).

  • The error message in compute_aesthetics() now only provides the names of
    aesthetics with mismatched lengths, rather than all aesthetics (@karawoo,
    #2853).

  • For faceted plots, data is no longer internally reordered. This makes it
    safer to feed data columns into aes() or into parameters of geoms or
    stats. However, doing so remains discouraged (@clauswilke, #2694).

  • coord_sf() now also understands the clip argument, just like the other
    coords (@clauswilke, #2938).

  • fortify() now displays a more informative error message for
    grouped_df() objects when dplyr is not installed (@jimhester, #2822).

  • All geom_*() now display an informative error message when required
    aesthetics are missing (@dpseidel, #2637 and #2706).

  • geom_boxplot() now understands the width parameter even when used with
    a non-standard stat, such as stat_identity() (@clauswilke, #2893).

  • geom_hex() now understands the size and linetype aesthetics
    (@mikmart, #2488).

  • geom_hline(), geom_vline(), and geom_abline() now work properly
    with coord_trans() (@clauswilke, #2149, #2812).

  • geom_text(..., parse = TRUE) now correctly renders the expected number of
    items instead of silently dropping items that are empty expressions, e.g.
    the empty string "". If an expression spans multiple lines, we take just
    the first line and drop the rest. This same issue is also fixed for
    geom_label() and the axis labels for geom_sf() (@slowkow, #2867).

  • geom_sf() now respects lineend, linejoin, and linemitre parameters
    for lines and polygons (@alistaire47, #2826).

  • ggsave() now exits without creating a new graphics device if previously
    none was open (@clauswilke, #2363).

  • labs() now has named arguments title, subtitle, caption, and tag.
    Also, labs() now accepts tidyeval (@yutannihilation, #2669).

  • position_nudge() is now more robust and nudges only in the direction
    requested. This enables, for example, the horizontal nudging of boxplots
    (@clauswilke, #2733).

  • sec_axis() and dup_axis() now return appropriate breaks for the secondary
    axis when applied to log transformed scales (@dpseidel, #2729).

  • sec_axis() now works as expected when used in combination with tidy eval
    (@dpseidel, #2788).

  • scale_*_date(), scale_*_time() and scale_*_datetime() can now display
    a secondary axis that is a one-to-one transformation of the primary axis,
    implemented using the sec.axis argument to the scale constructor
    (@dpseidel, #2244).

  • stat_contour(), stat_density2d(), stat_bin2d(), stat_binhex()
    now calculate normalized statistics including nlevel, ndensity, and
    ncount. Also, stat_density() now includes the calculated statistic
    nlevel, an alias for scaled, to better match the syntax of stat_bin()
    (@bjreisman, #2679).