# ggalluvial 0.12.4 Unreleased

## Curve constructors

Various curve constructors for alluvia and flows are consolidated into data_to_alluvium() and positions_to_flow(), which are now exported to the user as well as used internally by GeomAlluvium$draw_group and GeomFlow$draw_panel, respectively.

## Error handling

Rather than throw an error when y values are NA, the stat layers now follow ggplot2 convention, using remove_missing() at the setup step with the na.rm parameter passed to each layer.

## Aesthetic defaults

To address #78 and for clarity, the legacy default colour = 0 of three Geom*()s is changed to colour = "transparent".

## Vignette revisions

The primary vignette now uses the HairEyeColor data set, rather than over-using Titanic, to illustrate the parallel sets plot.

The Shiny vignette includes an embedded app using IFrame.

The deprecated .dots argument of dplyr::group_by() has been replaced with dplyr::across(), preventing a warning.

# ggalluvial 0.12.3 2020-12-05

## Shiny vignette

A new vignette by Quentin D. Read shows how to build interactive Shiny apps with tooltips sensitive to the locations of graphical elements. This is especially important for the spline boundaries of flows and alluvia.

## Examples using vaccinations data

Corrections have been made to erroneous legacy code, found in one example and two vignettes, to reorder the factor levels of the "response" field in the data set vaccinations. The documentation is updated accordingly.

Also, an explanation of the (misleading) column names of this data set has been added to the main vignette.

# ggalluvial 0.12.2 2020-08-30

This patch addresses a bug introduced in v0.12.0 that had is_lodes_form() return an error when a data frame contains duplicate id-axis pairings, which may be appropriate for producing faceted plots. The new site parameter can be passed one or more grouping variables for this purpose, and internally it is passed "PANEL" to prevent this error from being thrown.

# ggalluvial 0.12.1 2020-08-10

## Custom lode guidance functions

The lode.guidance argument of stat_alluvial() now accepts functions as input, making the use of custom functions easier as demonstrated in an example.

# ggalluvial 0.9.2 Unreleased

## Height limits on strata

Parameters min.height and max.height are introduced to stat_stratum() to allow users to omit strata outside a given height range. This is probably most relevant for stratum labeling, as illustrated in the updated vignette.

# ggalluvial 0.9.1 2018-10-21

## Suggest sessioninfo for session_info()

Because the only functional (e.g. out README.md) occurrence of devtools is to call session_info() at the ends of the vignettes, this suggestion and usage are switched to sessioninfo.

## markdown formatting

Documentation is slightly reformatted due to switching roxygen syntax to markdown.

## z-ordering patch

The internal z-ordering function z_order_aes failed to recognize contiguous segments of alluvia, thereby assigning later segments missing values of 'group' and preventing them from being rendered. This has been corrected.

# ggalluvial 0.9.0 2018-07-06

## geom_alluvium() patch

An occurrence of weight in geom_alluvium() was not updated for v0.8.0 and caused geom_alluvium() to throw an error in some cases. This has been corrected.

An earlier solution to the z-ordering problem sufficed for matched layers (*_alluvium() and *_flow()) but failed for the combination of stat_alluvium() with geom_flow(). This is been corrected in the code for GeomFlow$draw_panel(), though a more elegant and general solution is preferred. ## Deprecated parameters removed The deprecated parameters axis_width (all geom layers) and ribbon_bend (geom_alluvium() and geom_flow()) are removed and an explanatory note added to the layers’ documentation. ## Vignette on labeling small strata A vignette illustrating two methods for labeling small strata, using other ggplot2 extensions, is included. ## self_adjoin() export The internal function self_adjoin(), invoked by geom_flow(), is revised, exported, documented, and exemplified. # ggalluvial 0.8.0 Unreleased ## Stat layer functionality • The weight aesthetic for the three stat_*() functions is replaced by the y aesthetic, so that scale_y_continuous() will correctly transform the vertical scales of the layers. An example is provided in the documentation for stat_alluvium(). The y aesthetic must be present in order for scales to be correctly transformed. The weight parameter is still available but deprecated. • For consistency with the switch from weight to y, the aggregate.wts parameter to stat_alluvium() is replaced with aggregate.y; aggregate.wts is deprecated. ## Alluvial data functionality • Tests for alluvial format are silenced inside the stat_*() functions. # ggalluvial 0.7.0 Unreleased ## Alluvial data functionality These changes make the functions that test for and convert between alluvial formats behave more like popular functions in the tidyverse. Some of the changes introduce backward incompatibilities, but most result in deprecation warnings. • The functions is_alluvial_*() and to_*() are renamed to is_*_form() and to_*_form() for consistency. Their old names are deprecated. • is_alluvial() is deprecated and will be removed in a future version. • The parameter logical is deprecated. In a future version, the functions is_*_form() will only return logical values. • The setting silent = TRUE now silences all messages. • The functions is_*_form() now return FALSE if any weights are negative, with a message to this effect. • These functions now accept unquoted variable names for the key, value, id, weight, and diffuse parameters, using up-to-date rlang and tidyselect functionality. • The axes parameter in is_alluvia_form() and to_lodes_form() now accepts dplyr::vars() objects, as in dplyr::select_at(). Alternatively, variables can be fed to these functions as in dplyr::select(), to be collected by rlang::quos(...) and used as axis variables. If axes is not NULL, then such additional arguments are ignored. • The functions to_*_form() now merge their internal reshapen data frames with the distilled or diffused variables in a consistent order, placing the distilled or diffused variables to the left. # ggalluvial 0.6.0 2018-02-04 ## CRAN checks for v0.5.0 • The package now Depends on R v3.3.0 (patch number zero) instead of v3.3.1. I’ve been unable to install this version locally, so there is a slight chance of incompatibility that i’ll be watchful for going forward. • The grid and alluvial packages are now Suggests rather than Imports. ## Alluvial data functionality • Source files and documentation for is_alluvial_*() and to_*() functions are combined; see help("alluvial-data"). • is_alluvial_alluvia now prints a message rather than a warning when some combinations of strata are not linked by any alluvia. • to_lodes() now has a diffuse parameter to join any original variables to the reformatted data by the id variable (alluvium). This makes it possible to assign original variables to aesthetics after reformatting, as illustrated in a new example. • to_alluvia() now has a distill parameter to control the inclusion of any original variables that vary within values of id into the reformatted data, based on a distilling function that returns a single value from a vector. • to_lodes() now has a logical discern parameter that uses make.unique() to make stratum values that appear at different axes distinct. The stat_*() functions can pass the same parameter internally and print a warning if the data is already in lodes form. ## Layer internals • GeomFlow$draw_panel() now begins by restricting to complete.cases(), corresponding to flows with both starting and terminating axes. (This is not done in StatFlow$compute_panel(), which would have the effect of excluding missing aesthetic values from legends.) • GeomAlluvium$setup_data() now throws a warning if some color or differentiation aesthetics vary within alluvia.
• A bug in the processing of a custom lode.ordering argument by StatAlluvium\$compute_panel() has been fixed.

# ggalluvial 0.5.0 2017-11-26

## Backward incompatibilities

The ggalluvial() shortcut function, which included a formula interface, deprecated in version 0.4.0, is removed.