View source: R/guide-colorsteps.R
guide_coloursteps | R Documentation |
This guide is version of guide_colourbar()
for binned colour and fill
scales. It shows areas between breaks as a single constant colour instead of
the gradient known from the colourbar counterpart.
guide_coloursteps(even.steps = TRUE, show.limits = NULL, ticks = FALSE, ...)
guide_colorsteps(even.steps = TRUE, show.limits = NULL, ticks = FALSE, ...)
even.steps |
Should the rendered size of the bins be equal, or should
they be proportional to their length in the data space? Defaults to |
show.limits |
Logical. Should the limits of the scale be shown with
labels and ticks. Default is |
ticks |
A logical specifying if tick marks on the colourbar should be visible. |
... |
Arguments passed on to
|
A guide object
This guide is intended to show binned data and work together with ggplot2's
binning scales. However, it is sometimes desirable to perform the binning in
a separate step, either as part of a stat (e.g. stat_contour_filled()
) or
prior to the visualisation. If you want to use this guide for discrete data
the levels must follow the naming scheme implemented by base::cut()
. This
means that a bin must be encoded as "(<lower>, <upper>]"
with <lower>
giving the lower bound of the bin and <upper>
giving the upper bound
("[<lower>, <upper>)"
is also accepted). If you use base::cut()
to
perform the binning everything should work as expected, if not, some recoding
may be needed.
Other guides:
guide_bins()
,
guide_colourbar()
,
guide_legend()
,
guides()
df <- expand.grid(X1 = 1:10, X2 = 1:10)
df$value <- df$X1 * df$X2
p <- ggplot(df, aes(X1, X2)) + geom_tile(aes(fill = value))
# Coloursteps guide is the default for binned colour scales
p + scale_fill_binned()
# By default each bin in the guide is the same size irrespectively of how
# their sizes relate in data space
p + scale_fill_binned(breaks = c(10, 25, 50))
# This can be changed with the `even.steps` argument
p + scale_fill_binned(
breaks = c(10, 25, 50),
guide = guide_coloursteps(even.steps = FALSE)
)
# By default the limits is not shown, but this can be changed
p + scale_fill_binned(guide = guide_coloursteps(show.limits = TRUE))
# (can also be set in the scale)
p + scale_fill_binned(show.limits = TRUE)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.