Initiate a plotly visualization

Transform data into a plotly visualization.

plot_ly(data = data.frame(), ..., type = NULL, color, colors = NULL,
  alpha = 1, symbol, symbols = NULL, size, sizes = c(10, 100), linetype,
  linetypes = NULL, split, width = NULL, height = NULL, source = "A")

A data frame (optional).


These arguments are documented at Note that acceptable arguments depend on the value of type.


A character string describing the type of trace.


A formula containing a name or expression. Values are scaled and mapped to color codes based on the value of colors and alpha. To avoid scaling, wrap with I(), and provide value(s) that can be converted to rgb color codes by col2rgb().


Either a palette name (e.g. "YlOrRd" or "Blues"), or a vector of colors to interpolate in hexadecimal "#RRGGBB" format, or a color interpolation function like colorRamp().


A number between 0 and 1 specifying the alpha channel applied to color.


A formula containing a name or expression. Values are scaled and mapped to symbols based on the value of symbols. To avoid scaling, wrap with I(), and provide valid pch() values and/or valid plotly symbol(s) as a string


A character vector of symbol types. Either valid pch or plotly symbol codes may be supplied.


A formula containing a name or expression yielding a numeric vector. Values are scaled according to the range specified in sizes.


A numeric vector of length 2 used to scale sizes to pixels.


A formula containing a name or expression. Values are scaled and mapped to linetypes based on the value of linetypes. To avoid scaling, wrap with I().


A character vector of line types. Either valid par (lty) or plotly dash codes may be supplied.


A formula containing a name or expression. Similar to group_by(), but ensures at least one trace for each unique value. This replaces the functionality of the (now deprecated) group argument.


Width in pixels (optional, defaults to automatic sizing).


Height in pixels (optional, defaults to automatic sizing).


Only relevant for event_data.


There are a number of "visual properties" that aren't included in the officical Reference section (see below).

See Also

  • For initializing a plotly-geo object: plot_geo().

  • For initializing a plotly-mapbox object: plot_mapbox().

  • For translating a ggplot2 object to a plotly object: ggplotly().

  • For modifying any plotly object: layout(), add_trace(), style()

  • plot_ly
library(plotly) # NOT RUN { # plot_ly() tries to create a sensible plot based on the information you # give it. If you don't provide a trace type, plot_ly() will infer one. plot_ly(economics, x = ~pop) plot_ly(economics, x = ~date, y = ~pop) # plot_ly() doesn't require data frame(s), which allows one to take # advantage of trace type(s) designed specifically for numeric matrices plot_ly(z = ~volcano) plot_ly(z = ~volcano, type = "surface") # plotly has a functional interface: every plotly function takes a plotly # object as it's first input argument and returns a modified plotly object add_lines(plot_ly(economics, x = ~date, y = ~unemploy/pop)) # To make code more readable, plotly imports the pipe operator from magrittr economics %>% plot_ly(x = ~date, y = ~unemploy/pop) %>% add_lines() # Attributes defined via plot_ly() set 'global' attributes that # are carried onto subsequent traces, but those may be over-written plot_ly(economics, x = ~date, color = I("black")) %>% add_lines(y = ~uempmed) %>% add_lines(y = ~psavert, color = I("red")) # Attributes are documented in the figure reference -> # You might notice plot_ly() has named arguments that aren't in this figure # reference. These arguments make it easier to map abstract data values to # visual attributes. p <- plot_ly(iris, x = ~Sepal.Width, y = ~Sepal.Length) add_markers(p, color = ~Petal.Length, size = ~Petal.Length) add_markers(p, color = ~Species) add_markers(p, color = ~Species, colors = "Set1") add_markers(p, symbol = ~Species) add_paths(p, linetype = ~Species) # } # NOT RUN { # }
Documentation reproduced from package plotly, version 4.5.2, License: MIT + file LICENSE

Community examples at Nov 10, 2016 plotly v4.5.2

### general plotly example ```r data("diamonds") plot_ly(diamonds, x = ~carat, y = ~price, color = ~clarity) ```