This is exactly the same function as scale_*_continuous, just with different
label defaults to save repetitively setting these parameters, except that
the parameters which you would normally find inside the scales::format_*()
functions are accessible directly in the scale_[xy]_*_cz()
functions.
Usage
scale_x_percent_cz(
name = waiver(),
breaks = waiver(),
minor_breaks = waiver(),
guide = waiver(),
n.breaks = NULL,
labels,
limits = NULL,
expand = c(0.01, 0),
oob = scales::censor,
na.value = NA_real_,
trans = "identity",
position = "bottom",
sec.axis = waiver(),
accuracy = 1,
scale = 100,
prefix = "",
suffix = " %",
big.mark = " ",
decimal.mark = ",",
trim = TRUE,
...
)
scale_y_percent_cz(
name = waiver(),
breaks = waiver(),
minor_breaks = waiver(),
guide = waiver(),
n.breaks = NULL,
labels,
limits = NULL,
expand = c(0.01, 0),
oob = scales::censor,
na.value = NA_real_,
trans = "identity",
position = "left",
sec.axis = waiver(),
accuracy = 1,
scale = 100,
prefix = "",
suffix = " %",
big.mark = " ",
decimal.mark = ",",
trim = TRUE,
...
)
scale_x_number_cz(
name = waiver(),
breaks = waiver(),
minor_breaks = waiver(),
guide = waiver(),
n.breaks = NULL,
labels,
limits = NULL,
expand = c(0.01, 0),
oob = scales::censor,
na.value = NA_real_,
trans = "identity",
position = "bottom",
sec.axis = waiver(),
accuracy = 1,
scale = 1,
prefix = "",
suffix = "",
big.mark = " ",
decimal.mark = ",",
trim = TRUE,
...
)
scale_y_number_cz(
name = waiver(),
breaks = waiver(),
minor_breaks = waiver(),
guide = waiver(),
n.breaks = NULL,
labels,
limits = NULL,
expand = c(0.01, 0),
oob = scales::censor,
na.value = NA_real_,
trans = "identity",
position = "left",
sec.axis = waiver(),
accuracy = 1,
scale = 1,
prefix = "",
suffix = "",
big.mark = " ",
decimal.mark = ",",
trim = TRUE,
...
)
Arguments
- name
The name of the scale. Used as axis or legend title. If
waiver()
, the default, the name of the scale is taken from the first mapping used for that aesthetic. IfNULL
, the legend title will be omitted.- breaks
One of:
NULL
for no breakswaiver()
for the default breaks computed by the transformation objectA numeric vector of positions
A function that takes the limits as input and returns breaks as output
- minor_breaks
One of:
NULL
for no minor breakswaiver()
for the default breaks (one minor break between each major break)A numeric vector of positions
A function that given the limits returns a vector of minor breaks.
- guide
guide A function used to create a guide or its name. See
guides()
for more information.- n.breaks
An integer guiding the number of major breaks. The algorithm may choose a slightly different number to ensure nice break labels. Will only have an effect if
breaks = waiver()
. Use NULL to use the default number of breaks given by the transformation.- labels
Specifying overrides the default format (i.e. you really don't want to do that).
NULL
means no labels.- limits
A numeric vector of length two providing limits of the scale. Use
NA
to refer to the existing minimum or maximum.- expand
same as in ggplot2
- oob
Function that handles limits outside of the scale limits (out of bounds). The default replaces out of bounds values with NA.
- na.value
If
na.translate = TRUE
, what value aesthetic value should missing be displayed as? Does not apply to position scales whereNA
is always placed at the far right.- trans
Either the name of a transformation object, or the object itself. Built-in transformations include "asn", "atanh", "boxcox", "exp", "identity", "log", "log10", "log1p", "log2", "logit", "probability", "probit", "reciprocal", "reverse" and "sqrt".
- position
The position of the axis. "left" or "right" for vertical scales, "top" or "bottom" for horizontal scales
- sec.axis
specify a secondary axis
- accuracy, scale, prefix, suffix, big.mark, decimal.mark, trim
See [scales::comma_format()] or [scales::percent_format()]
- ...
passed on to [scales::comma_format()] or [scales::percent_format()]
Examples
# ADD_EXAMPLES_HERE
library(reschola)
library(ggplot2)
ggplot(mpg, aes(hwy * 100, cty / max(cty))) +
geom_point() +
theme_schola(family = "sans", title_family = "sans", gridlines = "scatter") +
scale_y_percent_cz() +
scale_x_number_cz()