add_trace() adds one trace and add_traces() several. add_trace() is
an S3 generic, so packages can add methods for their own figure classes
(the plotly package does for plot_ly() objects).
Usage
add_trace(fig, ...)
# S3 method for class 'go_figure'
add_trace(
fig,
trace,
row = NULL,
col = NULL,
secondary_y = NULL,
exclude_empty_subplots = FALSE,
...
)
add_traces(
fig,
data,
rows = NULL,
cols = NULL,
secondary_ys = NULL,
exclude_empty_subplots = FALSE
)Arguments
- fig
A
go_figureobject.- ...
Unused.
- trace
A trace: a graph object such as
go_scatter(), or a named list with atypeelement (default"scatter").- row, col
Subplot grid cell for the trace (figures created with
make_subplots()only). Either may be"all"or a vector, to add the trace to several cells.- secondary_y
If
TRUE, use the secondary y axis of the subplot (see thespecsargument ofmake_subplots()).- exclude_empty_subplots
If
TRUE, don't add the trace to subplots that have no traces or layout objects yet.- data
A list of traces.
- rows, cols, secondary_ys
Per-trace grid cells and secondary y flags for
add_traces(); a single value applies to every trace.
See also
The generated add_<trace type>() functions, e.g. add_scatter().
Examples
go_figure() |>
add_trace(go_scatter(x = 1:3, y = 1:3)) |>
add_traces(list(list(type = "scatter", y = 3:1), go_scatter(y = c(2, 2, 2))))
make_subplots(rows = 1, cols = 2) |>
add_trace(go_scatter(y = 1:3), row = 1, col = 2)