Skip to content

EmilHvitfeldt/paletteer

Repository files navigation

paletteer

R-CMD-check CRAN status CRAN_Download_Badge Codecov test coverage Lifecycle: stable

The goal of paletteer is to be a comprehensive collection of color palettes in R using a common interface. Think of it as the “caret of palettes”.

Notice This version is not backwards compatible with versions <= 0.2.1. Please refer to the end of the readme for breaking changes

Installation

You can install the released version of paletteer from CRAN with:

install.packages("paletteer")

If you want the development version instead then install directly from GitHub:

# install.packages("devtools")
devtools::install_github("EmilHvitfeldt/paletteer")

Palettes

The palettes are divided into 2 groups; discrete and continuous. For discrete palette you have the choice between the fixed width palettes and dynamic palettes. Most common of the two are the fixed width palettes which have a set amount of colors which doesn’t change when the number of colors requested vary like the following palettes:

on the other hand we have the dynamic palettes where the colors of the palette depend on the number of colors you need like the green.pal palette from the cartography package:

Lastly we have the continuous palettes which provides as many colors as you need for a smooth transition of color:

This package includes 2759 palettes from 75 different packages and information about these can be found in the following data.frames: palettes_c_names, palettes_d_names and palettes_dynamic_names. Additionally this github repo showcases all the palettes included in the package and more.

Examples

All the palettes can be accessed from the 3 functions paletteer_c(), paletteer_d() and paletteer_dynamic() using the by using the syntax packagename::palettename.

paletteer_c("scico::berlin", n = 10)
#> <colors>
#> #9EB0FFFF #5AA3DAFF #2D7597FF #194155FF #11181DFF #270C01FF #501802FF #8A3F2AFF #C37469FF #FFACACFF
paletteer_d("nord::frost")
#> <colors>
#> #8FBCBBFF #88C0D0FF #81A1C1FF #5E81ACFF
paletteer_dynamic("cartography::green.pal", 5)
#> <colors>
#> #B8D9A9FF #8DBC80FF #5D9D52FF #287A22FF #17692CFF

All of the functions now also support tab completion to easily access the hundreds of choices

ggplot2 scales

Lastly the package also includes scales for ggplot2 using the same standard interface

library(ggplot2)

ggplot(iris, aes(Sepal.Length, Sepal.Width, color = Species)) +
  geom_point() +
  scale_color_paletteer_d("nord::aurora")

Breaking changes

In version <= 0.2.1 a palatte was selected by specifying a package and palette argument like so

paletteer_c(package = "nord", palette = "frost")

After version 0.2.1 palettes are selected using the syntax "packagename::palettename" inside the palette functions.

paletteer_c("nord::frost")

Special thanks

Included packages

paletteer includes palettes from the following packages:

Name Github CRAN
ButterflyColors junqueiragaabi/ButterflyColors - 0.0.0.9000 -
DresdenColor katiesaund/DresdenColor - 0.0.0.9000 -
IslamicArt lambdamoses/IslamicArt - 0.1.0 -
LaCroixColoR johannesbjork/LaCroixColoR - 0.1.0 -
Manu G-Thomson/Manu - 0.0.2 -
MapPalettes disarm-platform/MapPalettes - 0.0.2 -
MetBrewer BlakeRMills/MetBrewer - 0.3.0 0.2.0
MexBrewer paezha/MexBrewer - 0.0.2 -
MoMAColors BlakeRMills/MoMAColors - 0.0.0.9000 -
NatParksPalettes kevinsblake/NatParksPalettes - 0.2.0 0.2.0
NineteenEightyR m-clark/NineteenEightyR - 0.1.0 -
PNWColors jakelawlor/PNWColors - 0.1.0 -
Polychrome - 1.5.1
PrettyCols nrennie/PrettyCols - 1.0.1.9001 1.0.1
RColorBrewer - 1.1.3
RSkittleBrewer alyssafrazee/RSkittleBrewer - 1.1 -
Redmonder - 0.2.0
awtools awhstin/awtools - 0.2.1 -
basetheme karoliskoncevicius/basetheme - 0.1.3 0.1.3
beyonce dill/beyonce - 0.1 -
calecopal an-bui/calecopal - 0.1.0 -
cartography riatelab/cartography - 3.1.5 3.1.4
colRoz jacintak/colRoz - 0.2.2 -
colorBlindness - 0.1.9
colorblindr clauswilke/colorblindr - 0.1.0 -
dichromat - 2.0-0.1
dutchmasters EdwinTh/dutchmasters - 0.1.0 -
feathers shandiya/feathers - 0.0.0.9000 -
fishualize nschiett/fishualize - 0.2.3 0.2.3
futurevisions JoeyStanley/futurevisions - 0.1.1 -
ggpomological gadenbuie/ggpomological - 0.1.2 -
ggprism csdaw/ggprism - 1.0.3.9000 1.0.4
ggsci nanxstats/ggsci - 3.0.0 3.0.0
ggthemes jrnold/ggthemes - 4.2.4 5.0.0
ggthemr Mikata-Project/ggthemr - 1.1.0 -
ghibli ewenme/ghibli - 0.3.3.9000 0.3.3
grDevices - 4.3.1
harrypotter aljrico/harrypotter - 2.1.1 2.1.1
impressionist.colors - 1.0
jcolors jaredhuling/jcolors - 0.0.5 -
khroma tesselle/khroma - 1.12.0.9000 1.12.0
lisa tyluRp/lisa - 0.1.2.9000 0.1.2
ltc loukesio/ltc_palettes - 0.2.0 -
miscpalettes EmilHvitfeldt/miscpalettes - 0.0.0.9000 -
musculusColors dawnbarlow/musculusColors - 0.1.0 -
nationalparkcolors katiejolly/nationalparkcolors - 0.1.0 -
nbapalettes murrayjw/nbapalettes - 0.1.0.9000 0.1.0
nord jkaupp/nord - 1.0.0 1.0.0
ochRe hollylkirk/ochRe - 1.0.0 -
oompaBase - 3.2.9
palettesForR frareb/palettesForR - 0.1.2 0.1.2
palettetown timcdlucas/palettetown - 0.1.1.90000 0.1.1
palr AustralianAntarcticDivision/palr - 0.4.0 0.4.0
pals kwstat/pals - 1.9 1.8
peRReo jbgb13/peRReo - 0.1.0 -
popthemes johnmackintosh/popthemes - 0.0.0.9000 -
rcartocolor Nowosad/rcartocolor - 2.1.1 2.1.1
rockthemes johnmackintosh/rockthemes - 0.0.0.9000 -
rtist tomasokal/rtist - 1.0.0 1.0.0
scico thomasp85/scico - 1.5.0.9000 1.5.0
severance ivelasq/severance - 0.0.0.9000 -
soilpalettes kaizadp/soilpalettes - 0.1.0 -
suffrager alburezg/suffrager - 0.1.0 -
tayloRswift asteves/tayloRswift - 0.1.0 -
tidyquant business-science/tidyquant - 1.0.7.9000 1.0.7
trekcolors leonawicz/trekcolors - 0.1.3 0.1.3
tvthemes Ryo-N7/tvthemes - 1.3.2 1.3.2
unikn hneth/unikn - 0.9.0.9008 0.9.0
vangogh cherylisabella/vangogh - 0.1.1 0.1.1
vapeplot seasmith/vapeplot - 0.1.0 -
vapoRwave moldach/vapoRwave - 0.3.0 -
viridis sjmgarnier/viridis - 0.6.4 0.6.4
visibly m-clark/visibly - 0.2.9 -
waRhol alexskeels/waRhol - 0.1.0 -
werpals sciencificity/werpals - 0.1.0 -
wesanderson karthik/wesanderson - 0.3.7 0.3.7
yarrr ndphillips/yarrr - 0.1.6 NA