Changelog
Source:NEWS.md
gggda 0.1.1
This patch fixes a bug in the peel stat and adds unit tests for it and the scale stat.
To resolve outstanding CRAN checks, a cross-reference to {ordr} has been replaced with a URL and {dplyr} and {tidyr} functions previously called using the double-colon operator have been imported instead.
gggda 0.1.0
CRAN release: 2025-07-09
The inaugural version of {gggda} was spun off the post-v0.1.1 development version of {ordr}. Upgrades to {ordr} components since that release that are included in {gggda} are listed here.
new coordinate systems
GDA-geared coordinate systems
Two new coordinate systems provide control over the aspect ratio of the plotting window without compromising that of the (artificial) coordinate axes: GeomRect (alias GeomSquare) extends GeomFixed with an window_ratio parameter for the plotting window, while GeomBiplot removes the ratio parameter and forces the coordinate axes to have aspect ratio 1.
up( or down)grades to existing plot layers
combined vector and radiating text geom (breaking change)
The ‘vector’ and ‘text_radiate’ geoms have been combined. The shortcut geom_text_radiate() is deprecated, and geom_vector() generates radiating labels by default.
debugged axis geom
The ‘axis’ and ‘isoline’ geoms hit trouble when one or more points lay at the origin (x^2 + y^2 == 0). These cases have now been removed in setup_data().
reconciliation of summary functions
The ‘center’ and ‘star’ stats now follow the ‘summary’ stat convention of using fun, so fun.center is deprecated. Additionally, fun.ord accepts a function that summarizes the columns of a matrix, which accommodates summaries like the depth median that do not decompose along orthogonal axes.
revamped handling of secondary aesthetics (breaking change)
Previously, underscore-separated parameters like label_colour were used to specify secondary aesthetics, i.e. aesthetics for graphical objects other than those considered “primary” for the layer. Their behavior has been debugged by mimicking the use of period-separated parameters like label.colour in {ggplot2} v3.5.1, except for the new bagplot geom, for which their behavior is based on that of geom_boxplot() in the current development version of {ggplot2}. This induces some breaking changes due to the renaming of most, and the removal of some, such parameters.
new plot layers
referential stats
A new statistical transformation serves to parent specific “referential stats”, meaning those that depend on non-inherited (in this setting, positional) data to transform the inherited data. The reference data are passed to the new referent parameter. The new stat is coupled with an additional LayerRef class that enables ggplot_add() to pass the inherited positional aesthetics to $setup_params(). Biplot-specific stat_*_*() shortcuts accept additional argument types to referent that result in the opposite matrix factor being used as reference data.
rule stat
A new ‘rule’ statistical transformation computes additional position aesthetics that the ‘axis’ geom uses to limit and offset axes. The stat is referential and expects a set of functions that compute limits lower and upper along the axes and yintercept and xintercept associated with offset axes. The ‘axis’ geom preprocesses these aesthetics to rule endpoints xmin,ymin,xmax,ymax and offset vectors xend,yend to force the plotting window to contain the limited axis segments or, if the axes remain lines, the offsets where they are centered.
peel stat
A new ‘peel’ statistical transformation computes nested convex hulls containing specified fractions of data.
depth stat
A new ‘depth’ statistical transformation estimates depth across a grid and is paired with GeomContour to produce depth contours, which can be used to plot alpha bags.
adapted density stat & geom
Aided by element standardization, the classic density_2d statistical transformation and geometric construction are adapted to biplots. Currently, source code generation does not respect fixed parameters passed to layer() by the stat_*() and geom_*() shortcuts; as a consequence, contour = TRUE must be manually passed to geom_*_density_2d().