What's new in {PrettyCols} 1.1.0?

{PrettyCols} is an R package containing aesthetically pleasing colour palettes that are compatible with {ggplot2}. Find out about new features and palettes contained in the latest release!

June 20, 2024

Back in September 2022 I submitted {PrettyCols}, an R package containing aesthetically pleasing colour palettes, to CRAN. If you missed it, you can read the blog post introducing the package!

Over a year after the last CRAN release, it was time for an update and this blog post will give you a brief overview of some of the new features and palettes! You can install {PrettyCols} using:

1
install.packages("PrettyCols")

You can also install the development version from GitHub using:

1
remotes::install_github("nrennie/PrettyCols")

The load into R with:

1
library(PrettyCols)

Breaking changes

Previous versions of {PrettyCols} used the name argument in all of the {ggplot2} scale functions to define the name of the palette you wanted to use. Unfortunately, {ggplot2} uses name to define the name of the legend. This meant there was an inconsistency between {PrettyCols} and other {ggplot2} scale functions, and I wanted to fix that in this release. Now, the behaviour is more consistent.

  • Change: the palette argument is now used to define the name of the colour palette you want to use.
1
2
3
4
5
6
7
library(ggplot2)
ggplot(
  data = mtcars,
  mapping = aes(x = cyl, fill = as.factor(gear))
) +
  geom_bar() +
  scale_fill_pretty_d(palette = "Peppers")

Scatterplot of mtcars data with mpg vs disp and points coloured by wt

For example, if you have previously scale_fill_manual(name = "Bright") to say you want to use the "Bright" palette, this will result in an error. Please use scale_fill_manual(palette = "Bright") instead. If you didn’t explicitly name the argument for the palette name, your code should still work.

Changing the legend name

To get around the problem above, earlier versions of {PrettyCols} added a legend_title argument to the scale_*_pretty_*() functions. The legend_title argument still works, but you will get a deprecation warning. To maintain consistency with other {ggplot2} scale functions, you should use name instead.

  • Change: the name argument sets the legend (scale) name.
1
2
3
4
5
6
ggplot(
  data = mtcars,
  mapping = aes(x = mpg, y = disp, colour = wt)
) +
  geom_point(size = 5) +
  scale_colour_pretty_c("Roses", name = "New Title")

Scatterplot of mtcars data with mpg vs disp and points coloured by wt

Diverging scales

There were several diverging palettes already within {PrettyCols}, and in version 1.1.0 you can now use the palettes with diverging scales in {ggplot2} more easily.

1
2
3
4
5
6
7
8
9
ggplot(
  data = mtcars,
  mapping = aes(x = mpg, y = disp, fill = wt)
) +
  geom_point(size = 5, pch = 21) +
  scale_fill_pretty_div(
    palette = "PurpleYellows",
    midpoint = mean(mtcars$wt)
  )

Scatterplot of mtcars data with mpg vs disp and points coloured by wt

The following diverging scales functions now exist:

  • scale_colour_pretty_div() and scale_color_pretty_div()
  • scale_fill_pretty_div()

They work similarly to scale_*_gradient2().

More palettes!

The new release contains eight additional palettes, taking the total up to 40 palettes! You can see the complete list of available palettes by running view_all_palettes() or browsing the package vignette on available palettes.

Python support

A Python implementation of {PrettyCols} existed in previous releases, but Python support has now moved to a separate GitHub repository. See github.com/nrennie/PrettyPyCols.*

To end this post, here’s another couple of examples of these palettes being used for generative art!

Generative art piece composed of subdivided squares on a 6x6 grid.

Generative art piece composed of a 20x20 grid of coloured squares.

Show code
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
aRt::split_grid(
  col_palette = prettycols("Coast"),
  grid_col = prettycols("Coast")[3],
  n_x = 6,
  n_y = 6
)
              
aRt::window_boxes(
  col_palette = prettycols("Disco"),
  n_x = 20,
  n_y = 20
)

If you find that something in {PrettyCols} isn’t working, or if you’ve got an idea for more features, please raise a GitHub issue!


For attribution, please cite this work as:

What's new in {PrettyCols} 1.1.0?.
Nicola Rennie. June 20, 2024.
nrennie.rbind.io/blog/prettycols/prettycols-1-1-0
BibLaTeX Citation
@online{rennie2024,
  author = {Nicola Rennie},
  title = {What's new in {PrettyCols} 1.1.0?},
  date = {2024-06-20},
  url = {https://nrennie.rbind.io/blog/prettycols/prettycols-1-1-0}
}

Licence: creativecommons.org/licenses/by/4.0