bi_scale_color: Apply Bivariate Color to ggplot Object

In biscale: Tools and Palettes for Bivariate Thematic Mapping

Apply Bivariate Color to ggplot Object

Description

Applies the selected palette as the color aesthetic when geom_sf is used and the bi_class variable is given as the color in the aesthetic mapping.

Usage

bi_scale_color(pal, dim = 3, flip_axes = FALSE, rotate_pal = FALSE, ...)

Arguments

pal	A palette name or a vector containing a custom palette. See the help file for bi_pal for complete list of built-in palette names. If you are providing a custom palette, it must follow the formatting described in the 'Advanced Options' vignette.
dim	The dimensions of the palette. To use the built-in palettes, this value must be either 2, 3, or 4. A value of 3, for example, would be used to create a three-by-three bivariate map with a total of 9 classes. If you are using a custom palette, this value may be larger (though these maps can be very hard to interpret). See the 'Advanced Options' vignette for details on the relationship between dim values and palette size.
flip_axes	A logical scalar; if TRUE the axes of the palette will be flipped. If FALSE (default), the palette will be displayed on its original axes. Custom palettes with 'dim' greater than 4 cannot take advantage of flipping axes.
rotate_pal	A logical scalar; if TRUE the palette will be rotated 180 degrees. If FALSE (default), the palette will be displayed in its original orientation. Custom palettes with 'dim' greater than 4 cannot take advantage of palette rotation.
...	Arguments to pass to scale_color_manual

Value

A ggplot object with the given bivariate palette applied to the data.

See Also

bi_pal

Examples

# load dependencies
library(ggplot2)

# add breaks, 3x3
data <- bi_class(stl_race_income, x = pctWhite, y = medInc, style = "quantile", dim = 3)

# create map
plot <- ggplot() +
  geom_sf(data = data, aes(color = bi_class), size = 2, show.legend = FALSE) +
  bi_scale_color(pal = "GrPink", dim = 3)

biscale documentation built on Sept. 1, 2025, 9:07 a.m.