ordr

scaffold theme

The 'biplot' theme has been renamed 'scaffold', with an alias for backward compatibility.

standardized and restrictive elements parameter (breaking change)

The elements parameter is now standardized across all statistical transformations (through the code generation process) and accepts more restrictive options:

The value is argument-matched to "active", "score", or "structure"; these options may expand as additional supplementary elements are introduced.

Moreover, the former default "all" is no longer accepted, which forecloses the trick of passing the element type to an aesthetic, e.g. size = .element == "active", as had been used in several examples.

up( or down)grades to existing plot layers

Most statistical transformations and geometric constructions have been migrated to **gggda**.

The changes below were made prior to this migration and have the same effects since **gggda** is now an imported dependency.

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 (retained in **ordr**)

addition geom

A new 'interpolation' geometric element layer renders either of two methods of vector addition to interpolate the position---on the existing ordination and its biplot---of a new row or column of the original data matrix.

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.

projection stat

The 'projection' referential stat prepares segment endpoints between x,y positions and their projections on axes defined by the reference data. It is a natural graphical element for predictive biplots of ordination models of continuous data.

new plot layers (migrated to **gggda**)

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().