stat_brace {ggbrace} | R Documentation |
create curly braces as a layer in ggplot
Description
Imports: ggplot2
Usage
stat_brace(
mapping = NULL,
data = NULL,
geom = "path",
position = "identity",
...,
rotate = 0,
width = NULL,
mid = NULL,
outside = TRUE,
distance = NULL,
outerstart = NULL,
bending = NULL,
npoints = 100,
show.legend = FALSE,
inherit.aes = TRUE
)
Arguments
mapping |
Set of aesthetic mappings created by |
data |
The data to be displayed in this layer. There are three options: If A A |
geom |
The geometric object to use to display the data, either as a
|
position |
Position adjustment, either as a string naming the adjustment
(e.g. |
... |
Other arguments passed on to |
rotate |
number, defines where the brace is pointing to: 0=up, 90=right, 180=down, 270=left. When specified by user, will overwrite other directions the brace might have from x/y coordinates. |
width |
number, how wide should the braces be? If NULL (default), will be determined automatically based on the data. |
mid |
number, where the pointer is within the bracket space (between 0.25 and 0.75). If NULL (default), will be determined automatically based on the data. |
outside |
boolean, should the brace be outside of the data area or cover the data area? |
distance |
number, space between the brace and the nearest data point |
outerstart |
number, overwrites distance and provides one coordinate for all braces |
bending |
number, how strongly the curves of the braces should be bent (the higher the more round). Note: too high values will result in the brace showing zick-zack lines |
npoints |
integer, number of points generated for the brace curves (resolution). This number will be rounded to be a multiple of 4 for calculation purposes. |
show.legend |
logical. Should this layer be included in the legends?
|
inherit.aes |
If |
Value
ggplot2 layer object (geom_path) that can directly be added to a ggplot2 object. If a label was provided, a another layer (geom_text) is added.
Examples
library(ggbrace)
library(ggplot2)
data(iris)
# regular braces
ggplot(iris, aes(x=Sepal.Length, y=Sepal.Width, color=Species, label=Species)) +
geom_point() +
stat_brace()
# rotated braces
ggplot(iris, aes(x=Sepal.Length, y=Sepal.Width, color=Species, label=Species)) +
geom_point() +
stat_brace(rotate = 90)
# braces inside the given coordinates
ggplot(iris, aes(x=Sepal.Length, y=Sepal.Width, color=Species, label=Species)) +
geom_point() +
stat_brace(outside = FALSE)
# braces with a defined distance from their data points
ggplot(iris, aes(x=Sepal.Length, y=Sepal.Width, color=Species, label=Species)) +
geom_point() +
stat_brace(distance = 2)
# braces starting at a defined point
ggplot(iris, aes(x=Sepal.Length, y=Sepal.Width, color=Species, label=Species)) +
geom_point() +
stat_brace(outerstart = 5)
# braces starting at a defined point and with defined width
ggplot(iris, aes(x=Sepal.Length, y=Sepal.Width, color=Species, label=Species)) +
geom_point() +
stat_brace(outerstart = 5, width = 1)
# braces starting at a defined point and with defined width and defined curve bending
ggplot(iris, aes(x=Sepal.Length, y=Sepal.Width, color=Species, label=Species)) +
geom_point() +
stat_brace(outerstart = 5, width = 1, bending = 0.1)
# braces outside of the plotting area
ggplot(iris, aes(x=Sepal.Length, y=Sepal.Width, color=Species, label=Species)) +
geom_point() +
stat_brace(outerstart = 4.5) +
coord_cartesian(y=range(iris$Sepal.Width), clip = "off") +
theme(plot.margin = unit(c(0.25, 0.11, 0.11, 0.11), units="npc"))
# braces with discrete values
df <- data.frame(x = c("a","b","c","d","e"), y = 1:5)
ggplot(df, aes(x, y)) +
geom_point() +
stat_brace(aes(x=seq_along(x)))