Change axis labels, legend titles, plot title/subtitle and below-plot caption.

Usage

labs(...)

xlab(label)

ylab(label)

ggtitle(label, subtitle = NULL)

Arguments

...: a list of new names in the form aesthetic = "new name"
label: The text for the axis, plot title or caption below the plot.
subtitle: the text for the subtitle for the plot which will be displayed below the title. Leave NULL for no subtitle.

Examples

p <- ggplot(mtcars, aes(mpg, wt)) + geom_point()
p + labs(title = "New plot title")

p + labs(x = "New x label")

p + xlab("New x label")

p + ylab("New y label")

p + ggtitle("New plot title")


# Can add a subtitle to plots with either of the following
p + ggtitle("New plot title", subtitle = "A subtitle")

p + labs(title = "New plot title", subtitle = "A subtitle")


# Can add a plot caption underneath the whole plot (for sources, notes or
# copyright), similar to the \code{sub} parameter in base R, with the
# following
p + labs(caption = "(based on data from ...)")


# This should work independently of other functions that modify the
# the scale names
p + ylab("New y label") + ylim(2, 4)
#> Warning: Removed 8 rows containing missing values (geom_point).

p + ylim(2, 4) + ylab("New y label")
#> Warning: Removed 8 rows containing missing values (geom_point).


# The labs function also modifies legend labels
p <- ggplot(mtcars, aes(mpg, wt, colour = cyl)) + geom_point()
p + labs(colour = "Cylinders")


# Can also pass in a list, if that is more convenient
p + labs(list(title = "Title", subtitle = "Subtitle", x = "X", y = "Y"))