biscale implements a set of functions for bivariate thematic mapping based on the tutorial written by Timo Grossenbacher and Angelo Zehr as well as a set of bivariate mapping palettes, including Joshua Stevens’ classic color schemes. In addition to support for two-by-two, three-by-three, and four-by-four maps, the package also supports a range of methods for calculating breaks for bivariate maps.
bi_class()now accepts factors for one or both of the
yvariables, allowing more flexibility for how breaks are calculated. If you want finer grained control over your categories, calculate them ahead of time and then pass the factors on to
bi_scale_color()functions all support four-by-four bivariate maps when
dim = 4. Note that the original five palettes do not support four-by-four mapping, but very close approximations (e.g.
DkBlue) are now provided in their place. The legacy palettes are all still included in the package.
palarguments in the
bi_scale_color()functions. All of these functions will validate your input to ensure that it maps correctly.
bi_class()can be used to calculate bivariate breaks for maps larger than four-by-four, though it will return a warning reminding you that these maps are hard to read and that
biscaledoes not provide palettes for larger maps. Instead, you should provide a custom palette.
bi_class_breaks()can be used with
bi_legend()to facilitate optionally adding break values to your legends. Like
bi_class(), this new function accepts both continuous and pre-made factors.
Rversion 3.4 is no longer supported - please use at least
bi_class()now accepts factors as well. Users that relied on the default behavior of
bi_class()will now receive an error asking you to specify a
stylefor calculating breaks.
bi_pal_manual()now returns a warning that it has been deprecated and will be removed in a later release of
biscale(planned for the end of 2022). Please update your workflows to use the new approach to generating custom palettes.
sfis now a suggested package instead of an imported package, and several dependencies have been removed in the process of re-factoring all of the code in
These require the development version to be installed using
remotes::install_github(), described in the next section.
The easiest way to get
biscale is to install it from CRAN:
Alternatively, the development version of
biscale can be accessed from GitHub with
# install.packages("remotes") remotes::install_github("chris-prener/biscale")
Additional details, including some tips for installing suggested dependencies, can be found in the Get started article.
In addition to instructions for installation, the main Get started article has:
There are also additional vignettes included that give an overview of palettes included in the package and working with custom palettes as well as additional advanced options for creating breaks and legends.