For each x value, geom_ribbon()
displays a y interval defined
by ymin
and ymax
. geom_area()
is a special case of
geom_ribbon()
, where the ymin
is fixed to 0 and y
is used instead
of ymax
.
gf_ribbon(
object = NULL,
gformula = NULL,
data = NULL,
...,
alpha = 0.3,
xlab,
ylab,
title,
subtitle,
caption,
geom = "ribbon",
stat = "identity",
position = "identity",
show.legend = NA,
show.help = NULL,
inherit = TRUE,
environment = parent.frame()
)
When chaining, this holds an object produced in the earlier portions of the chain. Most users can safely ignore this argument. See details and examples.
A formula with shape ymin + ymax ~ x
.
Faceting can be achieved by including |
in the formula.
The data to be displayed in this layer. There are three options:
If NULL
, the default, the data is inherited from the plot
data as specified in the call to ggplot()
.
A data.frame
, or other object, will override the plot
data. All objects will be fortified to produce a data frame. See
fortify()
for which variables will be created.
A function
will be called with a single argument,
the plot data. The return value must be a data.frame
, and
will be used as the layer data. A function
can be created
from a formula
(e.g. ~ head(.x, 10)
).
Additional arguments. Typically these are
(a) ggplot2 aesthetics to be set with attribute = value
,
(b) ggplot2 aesthetics to be mapped with attribute = ~ expression
, or
(c) attributes of the layer as a whole, which are set with attribute = value
.
Opacity (0 = invisible, 1 = opaque).
Label for x-axis. See also gf_labs()
.
Label for y-axis. See also gf_labs()
.
Title, sub-title, and caption for the plot.
See also gf_labs()
.
The geometric object to use to display the data, either as a
ggproto
Geom
subclass or as a string naming the geom stripped of the
geom_
prefix (e.g. "point"
rather than "geom_point"
)
The statistical transformation to use on the data for this
layer, either as a ggproto
Geom
subclass or as a string naming the
stat stripped of the stat_
prefix (e.g. "count"
rather than
"stat_count"
)
Position adjustment, either as a string naming the adjustment
(e.g. "jitter"
to use position_jitter
), or the result of a call to a
position adjustment function. Use the latter if you need to change the
settings of the adjustment.
logical. Should this layer be included in the legends?
NA
, the default, includes if any aesthetics are mapped.
FALSE
never includes, and TRUE
always includes.
It can also be a named logical vector to finely select the aesthetics to
display.
If TRUE
, display some minimal help.
A logical indicating whether default attributes are inherited.
An environment in which to look for variables not found in data
.
gf_ribbon()
#> gf_ribbon() uses
#> * a formula with shape ymin + ymax ~ x or y ~ xmin + xmax.
#> * geom: ribbon
#> * key attributes: alpha = 0.3
#>
#> For more information, try ?gf_ribbon
gf_ribbon(low_temp + high_temp ~ date, data = mosaicData::Weather, fill = ~city, alpha = 0.4) |>
gf_theme(theme = theme_minimal())
gf_linerange(
low_temp + high_temp ~ date | city ~ .,
color = ~high_temp,
data = mosaicData::Weather
) |>
gf_refine(scale_colour_gradientn(colors = rev(rainbow(5))))
gf_ribbon(low_temp + high_temp ~ date | city ~ ., data = mosaicData::Weather)
# Chaining in the data
if (FALSE) {
mosaicData::Weather |>
gf_ribbon(low_temp + high_temp ~ date, alpha = 0.4) |>
gf_facet_grid(city ~ .)
}