ggthemes now requires ggplot2 4.0.0 or later, for its theme palettes and geom defaults (#287).
Themes now set their own palettes as the defaults for discrete scales, so
p + theme_economist() draws in the Economist's colors without
scale_colour_economist(). This changes the colors of plots that used one
of these themes without a matching scale. theme_calc(), theme_economist(),
theme_economist_white(), theme_excel(), theme_excel_new(),
theme_few(), theme_fivethirtyeight(), theme_gdocs(), theme_hc(),
theme_numbers(), theme_pander(), theme_selenized(),
theme_solarized(), theme_solarized_2(), theme_stata() and
theme_wsj() set color and fill; theme_calc(), theme_few() and
theme_stata() also set shape, and theme_stata() sets linetype. A scale
added to the plot still wins, so add scale_colour_discrete() and
scale_fill_discrete() for ggplot2's default colors. When a plot has more
groups than the theme's palette has values, the theme warns and uses
ggplot2's default palette (#287).
theme_stata(), stata_pal(), scale_colour_stata() and
scale_fill_stata() now default to scheme = "stcolor", Stata's factory
default since Stata 18, instead of "s2color", as announced in 7.0.0. Use
scheme = "s2color" for the previous look. scheme = NULL, the previous
default, now also means "stcolor" (#287).
These deprecated arguments and functions are now defunct and error (#287):
theme_pander(ff) and theme_pander(fs). Deprecated in 2.0.0; use
base_family and base_size instead.theme_hc(bgcolor). Deprecated in 4.2.0; use style instead.circlefill_shape_pal() and scale_shape_circlefill(). Deprecated in
5.0.0; use tableau_shape_pal("proportions", unicode = TRUE) and
scale_shape_tableau(palette = "proportions", unicode = TRUE) instead.theme_base() now defaults to base_size = 12, the default text size of
base graphics, instead of 16, and draws tick labels, strip text, legend text
and captions at full size, as base graphics draws axis labels. Use
base_size = 16 for text close to the previous size (#280).
theme_economist(), theme_economist_white(), economist_pal(),
scale_colour_economist() and scale_fill_economist() draw the classic
Economist style again, as they did before 7.0.0, so code written for them
looks as it always did. 7.0.0 had replaced that style with the paper's 2017
design, so plots made with these functions changed when you updated. In
detail:
theme_economist_white(), the dkpanel argument of theme_economist()
and the fill argument of economist_pal() work again, without the
deprecation warnings 7.0.0 added.ggthemes_data$economist has its classic fg and bg tables back, and
the main and text tables added in 7.0.0 are removed, so code that
reads those two tables must change.economist_seq_pal(), economist_gradient_pal() and the
scale_*_economist_c() and scale_*_economist_ordinal() scales, new in
7.0.0, are unchanged (#266).bank_slopes() and bank_plot() now default to cull = TRUE, matching
bank_slopes_multiscale() and bank_plot_multiscale(), so segments with a
slope of 0 or Inf no longer count toward the aspect ratio. Results change
for data that has such segments; use cull = FALSE for the previous ones
(#274).
cleveland_shape_pal() and scale_shape_cleveland() now use the two
symbol sets of Figure 3.70 in Cleveland's The Elements of Graphing Data
(1985, p. 196). overlap = TRUE, for data where overlap causes problems,
draws an open circle, plus sign, S, triangle and U (five values; it was an
open circle, plus sign, < and S). overlap = FALSE, for little overlap,
draws a solid circle, open circle, circle with a vertical line, heavy ring
and circled dot (it was an open circle, solid circle, circled plus, circled
dot and circled ring). With unicode = FALSE, only the solid and open
circle have a base pch, so overlap = FALSE supports two values (it was
three); unicode = TRUE draws all five, best with the font from
register_shapes_font(). The rows of ggthemes_data$shapes$cleveland
change to match.
scale_colour_tableau(), scale_fill_tableau(),
scale_colour_economist_c(), scale_fill_economist_c() and
scale_shape_tremmel() now take ... right after their first argument, as
ggplot2's scales do. type, direction, guide and alt must be named,
and passing them by position is an error that says so (#275).
The dark variants of theme_solarized(), theme_solarized_2(),
theme_hc() ("darkunica" and "default_dark") and theme_stata()
("s1rcolor") now draw unmapped geoms in their foreground color, so a plain
geom_point() is no longer black on a dark background (#287).
theme_foundation() gains a header_family argument to set the font of
titles separately from base_family (#287).
New theme_selenized(), selenized_pal(), scale_colour_selenized() and
scale_fill_selenized() use Jan Warchoł's Selenized color scheme, a
successor to Solarized with higher contrast. variant chooses its
"light", "dark", "black" or "white" version; each has its own accent
colors, and ggthemes_data$selenized holds them all.
theme_par() also sets the defaults for geoms
from par(): color from col, background from bg, line width and type
from lwd and lty, point shape from pch, and point and text size from
cex and ps. Lines join with par("ljoin"). Discrete scales use the
current palette(), recycled as base graphics does, and continuous scales use
hcl.colors(12, "YlOrRd", rev = TRUE), the default colors of image()
(#281).
New scale_colour_continuous_tableau() and tableau_colour_pal() aliases, so
every exported color function now also has a colour spelling (#269).
New "Package data" article on the package website draws every color, shape
and linetype in ggthemes_data, each labeled with the expression that
returns it, and the ggthemes_data help page gains examples of reading it
(#265).
cleveland_shape_pal() and scale_shape_cleveland() gain an edition
argument. edition = "1994" draws the symbol sets of the revised (second)
edition of Cleveland's The Elements of Graphing Data: an open circle, plus
sign, <, S and W for overlapping data, and an open circle, solid circle,
heavy ring, circle with a vertical line and circled dot for little overlap.
The default, "1985", keeps the first edition's sets.
tableau_shape_pal() and scale_shape_tableau() gain Tableau's "kpi",
"arrows", "thin-arrows", "gender", "weather" and "bug-tracking"
shape palettes. All but "kpi" have fewer than two shapes with a base pch,
so they need unicode = TRUE and give an error saying so without it. In
ggthemes_data$tableau$`shape-palettes` these sets are renamed to the
same lowercase ids (they were "Arrows", "Thin Arrows", "Gender" and
"Bug Tracking").
New geom_point_glyph() draws the shapes of the unicode = TRUE palettes
from the font of register_shapes_font(), reading the font file through
R's glyph API on devices that support it (R 4.3 or later), so no font
family has to be set and the plot works with ggsave(). Other devices draw the shapes as
ordinary points in the registered font family. pdf() files refer to the
font without embedding it; new embed_shapes_font() embeds it.
New register_shapes_font() registers a font that ships with ggthemes and
draws the shapes of the unicode = TRUE palettes (calc_shape_pal(),
cleveland_shape_pal(), stata_shape_pal() and tableau_shape_pal()) at
a common size. In the best system font tested, the shapes of one palette
differed in area by up to a factor of six, and several fonts lacked some of
them. ggthemes registers the font when it loads, if systemfonts is
installed. The missing-glyph warning now points to it, and once
register_shapes_font() or geom_point_glyph() has been called it no
longer warns about shapes the font has.
The shape palettes made with unicode = TRUE now check the device font
when the plot is built rather than when the scale is created, so
geom_point_glyph() silences the missing-glyph warning wherever it appears
in the plot's code.
Calling cleveland_shape_pal() or scale_shape_cleveland() without
unicode is deprecated. unicode still defaults to FALSE, and will
default to TRUE in ggthemes 9.0.0, so that both symbol sets draw all five
shapes.
scale_colour_colorblind() now always warns that it is deprecated; use
scale_colour_colourblind() (#287).
extended_range_breaks_() is deprecated. Use extended_range_breaks():
extended_range_breaks_(dmin, dmax, n) is
extended_range_breaks(n)(c(dmin, dmax)) (#287).
theme_solid()'s base_size and base_family now set the default size and
font of text geoms; they were ignored (#287).
theme_hc() and theme_pander() are now complete themes built on
theme_grey(), like the package's other themes, so the active theme
(theme_set()) no longer leaks into them. Their spacing now scales with
base_size (#287).
geom_tufteboxplot() and stat_fivenumber() now draw horizontal box plots.
A discrete y with a continuous x now summarizes x, as in
geom_boxplot(); before, it summarized the factor codes of y and drew the
plot wrongly without a warning. A new orientation argument sets the
direction when it can't be inferred (#287).
geom_tufteboxplot() legend keys are now point ranges, as intended; they
were drawn as boxes (#287).
geom_rangeframe() now sets line width with the linewidth aesthetic, as
ggplot2's line geoms have since 3.4.0; linewidth was ignored before.
size still works, with a deprecation warning (#287).
Deprecate smart_digits() and smart_digits_format(). Use
scales::label_number() instead. Until they are removed, they round to the
smallest gap between values rather than to the range, so evenly spaced breaks
stay distinct: smart_digits(c(0, 25, 50, 75, 100)) returns
"0" "25" "50" "75" "100", not "0" "0" "0" "100" "100", and
smart_digits(0) returns "0", not NaN.
The theme_solarized() example draws a plot for each accent color again; it
looked the accents up under the wrong name and drew none. ?solarized_pal
now lists the accent names and says the palette has eight colors, not seven.
theme_par() now follows base graphics more closely (#280):
par("las") rotates the tick labels instead of the axis titles, which stay
parallel to their axis.par("adj") sets only the horizontal justification of titles; it no
longer moves all text vertically.par("fg") instead of the plotting colour par("col").font = 5, warns and uses a plain face instead of failing.cex (the default base_size is par("ps") * par("cex")),
lwd, bty, ann, mgp, mex and oma, and sizes margins as base
graphics does, so they are no longer far wider than in a base plot.tck of 0.5 or more draws grid lines, and smaller values set the tick
length from the plot region size.sub parameters also style plot.subtitle and plot.caption.The deprecation warnings for the renamed Tableau palettes "Red-Blue-Brown"
and "Classic Area-Brown" now come from lifecycle, so they name the release
that deprecated them (#273).
bank_plot() and bank_plot_multiscale() now report a plot that is not a
ggplot object, and a layer that is not a whole number within range, with
errors that name the argument (#274).
economist_pal(n = 0) no longer fails with "object 'i' not found"; it now
returns character(0) (#266).
few_pal()'s palette argument now lists its options in the help page, and
the deprecation badges in ?circlefill_shape_pal, ?colorblind and
?scale_shape_circlefill now render instead of showing raw
`r lifecycle::badge()` text (#268).
scale_fill_colorblind() and scale_fill_colourblind() are no longer
deprecated. Only scale_colour_colorblind(), which mixes spellings, remains
deprecated, and its warning now points to scale_colour_colourblind()
instead of wrongly naming scale_color_colorblind() as deprecated (#269).
scale_linetype_stata() and stata_linetype_pal() no longer fail with
"invalid line type" on plots with 11 or more linetypes. The eleventh,
Stata's longdash_shortdash, was stored as "F434343", which is not a valid
R linetype; it is now "F434" (#263).
solarized_pal() and theme_wsj() now give an error that lists the valid
values when accent or color is unknown. Before, solarized_pal() returned
a palette with no colors and theme_wsj() a theme with no background fill
(#272).
stata_linetype_pal() now warns when asked for more than its 11 linetypes
and errors for a negative n, as the other palettes do (#272).
tableau_gradient_pal() now gives an error that lists the valid palettes
when palette is unknown, instead of "subscript out of bounds".
tableau_seq_gradient_pal() and tableau_div_gradient_pal() now say so when
given arguments they ignore (#272).
The Tableau "arrows" and "thin-arrows" shape palettes in
ggthemes_data$tableau$`shape-palettes` held the same eight characters,
so they drew identically. "arrows" now uses solid arrows (U+2B05 to U+2B0B and
U+27A1) and "thin-arrows" line arrows (U+2190 to U+2199) in the same eight
directions. Three other Tableau shapes now carry the variation selector their
unicode field records: the kpi check mark and multiplication sign gain the
text-style selector, and the weather snowman loses a stray one (#264).
theme_economist() now gives the panel and strips the blue-gray fill the
theme intends. It asked for a color the data never defined, so their fill was
NA and the plot background showed through (#266).
theme_economist() now leaves a margin between the title and subtitle, which
ran together (#266).
theme_solarized_2() now colors its axis lines. A typo in the color name left
them unset (#272).
Fix palette_pander() returning a color for n = 0; it now returns
character(0).
The README is reorganized: an overview of what the package provides, a two-column theme gallery linked to the reference pages, a geoms section and current installation instructions. The full color palette gallery moves to a new "Color palettes" article on the package website, drawn as images; the README's HTML swatches rendered as empty cells on GitHub, which strips their colors.
Fix theme_foundation() on ggplot2 >= 4.0.0. It is meant to clear every
color and fill inherited from theme_grey(), but ggplot2 4.0.0's S7 theme
elements hid them from the check, so theme_grey()'s gray panel, gray strips
and white grid lines leaked into every theme built on it. On ggplot2 4.x this
changes the appearance of theme_base(), theme_calc(), theme_clean(),
theme_fivethirtyeight(), theme_foundation(), theme_gdocs(),
theme_numbers(), theme_solarized_2(), theme_solid(), theme_stata()
and theme_wsj() back to their intended look, which ggplot2 3.5.x users
already saw. In particular, theme_solid(fill = ) now fills the panel
rather than only the area around it.
Expand the README theme gallery to cover every non-deprecated exported theme, pairing each with its matching palette where available.
theme_map() places its legend with legend.position = "inside" and
legend.position.inside, instead of the numeric legend.position
deprecated in ggplot2 3.5.0. The legend is drawn in the same place.
geom_tufteboxplot() gains a linewidth aesthetic for its lines, as in
ggplot2::geom_pointrange(); size now sets only point sizes. This removes
the ggplot2 deprecation warnings it emitted on every plot. Setting size
without linewidth still widens the lines too, so existing code draws the
same, and plots drawn with the defaults are unchanged.
stat_fivenumber() declares the aesthetics it drops, so it no longer
warns that y was dropped during the statistical transformation.
Fix solarized_pal() storing the palette function instead of the palette
size in its max_n attribute. Requesting more than eight colors now pads
with NA after the usual warning instead of failing with "subscript out of
bounds", and n = 0 returns character(0).
Fix few_pal() returning two colors for n = 0; it now returns
character(0).
Require ggplot2 >= 3.5.2. bank_plot() and bank_plot_multiscale()
already called ggplot2::is_ggplot(), so older versions failed at run time.
Correct the documented values of type in scale_colour_tableau() and
scale_fill_tableau(): they are "regular", "ordered-sequential" and
"ordered-diverging", not "sequential" and "diverging".
BREAKING CHANGE: theme_excel_new() now matches the chart chrome Excel
actually draws, decoded from the chart XML that Excel writes. Major
gridlines are #D9D9D9 rather than #BFBFBF; axis lines are drawn in
#BFBFBF, where previously there were none; and axis titles are one point
larger than axis labels, as in Excel. Existing plots will change appearance.
theme_excel_new() documents that Excel's font has been Aptos since 2023.
base_family still defaults to "sans", since Aptos is rarely installed
outside Office; pass base_family = "Aptos Narrow" for a closer match.
Add the current Microsoft Office theme, which Microsoft made the default in
2023, as the "Office" Excel theme:
#156082, #E97132, #196B24, #0F9ED5, #A02B93, #4EA72E.
ggthemes_data$excel$themes now has 51 themes.
BREAKING CHANGE: excel_new_pal(), scale_colour_excel_new() and
scale_fill_excel_new() now default to theme = "Office" instead of
"Office Theme", so they again match a default chart in current Excel.
Plots that relied on the default will change appearance. Pass
theme = "Office 2013" to keep the previous colors.
The Excel themes "Office Theme" and "Office 2007-2010" have been renamed
"Office 2013" and "Office 2007", following Microsoft's own renaming of
the built-in themes. The old names still work and select the same colors as
before.
Add bank_slopes_multiscale() and bank_plot_multiscale(), implementing
multi-scale banking to 45 degrees (Heer and Agrawala 2006, section 3).
Single-scale banking considers all of the data at once, so it accentuates
local features and can obscure larger-scale trends. Multi-scale banking uses
spectral analysis to identify the frequency scales that carry real energy,
low-pass filters the data to each scale, and banks the resulting trend
curve, returning one aspect ratio per scale.
bank_slopes_multiscale() returns a tibble of frequencies and ratios;
bank_plot_multiscale() returns one ggplot per scale, reproducing the
small-multiples display used in the paper. On sunspot.year the
implementation selects the same frequency scales the paper reports.
stata_shape_pal() now fails with a message naming the offending
symbolstyles when Stata's shape data does not contain the ten the palette
selects. It previously looked them up with a bare match(), so a renamed or
missing symbolstyle produced an all-NA row that was silently dropped as
"no font-independent equivalent", leaving max_n quietly below the
documented ten. The list of ten now lives in one place and data-raw/build.R
sources it, so the build's duplicate-pch check cannot run over a stale copy.
BREAKING CHANGE: stata_shape_pal(), calc_shape_pal(),
tableau_shape_pal() and cleveland_shape_pal() now return base pch codes
by default instead of pch codes derived from Unicode glyphs. R draws a
negative pch by asking the device font for that codepoint, so these palettes
rendered as blank boxes in a font without coverage — R's default sans
covers one of the eight codepoints they relied on — and aborted outright on
base pdf()/postscript(). Pass unicode = TRUE to restore the previous
values. scale_shape_stata(), scale_shape_calc(), scale_shape_tableau()
and scale_shape_cleveland() gain the same argument.
BREAKING CHANGE: max_n is reduced on the default branch for the palettes
whose source symbols have no font-independent equivalent: calc 13 to 7,
tableau_shape_pal("filled") 10 to 6, tableau_shape_pal("default") 10 to
8, cleveland_shape_pal(overlap = FALSE) 5 to 3 and
tableau_shape_pal("proportions") 5 to 2. Those shapes are dropped rather
than approximated by a different shape. stata_shape_pal() and
few_shape_pal() are unaffected — their symbol sets map exactly.
BREAKING CHANGE: the pch column of the shape tables in ggthemes_data now
holds the font-independent base pch, NA where there is none. The previous
Unicode-derived values move to a new pch_unicode column, and a new shape
column carries the canonical shape name both are derived from.
BREAKING CHANGE: tremmel_shape_pal() returned symbol sets that did not
match Tremmel (1995). n = 2 now returns a solid circle and a plus sign (was
two circles), overlap = TRUE returns an empty circle and a plus sign (was a
square and a plus sign), and alt = TRUE returns a solid circle, plus sign
and empty triangle (was identical to alt = FALSE, making the argument a
no-op).
Fix scale_shape_tremmel() defaulting to alt = TRUE while
tremmel_shape_pal() defaulted to alt = FALSE, so a palette and its own
scale disagreed at n = 3. Both now default to FALSE, the variant
Tremmel's Experiment 1 measured.
Fix cleveland_shape_pal(overlap = TRUE) drawing a W where an S was
intended; the stored row paired the name LATIN CAPITAL LETTER S with
pch 87.
Fix mislabelled and corrupted shape data: LibreOffice's BLACK DOWN-POINTING CHARACTER (now TRIANGLE), Google Docs' star named
MULTIPLICATION X, Excel's em dash declared as U+2013, and Tableau's
CLOUD WITH RAIN, stored as a mojibake sequence rather than U+1F327.
The shape tables are now validated as they are built: a shape name outside
the vocabulary, a character that disagrees with its own unicode, or two
shapes in one palette sharing a pch all fail the build, and the same checks
run as tests against the built data.
warn_unicode_pch()'s locale guess is joined by a real font-coverage check
using systemfonts::glyph_info() when systemfonts is installed, naming the
glyphs the device font cannot draw. systemfonts is used in Suggests. The
locale and coverage checks are independent failure modes and both run: a
UTF-8 session can still meet a font with no glyph, and a font with full
coverage still fails with mbcsToSbcs on a non-UTF-8 session. Note that R
exposes no way to read back a device's family=, so the probe measures the
default font and the warning names the font it actually measured.
Discrete color palettes now reject a negative n with an error naming the
argument and the palette that was called. Palettes built on
scales::manual_pal() --- including calc_pal(), canva_pal(),
colorblind_pal(), excel_pal(), excel_new_pal(),
fivethirtyeight_pal(), gdocs_pal(), hc_pal(), stata_pal() and
wsj_pal() --- previously failed with R's internal
argument must be coercible to non-negative integer from seq_len().
This raises the minimum version of scales to 1.4.0, which is where
scales::new_discrete_palette() was introduced.
bank_slopes() and bank_plot() report an invalid method, and
tableau_shape_pal() an invalid palette, with a message naming the
argument and the value supplied instead of match.arg()'s
'arg' should be one of .... Misspellings now get a "Did you mean" hint.
Deprecate ptol_pal(), scale_colour_ptol(), scale_color_ptol() and
scale_fill_ptol(). Use the
khroma package instead, which
tracks Paul Tol's color schemes as he revises them. The ggthemes palette is
the original 12-color qualitative scheme from Tol's 2012 technical note and
has not followed the revisions on his current site,
https://sronpersonalpages.nl/~pault/; the closest successor is
khroma::colour("muted"). The functions still work, but warn.
BREAKING CHANGE: The Tableau palette "Red-Blue-Brown" has been renamed to
"Blue-Red-Brown", matching both the name Tableau uses and the palette's
actual color order (blue, red, brown). The old name still works but warns.
BREAKING CHANGE: The Tableau palette "Classic Area-Brown" has been renamed
to "Classic Area Brown", for consistency with its siblings
"Classic Area Red" and "Classic Area Green". The old name still works but
warns.
Fix two corrupted colors in the "Gray Warm" ordered-sequential Tableau
palette. Position 7 was #b047a4 (a magenta, in a warm-gray ramp) and is now
#b0a8a4; position 18 was #665c51, which broke the ramp's monotonic blue
channel, and is now #665c5a. Plots using
scale_colour_gradient_tableau("Gray Warm") will change appearance.
Fix a duplicated color (#fa9d4f) in the "Red-Gold" ordered-sequential
Tableau palette, which gave it 21 colors where every other 20-step Tableau
sequential palette has 20. Plots using "Red-Gold" will change appearance.
Remove data-raw/theme-data/tableau-new.yml, an unused duplicate of
tableau.yml.
The test suite no longer requires suggested packages to be installed.
expect_hexcolor() used stringr and glue on every palette test,
and stringr had moved from Imports to Suggests; it now uses base
equivalents. The tests that genuinely need withr or farver skip
when those are absent instead of erroring.
geom_rangeframe() now errors on a sides value that names no side, rather
than silently drawing nothing. sides packs side letters into one string, so
a typo such as sides = "xy" previously produced an empty layer with no
message. Valid values are strings made up of "t", "r", "b" and "l".
Fix the ?extended_range_breaks help page, which described a function
scales_extended_range_breaks() that does not exist and attributed the
wrong return value to each function. extended_range_breaks_() returns the
break values; extended_range_breaks() returns a breaks function. The page
now also warns that ggplot2 passes a breaks function the expanded scale
limits, so breaks = extended_range_breaks() labels the panel edges rather
than the data extremes; apply the function to the data to label the extremes.
Fix theme_economist_white() failing on installations without dplyr.
The internal get_colors() helper called dplyr::filter(), but dplyr is a
suggested package, not an import; it now uses base subsetting. The test
suite no longer uses dplyr either, so R CMD check passes with only the
hard dependencies installed.
Fix the @family tags that split related help pages apart. Word-order and
singular/plural inconsistencies (stata colour, solarized colour,
shape stata, shape tableau) each put one page in a family of its own, so
it linked to nothing. ?extended_range_breaks had no family at all and was
unreachable from theme_tufte(), geom_rangeframe() and
geom_tufteboxplot(), which it is meant to be used with; those four now
cross-reference each other.
Add vdiffr visual regression baselines for every exported theme, and swatch
baselines plus property assertions (valid hex, no duplicate colors, stable
lengths, monotone lightness, no out-of-family color, monotone gray ramps)
for the Tableau palette families. These are development-only tests and do not
run on CRAN; vdiffr (>= 1.0.6) and farver are now used in Suggests
(#219).
Add support for Stata's st scheme family, which has been Stata's factory
default since Stata 18. stata_pal() and scale_colour_stata() gain the
"stcolor" scheme (the stc1--stc15 colors), and theme_stata() gains
the "stcolor", "stcolor_alt", "stmono1", "stmono2" and "stsj"
schemes. stgcolor and stgcolor_alt are not included: they differ from
stcolor only in physical graph dimensions, which a ggplot2 theme does not
carry.
The 19 named colors Stata 18 added (stc1--stc15 plus the stblue,
stred, stgreen and styellow aliases) are now in
ggthemes_data$stata$colors$names.
Omitting scheme in stata_pal(), scale_colour_stata(),
scale_fill_stata() and theme_stata() is now soft-deprecated. It still
resolves to "s2color", but the default will change to "stcolor" in
ggthemes 8.0.0, following Stata. Pass scheme explicitly to keep the
current appearance.
BEHAVIOR CHANGE: stata_pal("mono") returned the wrong colors at
positions 6 and 12 (gs14 and gs15 instead of gs12 and gs5). It now
matches Stata's s1mono/s2mono exactly, including the fact that Stata
repeats gs12 and gs5 at positions 14 and 15. Plots using "mono" with
six or more levels will change.
Fix stata_pal("economist"), which returned NA as its first color
because the scheme referred to a non-existent color dkblue. It is now
edkblue, matching Stata's scheme-economist.scheme.
Fix attr(stata_pal(scheme), "max_n"), which reported 2 rather than 15
because it measured the columns of the palette table instead of its rows.
Add Apple Numbers support: numbers_pal(), scale_colour_numbers(),
scale_color_numbers(), scale_fill_numbers(), and theme_numbers().
All 12 Numbers chart palettes are available by their Numbers names
("Classic", the default, through "Spectrum"), each providing six
series colors. theme_numbers() follows the chart style defaults that
ship inside Numbers: no panel fill, gridlines in the value direction
only, a bottom chart border, and no tick marks.
The palettes are generated from Apple Numbers 14.5 by
data-raw/reference/numbers/fetch.sh and data-raw/numbers_palettes.R;
see data-raw/reference/numbers/SOURCES.md. This replaces
data-raw/theme-data/numbers-charts.yml, an unused file added in 2018
that was never wired into data-raw/build.R and held iWork-era colors
matching no current Numbers palette.
Fix two incorrect colors in the Google Docs palette, checked against the
series colors a current Google Sheets chart actually renders. teal 2 was
#ff994d, a duplicate of orange 2, and is now #7ed1d7; teal 3 was
#c9e4e7 and is now #b5e5e8. This changes the output of gdocs_pal(),
scale_colour_gdocs(), and scale_fill_gdocs() for more than 11 colors.
The other 22 colors were already correct.
theme_gdocs() now matches the text colors Google Sheets uses. Sheets
applies a graded hierarchy rather than one gray: axis tick labels are black,
legend labels #1a1a1a, and axis titles and the x-axis line #333333. The
chart title (#757575) and gridlines (#cccccc) are unchanged.
BREAKING CHANGE: hc_pal("default") now returns the palette Highcharts has
used by default since v11.0.0 (#2caffe, #544fc5, #00e272, ...). It
previously returned the palette used before v11 (#7cb5ec, #434348, ...),
which Highcharts replaced in April 2023. Plots using scale_colour_hc() or
scale_fill_hc() without an explicit palette will change appearance. The
old palette is still available as hc_pal("classic").
BEHAVIOR CHANGE: two colors in that older palette were wrong, and are
corrected in "classic". Position 8 was #8085e8 (a near-duplicate of
#8085e9 at position 5, differing by one hex digit) and is now #2b908f;
position 9 was #8d4653 and is now #f45b5b. The old values match
Highcharts 4.x; every Highcharts release from v5.0.0 to v10.x shipped the
corrected pair.
hc_pal() and scale_colour_hc()/scale_fill_hc() gain the palettes
bundled with Highcharts 13: "default_dark" (the dark-mode form of the
default, which Highcharts selects via CSS light-dark()),
"high_contrast_light" and "high_contrast_dark" (Highcharts' own palette,
tested for color blindness and tailored to 3:1 contrast), "grid_light",
"sand_signika", "avocado" and "sunset". Note that "avocado" and
"sunset" have only four colors.
hc_pal() now reports a max_n attribute and warns when asked for more
colors than the palette holds, matching the other ggthemes palettes.
theme_hc()'s horizontal grid lines are now #e6e6e6, matching Highcharts'
--highcharts-neutral-color-10, rather than #D8D8D8.
theme_hc() gains the "default_dark", "grid_light" and "sand_signika"
styles. "grid_light" is the one Highcharts theme that draws vertical grid
lines. The "high_contrast", "avocado" and "sunset" themes are not
included as styles: upstream they change nothing but the series colors, so
they are available through hc_pal() and are meant to be combined with
theme_hc("default") or theme_hc("default_dark").
BEHAVIOR CHANGE: theme_hc("darkunica") drew all text in #A0A0A3 and
titles in #FFFFFF. Highcharts uses #E0E0E3 for axis labels, titles and
axis titles in this theme, so text is now #E0E0E3 throughout. The grid
color #707073 was already correct and is unchanged.
Fix unreadable axis labels in theme_hc("darkunica"). theme_hc() is a
partial theme, and it never set axis.text, so the axis labels kept
theme_grey()'s "grey30" and were drawn in dark gray on the near-black
background. They now use the same color as the rest of the theme's text.
Remove data-raw/theme-data/highcharts.yml, an unused duplicate of hc.yml
that still held the palettes from before v11.
theme_hc()'s examples now pass style rather than the deprecated
bgcolor, and the last example uses scale_colour_hc() instead of
scale_fill_hc(), which had no effect on its color-mapped lines.
BREAKING CHANGE: theme_economist() and economist_pal() now follow the
chart design The Economist introduced in 2017 and still publishes,
replacing the pre-2017 style ggthemes had shipped since 2013. Existing
plots will change appearance. The new look draws a white panel on a pale
#e9edf0 ground with light horizontal gridlines, a black x-axis baseline
with tick marks below it (they previously pointed inward), and no y-axis
rule or ticks. economist_pal() returns the nine current chart colors
(#006ba2, #3ebcd2, #379a8b, #ebb434, #b4ba39, #9a607f,
#d1b07c, #758d99, #db444b) in place of the old blues and greens.
Colors and geometry are transcribed from The Economist visual
styleguide v1.2 (4 May 2017); see data-raw/reference/economist/.
ggthemes_data$economist is restructured to match: main (the nine
series colors plus "Econ red"), scales (the styleguide's
"equal lightness colour scales", six ordered steps for each of the nine
hues), bg, and text. The former fg and bg entries are gone; their
values are recorded in a comment in data-raw/theme-data/economist.yml.
Add economist_seq_pal() and economist_gradient_pal(), plus
scale_colour_economist_c()/scale_fill_economist_c() for continuous
data and scale_colour_economist_ordinal()/scale_fill_economist_ordinal()
for ordered factors, built from the equal-lightness scales.
Deprecate theme_economist_white() (lifecycle::deprecate_warn()); the
current design already draws a white panel, so it no longer differs from
theme_economist(), to which it now forwards.
Deprecate the dkpanel argument of theme_economist() and the fill
argument of economist_pal(). Both were features of the pre-2017 design
and are now ignored.
Fix: theme_economist() previously looked up a background color named
"ebg", which economist.yml did not define, so rect and
strip.background silently received a fill of NA. The rewritten theme
sets both explicitly.
circlefill_shape_pal() and scale_shape_circlefill(), soft-deprecated
since ggthemes 5.0.0, now always warn on use (lifecycle::deprecate_warn())
instead of only when called directly by the user|>) instead of the magrittr pipe (%>%) in data-raw/ and
examples, to match the current Tidyverse Style Guide (lintr's
pipe_consistency_linter is now a default linter requiring |>, which was
failing CI)actions/checkout,
actions/upload-artifact, and the pkgdown deploy action to their current
pinned versions; add explicit permissions: blocks; migrate
test-coverage.yaml from covr::codecov() to covr::package_coverage() +
the official codecov/codecov-actionbranch/master Codecov badge in README (now points at main)"ao" (Average Absolute Orientation) and "was" (Weighted Average
Absolute Slope) methods to bank_slopes(), following Heer and Agrawala
(2006). Also declare stats as an explicit Imports dependency, since
bank_slopes() calls stats::median()/stats::uniroot()/
stats::weighted.mean(), and fix the bank_slopes() example so each
method's ratio is actually applied via coord_fixed() instead of just
computed and discardedbank_plot(), a wrapper around bank_slopes() that extracts x/y
directly from an already-built ggplot (respecting stats, position
adjustments, groups, and facets) and returns the plot with
coord_fixed() applied, so banking a plot no longer requires manually
reconstructing its plotted vectorsbank_slopes(method = "ao") now returns NaN (matching the other
methods) instead of erroring when there is no vertical variation (e.g. a
flat line) or too few points to compute a slopebank_plot() now rejects a non-positive layer with the intended
cli_abort() message instead of falling through to a raw subsetting errorexcel_new_pal() example so it actually generates output (#199)extended_range_breaks_() now respects the n argument instead of
silently ignoring it (#139)black argument to colorblind_pal(), scale_colour_colourblind(),
scale_color_colorblind(), scale_fill_colorblind(), and
scale_fill_colourblind(); set black = FALSE to drop black from the
colorblind-safe palette (#178)ink, paper, and accent arguments to theme_foundation(),
matching ggplot2's own theme_gray(ink=, paper=, accent=). Branded themes
(e.g. theme_economist(), theme_excel()) intentionally replicate a fixed
published style and do not expose these (#183)theme_economist()/theme_economist_white() and theme_excel() now
respect the base_family and base_size arguments (#135)theme_excel_new() now scales axis.text, strip.text,
legend.text, and plot.title with base_size, and no longer blanks out
axis titles by default (#176)geom_rangeframe() no longer silently drops the entire range line
for an aesthetic when the data contains missing values; na.rm now behaves
as documented (#177)geom_rangeframe() docs (and add an example) that
sides = "trbl" already draws correctly-positioned frames on panels with
a secondary axis, since ggplot2::sec_axis() only relabels the existing
scale rather than introducing a separate data range (#179)midpoint argument to scale_colour_gradient2_tableau(),
scale_fill_gradient2_tableau(), and scale_color_gradient2_tableau() to
control which data value maps to the middle color of the diverging
palette (#136)cleveland_shape_pal(overlap = FALSE) and tableau_shape_pal() now warn
with an actionable message when their Unicode-derived pch codes are
likely to fail to render (non-UTF-8 locale), instead of only surfacing a
cryptic low-level "conversion failure ... in 'mbcsToSbcs'" error at draw
time (#164)stop()/warning() with cli::cli_abort()/
cli::cli_warn() throughout, matching current tidyverse convention (used
by ggplot2/dplyr). Error/warning text is largely the same information,
reformatted for clarity; a few tests were updated to match. Add cli and
rlang to Imports.rlang::check_installed() instead of a manual
requireNamespace() + stop() check for the quantreg dependency in
stat_fivenumber()'s weighted case, which prompts an interactive install
instead of just erroring. The genuinely optional pander-availability
checks in theme_pander()/palette_pander() are left as
requireNamespace(), since check_installed() is for hard requirements.scale_colour_colorblind() to scale_colour_colourblind() (#180).theme_solarized to fix key.background color.scale_color_gdocs and gdocs_pal to use current colors. Palette extended from 10 to 24 colors.legend.title.align and legend.text.align from themes. (#153)circlefill_shape_pal and scale_shape_circlefillggthemes-packagequantreg to suggested packagesexpect_equal functions (#123)geom_tufteboxplot and stat_fivenumber due to missing imported
objects from ggplot2 (#117, #121)theme_economist (#115)geom_rangeframe; it should be used with coord_cartesian(clip="off"). (#120)theme_clean() (Thanks @konradzdeb, #105)direction argument to scale_color_tableau() and scale_fill_tableau()
(Thanks @vadimus202, #112)geom_rangeframe and geom_tufteboxplot caused by
failing to import alpha. (Thanks @flying-sheep, #110)type argument to scale_color_tableau so that sequential and diverging
palettes can be used in discrete scales. (Thanks @onesandzeroes, #108)tableau_color_pal(). (Thanks @leonawicz, #109)tableau_color_pal(). Wrong colors in "Tableau 20" theme
(Thanks @friskin, #95), and incorrect order of classic color palettes
(Thanks @luca-scr, #96).theme_solarized() and solarized_rebase().
(Thanks @mdodrill-usgs, #97)Added palettes and based on current versions of Excel:
excel_pal_new(), scale_colour_excel_new(), and scale_fill_excel_new().
Excel '97 based scales keep the same names.
Added theme_excel_new() which is based on the chart defaults of current versions
of Excel.
Added Tableau 10 palettes and renamed old palettes
in tableau_color_pal(), scale_color_tableau(), scale_fill_tableau(),
and others. The continuous sequential and diverging palettes are improved
by including more intermediate steps.
Updated theme_gdocs() to current look.
Updated scale_color_gdocs() and fill_color_gdocs() to current color.
Added scale_shapes_few() and few_shape_pal() with a shape scale and
palette from Stephen Few's "Show Me the Numbers".
Removed stata argument from scale_*_economist() and theme_economist().
Changed the format of the ggthemes_data object.
Changed behavior of few_pal(). If n = 1, use gray. If n > 1 use non-gray
colors.
Changed tremmel_shape_scale() to use alt = TRUE by default
Deprecated tremmel_shape_scale() argument n3alt. Use the alt argument instead.
Added a pkgdown site.
Removed vignette. Move all examples to man pages.
Bugfix: Fix theme_few() (#91)
Bugfix: Update themes to be consistent with ggplot>=3.2.0
Bugfix: Fix RGB colors in scale_color_few(), scale_fill_few(), and
few_pal() (#89, @bpbraun)
Update documentation to include mentions of the maximum number of values that discrete scales support (#85)
theme_economist(). Thanks @carlganz #81.reshape2, plyr, tidyverseAdd color palettes from canva.com: canva_palettes(), canva_pal(),
scale_colour_canva().
Use NEWS.md instead of NEWS
Update Economist examples to put y-axis on the right side.
Update themes to changes in ggplot 2.1.0.9000. Thanks @juliasilge (#71)
tufte_boxplot() uses position="dodge" by default. Thanks @jgellar (#68)
Bugfix: Fix errors in geom_rangeframe() in new version of ggplot2.
Thanks @coulmont (#70)
bank_slopes(), remove methods ao, gor, and lor.
These methods were not producing reliable results, and should not produce
results much different than ms or as. If used, they will produce a
warning, and ms will be used instead. (#68)ptol_pal(), scale_colour_ptol(), and scale_file_ptol() based on
Paul Tol's qualitative color palettes. Thanks @jmlondon. (#65)theme_hc(). Thanks @flying-sheep! (#64)lintr tests that broke with new testthat.ggthemes_data()Bugfix: Remove border around legends in theme_gdocs().
Thanks SandyMuspratt! Pull request #53.
Bugfix: Remove border around legends in theme_calc().
Bugfix: Add color and fill values to theme_foundation(). This restores
its behavior to version 2.2.1. Fixes Issue #56.
For geom_tufteboxplot() and GeomTufteboxplot, option median.type
supports only line and point options. Added option whisker.type
which allows for whiskers to be specified by lines or points.
Changed default stat for geom_tufteboxplot() to stat_fivenumber().
Added theme_base() and theme_par()
Removed scale_(x|y)_tufte(). See issue #49
theme_foundation() rewritten. Removed use_sizes argument.
Import rather than depend on ggplot2
Update geoms, scales, and themes to ggplot >= 2.0.0
bugfix: fix R CMD check notes due to change in how it handles non-base default packages: https://developer.r-project.org/blosxom.cgi/R-devel/2015/06/29
bugfix: fix bad URLs
theme_map() from @hrbrmstrrequireNamespace() instead of require()scale_*_hc(), theme_hc().
Thanks jbkunst!New options for geom_tufteboxplot(). median.type takes values "point",
"box", or "line". Option usebox is no longer supported, and equivalent to
median.type="box". Thanks weitzner! Issue #13, PR #19.
All theme functions have base_size and base_family as first two arguments.
This affects theme_economist_white(), theme_excel(),
theme_pander(), theme_solid(), and theme_tufte(). Thanks ptoche! Issue #25.
theme_pander(): Options ff and fs are deprecated; use
base_family and base_size options instead, respectively.
added vignette
added themes / scales based on factory defaults of pander package:
pander_palette(), scale_color_pander(), scale_fill_pander(),
theme_pander(). Thanks daroczig.
added additional fill and gradient color scales: scale_fill_fivethirtyeight(),
scale_colour_gradient_tableau(), scale_fill_gradient_tableau(),
scale_fill_continuous_tableau(), scale_colour_gradient2_tableau(),
scale_fill_gradient2_tableau(). Thanks bowerth.
theme_fivethirtyeight(), fivethirtyeight_pal(), scale_color_fivethirtyeight()scales_extended_range_breaks(), extended_range_breaks()scale_x_tufte(), scale_y_tufte()smart_digits(), smart_digits_format()theme_wsj() (issue #17)theme_solid()theme_solarized_2()theme_solarized(): adjusted the colorstheme_calc(), calc_pal(), scale_fill_calc(), scale_colour_calc(), calc_shape_pal(), scale_shape_calc()theme_gdocs(), gdocs_pal(), scale_fill_gdocs(), scale_colour_gdocs()scale_colour_excel() and scale_fill_excel().tableau_seq_gradient_pal(), scale_colour_gradient_tableau(), scale_fill_gradient_tableau().tableau_div_gradient_pal(), scale_colour_gradient2_tableau(), scale_fill_gradient2_tableau().tableau_colour_pal(): added palette "cyclicaltheme_wsj() in Windowsbank_slopes() returns y/x aspect ratio to be compatible with coord_fixed()theme_excel2003() to theme_excel()scale_fill_excel2003() and scale_fill_excel10() with scale_fill_excel()scale_colour_excel2003() and scale_colour_excel10() with scale_colour_excel()excel2003_pal() and excel10_pal() with excel_pal()theme_base() to theme_foundation()colorblind_pal(), scale_*_colorblind().theme_wsj(), wsj_pal(),
scale_colour_wsj(), and scale_fill_wsj().bank_slopes() : methods for determining the optimal slope
ratio.theme-foundation(): a theme designed to be easy to extend into new
themes.