scale_units: Position scales for units data

scale_unitsR Documentation

Position scales for units data


These are the default scales for the units class. These will usually be added automatically. To override manually, use scale_*_units.


scale_x_units(..., guide = ggplot2::waiver(), position = "bottom",
  sec.axis = ggplot2::waiver(), unit = NULL)

scale_y_units(..., guide = ggplot2::waiver(), position = "left",
  sec.axis = ggplot2::waiver(), unit = NULL)



arguments passed on to continuous_scale (e.g. scale transformations via the trans argument; see examples).


A function used to create a guide or its name. See guides() for more information.


For position scales, The position of the axis. left or right for y axes, top or bottom for x axes.


sec_axis() is used to specify a secondary axis.


A unit specification to use for the axis. If given, the values will be converted to this unit before plotting. An error will be thrown if the specified unit is incompatible with the unit of the data.


if (requireNamespace("ggplot2", quietly=TRUE)) {


mtcars$consumption <- set_units(mtcars$mpg, mi / gallon)
mtcars$power <- set_units(mtcars$hp, hp)

# Use units encoded into the data
ggplot(mtcars) +
  geom_point(aes(power, consumption))

# Convert units on the fly during plotting
ggplot(mtcars) +
  geom_point(aes(power, consumption)) +
  scale_x_units(unit = "W") +
  scale_y_units(unit = "km/l")

# Resolve units when transforming data
ggplot(mtcars) +
  geom_point(aes(power, 1 / consumption))

# Reverse the y axis
ggplot(mtcars) +
  geom_point(aes(power, consumption)) +


units documentation built on May 29, 2024, 10:24 a.m.