demo(package = "plotly")
. For a more comprehensive overview, see https://cpsievert.github.io/plotly_book/linking-views-without-shiny.html. For some more complex examples, see https://cpsievert.github.io/pedestrians/highlight()
function for configuring selection modes/sequences.help(animation)
. For a more thorough overview, see https://cpsievert.github.io/plotly_book/key-frame-animations.htmlframe
argument to plot_ly()
for creating animations. Also added the animation_opts()
, animation_slider()
, and animation_button()
functions for configuring animation defaults.ggplotly()
gains a new argument, dynamicTicks
, which allows axis ticks to update upon zoom/pan interactions (fixes #485).GeomCol
and GeomDotplot
ggplot2 geoms.plot_dendro()
function for a quick and dirty interactive dendrogram with support for hierarchial selection. For more, see -- https://cpsievert.github.io/plotly_book/linking-views-without-shiny.html#nested-selectionsgeom_bar()
via ggplotly()
. Fixes #557 and #662.HTMLwidgets.renderValue()
now calls Plotly.redraw()
instead of Plotly.newPlot()
. (thanks @AleksandrIanevski)remove_typedarray_polyfill()
was added to make it easy to remove it. Fixes #824.ggplotly()
now tries to open/close a Cairo graphics device, then a bitmap (png/jpeg) device. If neither is available, it errors. This helps to ensure that a screen device is never opened by ggplotly()
(which fixes #829). Furthermore, if width
/height
is not specified and no graphics device is currently open, a default of 640/480 is used for width/height of the device. timezone
argument in ggplot2's scale_datetime()
. Fixes (#743, thanks @earowang).p
, do config(p, modeBarButtonsToRemove = "Collaborate")
layout()
is now deprecated. Specify in ggplotly()
or plot_ly()
.ggplotly()
function now preserves all information about the layer mapping. This makes it possible to access input/output data from any layer.layout.width
/layout.height
.height
/width
are specified in ggplotly()
, relative sizes are now translated correctly. Fixes #489 and #510.ggplotly()
on a plot with geom_line
and group
aesthetic wrong tooltip information was shown. Fixes #774.colors
argument.colorbar()
function gains a new limits
arguments for controlling the colorscale
limits.z
is now required in add_heatmap()
. If you want a z
to be computed, use add_histogram()
.split
, replaces the old functionality of the now deprecated group
argument by creating one trace per value.subplot()
without a specified color (once again) match the coloring defaults supplied by plotly.js (see #724).subplot()
colorbar()
function now works on colorbars generated via z
mapping.plot_mapbox()
and plot_geo()
functions, which make it easier to work with the "scattermapbox", "scattergeo", and "choropleth" trace types. See the maps chapter of the plotly book for some examples -- https://cpsievert.github.io/plotly_book/maps.html subplot()
now accepts, and correctly scales mapbox objects.add_mesh3d()
and add_pie()
functions as wrappers around the "mesh3d", and "pie" trace types.add_scattergeo()
and add_choropleth()
functions have been deprecated in favor of plot_geo()
. add_area(...)
function changed it's meaning from add_lines(..., fill = 'tozeroy')
to a wrapper around the area trace https://plot.ly/r/reference/#area. This is more consistent with the naming conventions already in place for other add_()
functions.add_ribbons()
now shows points (instead of fill) on hover.rangeslider()
function to make it easier to add a range slider to the x-axis.colorbar()
function to make it easier to modify an automatically generated colorbar.plot_ly(mpg, x = ~cty, y = ~hwy, symbol = ~factor(cyl), color = ~factor(cyl))
)inherit
argument for all add_()
functions to avoid inheriting attributes from plot_ly()
.add_fun()
function to add layers to a plot without modifying the original data associated with a plotly object.add_annotations()
function to make it easier to add annotations.layerData
argument to ggplotly()
to make it possible to retrieve the data from a particular ggplot2 layer.marker.line.color
is now transparent by default.marker.colorbar
.add_choropleth()
previously wasn't relaying the z
attribute.add_segments()
(resulting in incorrect axis category order).plot_ly()
when the number of traces is a multiple of ten.event_data()
now works inside shiny modules (#659). For an example, see https://github.com/ropensci/plotly/tree/master/inst/examples/plotlyShinyModulesadd_bars()
.as_widget()
function was exported to make it easier to convert a list
(adhering to the plotly spec) to a plotly htmlwidget object. This should only be needed when "manually" editing the underlying list object.plotlyOutput()
. In order to make this possible, ggplotly()
now has a method for plotly objects (the identity function), and ggplotly()
called on any expression provided to plotlyOutput()
.geom_text()
.last_plot()
can now be used to retrieve the most recently printed plotly graph. Thanks to this new feature, when plotly_POST()
is called with no plotly object supplied, the most recently printed plotly graph is sent to the users plotly account.colors
/symbols
/linetypes
arguments now accept named character vectors.
The names specify the domain (i.e., data values) and the values specify the range
(i.e., visual encodings). This is mainly useful to ensure a particular
(discrete) data value is mapped to a particular visual attribute (yes, this is similar, in spirit, to ggplot2's scale_*_manual()
).scales::shape_pal()
and scales::linetype_pal()
.color
/symbol
/linetype
, domain values are
sorted alphabetically before scales are applied. Also, when mapping a factor to color
/symbol
/linetype
, domain values are sorted according to their factor levels before scales are applied. This leads to more consistent (categorical axis ordering behaves similarly) and predictable (compared to having values sorted in the order in which they appear) behavior.alpha
is now applied when color
isn't specified (fixes #658).plot_ly()
now orders the categories of a discrete x/y axis according the level ordering (if a factor) or alphabetical order (if a character string). Fixes #578.ggplotly()
gains a new originalData
argument which allows one to attach either the original (global) data, or a "scaled"/"trained" version of the data used by ggplot2 to draw the graph (for a quick example, ggplotly(qplot(1:10), originalData = FALSE) %>% plotly_data()
). geom_polygon()
/geom_hex()
/geom_rect()
/geom_map()
). stat_identity()
is used, group domain values are preserved and displayed in hoverinfo.hide_guides()
/hide_legend()
were added (these work similarly to the existing hide_colorbar()
) to simply the hiding of guides (i.e., legends/colorbars).facet_wrap()
should now be correct.plot_ly(mtcars, x = wt, y = mpg, color = vs)
should now be plot_ly(mtcars, x = ~wt, y = ~mpg, color = ~vs)
. This is a major breaking change, but it is necessary to ensure that evaluation is correct in all contexts (as a result, evaluate
argument is now deprecated as it is no longer needed). It also has the benefit of being easier to program with (i.e., writing your own custom functions that wrap plot_ly()
) since it preserves referential transparency. For more details, see the lazyeval vignetteas.widget()
function has deprecated, and serialization/memory leak problems are no longer an issue. This change also implies that arbitrary data manipulation functions can no longer be intermingled inside a plot pipeline, but plotly methods for dplyr's data manipulation verbs are now provided (see ?plotly_data
for examples).group
variable mapping no longer create multiple traces, but instead defines "gaps" within a trace (fixes #418, #381, #577). Groupings should be declared via the new group_by()
function (see help(plotly_data)
for examples) instead of the group
argument (which is now deprecated).plot_ly()
now initializes a plotly object (i.e., won't add a scatter trace by default), meaning that something like plot_ly(x = 1:10, y = 1:10) %>% add_trace(y = 10:1)
creates one trace, instead of two. That being said, if you manually specify a trace type in plot_ly()
, it will add a layer with that trace type (e.g. plot_ly(x = 1:10, y = 1:10, type = "scatter") %>% add_trace(y = 10:1)
draws two scatter traces). If no trace type is provided, a sensible type is inferred from the supplied data, and automatically added (i.e., plot_ly(x = rnorm(100))
now creates a histogram).inherit
argument is deprecated. Any arguments/attributes specified in plot_ly()
will automatically be passed along to additional traces added via add_trace()
(or any of it's add_*()
siblings).color
, symbol
, size
) is applied at the plot-level, instead of the trace level. linetype
/linetypes
arguments for mapping discrete variables to line types (works very much like the symbol
/symbols
).I()
(closes #428). This is mainly useful for changing default appearance (e.g. plot_ly(x = 1:10, y = 1:10, color = I("red"))
).pch
and lty
values (e.g. plot_ly(x = 1:25, y = 1:25, symbol = I(0:24))
)alpha
argument controls the alpha transparency of color
(e.g. plot_ly(x = 1:10, y = 1:10, color = I("red"), alpha = 0.1)
).sizes
argument for controlling the range of marker size scaling.add_polygons()
/add_ribbons()
/add_area()
/add_segments()
/add_lines()
/add_markers()
/add_paths()
/add_text()
functions provide a shorthand for common special cases of add_trace()
.toWebGL()
function for easy conversion from SVG to WebGL.export()
function makes it easy to save plots as png/jpeg/pdf (fixes #311).plotly_data()
function for returning/inspecting data frame(s) associated with a plotly object.plotly_json()
function for inspecting the data sent to plotly.js (as an R list or JSON).layout()
is now a generic function and uses method dispatch to avoid conflicts with graphics:layout()
(fixes #464).3.6.5 -- 10 June 2016
IMPROVEMENT:
Multiple rows of facet strips will now be separated by (i.e., line breaks) instead of ,. See #593.
3.6.4 -- 31 May 2016
BUG FIX:
embed_notebook() will no longer use a '.embed' extension in the iframe src attribute. See #613.
3.6.3 -- 24 May 2016
CHANGES:
Provided a better way of reexporting magrittr::%>%
. See #597.
3.6.2 -- 24 May 2016
CHANGES:
Removed unnecessary plyr dependency.
3.6.1 -- 23 May 2016
BUG FIX:
Add a default method for plotly_build. Fixes #592.
3.6.0 -- 16 May 2016
NEW FEATURES & CHANGES:
A new vignette with examples and more explanation can be accessed via vignette("subplot")
.
ggplotly() is now a generic function with a method for ggmatrix objects.
BUG FIX:
Column facet strips will no longer be drawn when there is only one column.
3.5.7 -- 13 May 2016
CHANGES:
Better defaults for defaultWidth/defaultHeight in the htmlwidget's sizing policy.
BUG FIX:
Pass knitr options to the named argument options. Fixes #582.
3.5.6 -- 12 May 2016
BUG FIX:
Use .embed suffix in iframe src attribute. Fixes #581.
3.5.5 -- 5 May 2016
CHANGES:
ggplotly() will now use plotly's layout.axisid.title (instead of layout.annotations) for axis titles on non-faceted plots. This will make for a better title placement experience (see #510).
BUG FIX:
Space for interior facet_wrap() strips are now accounted for.
3.5.4 -- 5 May 2016
BUG FIX:
gg2list() now returns an object of class "plotly_built" instead of "plotly" to ensure a sensible print method is invoked.
3.5.3 -- 3 May 2016
CHANGES:
Upgrade to plotlyjs v1.10.1 -- https://github.com/plotly/plotly.js/releases/tag/v1.10.1
3.5.2 -- 2 May 2016
BUG FIX:
Added missing key properties in ggplotly() converter so selections can be accessible via event_data().
3.5.1 -- 26 Apr 2016
CHANGES:
Upgrade to plotlyjs v1.10.0 -- https://github.com/plotly/plotly.js/releases/tag/v1.10.0
Distinguish between "built" (plotly_built) and "non-built" (plotly_hash) plotly objects. See #562
3.5.0 -- 19 Apr 2016
NEW FEATURES:
The toRGB() function will now respect alpha channels in hex color codes and can recursively apply alpha.
CHANGES:
The toRGB() function will always output color codes with an alpha channel (e.g. toRGB('black') is now 'rgba(0,0,0,1)' instead of 'rgb(0,0,0)')
3.4.15 -- 18 Apr 2016
BUGFIX:
The alpha in geom_smooth was incorrectly inheriting from other layers. See #551.
3.4.14 -- 15 Apr 2016
CHANGES:
Upgrade to plotlyjs v1.9.0 -- https://github.com/plotly/plotly.js/releases/tag/v1.9.0
3.4.13 -- 6 Apr 2016
BUGFIX:
In some cases, marker color was inheriting from the marker line color when it shouldn't have. See ##537.
3.4.12 -- 5 Apr 2016
CHANGES:
Upgrade to plotlyjs v1.8.0 -- https://github.com/plotly/plotly.js/releases/tag/v1.8.0
3.4.11 -- 2 Apr 2016
BUGFIX:
Fix bug when altering modebar button defaults
3.4.10 -- 1 Apr 2016
BUGFIX:
Fix a geom_errorbar bug introduced in 3.4.9. See #513.
3.4.9 -- 25 Mar 2016
BUGFIX:
Upgrade to plotlyjs 1.7.0. Fixes #513
3.4.8 -- 23 Mar 2016
BUGFIX:
3.4.7 -- 19 Mar 2016
BUGFIX:
3.4.6 -- 17 Mar 2016
NEW FEATURES:
The 'plotly_relayout' event is now accessible via the event_data() function.
Fixed #514.
3.4.5 -- 17 Mar 2016
BUGFIX:
Fixed #514.
3.4.4 -- 17 Mar 2016
BUGFIX:
Show discrete positional values in tooltip (see #515); better GeomTile conversion; pass plot object into layers2traces.
3.4.3 -- 14 Mar 2016
BUGFIX:
Custom facet labeller functions will now translate correctly. See #507.
3.4.2 -- 14 Mar 2016
BUGFIX:
Automatic resizing will now occur only when layout.autosize is true (the default). See #403.
3.4.1 -- 13 Mar 2016
BUGFIX:
Legend titles are now supported.
3.4.0 -- 12 Mar 2016
NEW FEATURES:
CHANGES:
BUGFIX:
3.3.1 -- 10 Mar 2016
CHANGES:
BUGFIX:
3.2.1 -- 10 Mar 2016
BUGFIX:
3.2.0 -- 10 Mar 2016
CHANGES:
NEW FEATURES:
3.1.0 -- 8 Mar 2016
CHANGES:
3.0.0 -- 8 Mar 2016
NEW FEATURES:
CHANGES:
BUG FIXES:
2.5.0 -- 1 Mar 2016
NEW FEATURES
New event_data() function provides easy access to plotly events in shiny. For an example, see https://github.com/ropensci/plotly/tree/master/inst/examples/plotlyEvents
plot_ly() and ggplotly() gain a source argument to differentiate between plotly events in shiny apps with multiple plots. ggplotly() also gains width and height arguments.
CHANGES
The arguments filename, fileopt, world_readable in ggplotly() were removed as they should be provided to plotly_POST() instead.
2.4.4 -- 13 Feb 2016
as.widget() now returns htmlwidget objects untouched. See #449.
2.4.3 -- 11 Feb 2016
Ensure that we always return HTTPS links. Fixes #455
2.4.2 -- 9 Feb 2016
Fix for on-premise domain configuration.
2.4.1 -- 2 Feb 2016
Attach base_url in as.widget() so it works in multiple contexts
2.4.0 -- 1 Feb 2016
2.3.4 -- 1 Feb 2016
Added a plotly_api_domain environment variable for configuring the API domain. Fixes #441
2.3.3 -- 27 Jan 2016
Bump axis number for each trace matching a panel number. fixes #318
2.3.2 -- 25 Jan 2016
More accurate list of data_array properties. Fixes #415
2.3.1 -- 25 Jan 2016
More accurate conversion of path width. Fixes #373.
2.3.0 -- 19 Jan 2016
Add sharing argument and deprecate world_readable. Fixes #332
2.2.4 -- 18 Jan 2016
Fix for error in embed_notebook(). See #409.
2.2.3 -- 18 Jan 2016
Fix for geom_vline(). See #402.
2.2.2 -- 18 Jan 2016
Fix bar orientation when we detect geom_bar() + coord_flip() in ggplotly(). Fixes #390.
2.2.1 -- 18 Jan 2016
Search for axis title in scene object. fixes #393.
2.2.0 -- 13 Jan 2016
The default for layout.hovermode is now 'closest' for non-line scatter traces
2.1.3 -- 12 Jan 2016
Fix size and alpha translation for geom_point. Fixes #386
2.1.2 -- 11 Jan 2016
Upgraded to plotlyjs 1.4.1. For a list of changes, see https://github.com/plotly/plotly.js/releases/tag/v1.4.1
2.1.1 -- 11 Jan 2016
Upgraded to plotlyjs 1.4. For a list of changes, see https://github.com/plotly/plotly.js/releases/tag/v1.4.0
2.1.0 -- 29 Dec 2015
plot_ly() now defaults to inherit=FALSE and plotly_build() is now idempotent. Fixes #280 and #277. See #368 for details.
2.0.19 -- 23 Dec 2015
Added as.widget() function for conveniency in converting plotly object to htmlwidget objects. See #294.
2.0.18 -- 22 Dec 2015
Fix #365
2.0.17 -- 22 Dec 2015
Fix #358
2.0.16 -- 18 Dec 2015
Require ggplot2 2.0.0 or higher. For details, see #269.
2.0.15 -- 13 Dec 2015
Fix #346
2.0.14 -- 13 Dec 2015
Fix #212
2.0.13 -- 12 Dec 2015
Fix #286
2.0.12 -- 11 Dec 2015
Fix #221
2.0.11 -- 11 Dec 2015
Fix #250
2.0.10 -- 10 Dec 2015
Fix #225
2.0.9 -- 10 Dec 2015
Fix #333
2.0.8 -- 10 Dec 2015
Fix a bug with geom_segment (see #321 & #228)
2.0.7 -- 10 Dec 2015
Fix #233
2.0.6 -- 2 Dec 2015
Upgrade to plotlyjs 1.1.1. Fixes #319.
2.0.5 -- 1 Dec 2015
Fix for legend names. See #236.
2.0.4 -- 28 Nov 2015
Fix #313.
2.0.3 -- 18 Nov 2015
Fixed bug causing knitr options to be ignored. Also added VignetteBuilder to DESCRIPTION to vignette is available.
2.0.2 -- 17 Nov 2015
Using plotly_build() on a ggplot object should always return a plotly object
2.0.1 -- 17 Nov 2015
Better printing of server figures. Documentation and other fixes for initial CRAN release!
2.0.0 -- 2 Nov 2015
Added a dependency on htmlwidgets and 'offline' plots are now the default. If you want to create a figure on a plotly server, you need to use plotly_POST()
. Also added a config()
function to control the default appearance of the interactive plot
1.0.10 -- 3 Nov 2015
Fixed #292.
1.0.9 -- 28 Sep 2015
Fixed filename, fileopt arguments in plot_ly. Specifying the same filename will now overwrite the plot if it exists.
1.0.8 -- 14 Sep 2015
Added the plotly_IMAGES() function which interfaces to the images endpoint https://api.plot.ly/v2/#images
Details -> https://github.com/ropensci/plotly/pull/279
1.0.7 -- 26 Aug 2015
See https://github.com/ropensci/plotly/pull/275
1.0.6 -- 25 Aug 2015
Fix a bug with subplot domain calculations (see https://github.com/ropensci/plotly/pull/274)
1.0.5 -- 20 Aug 2015
Fix issue converting plotly offline markdown documents to HTML when using markdown::markdownToHTML
1.0.4 -- 14 Aug 2015
Bug fix for subplot. See #265
1.0.3 -- 7 Aug 2015
Improved legend positioning. See #241
1.0.2 -- 2 Aug 2015
1.0.1 -- 2 Aug 2015
Removed the stream() function as it wasn't ready to be included.
1.0.0 -- 31 July 2015
A major reworking of package internals which includes a few backwards incompatible changes.
Major changes include:
(1) New high-level grammar for expressing Plotly graphs from R (see the plot_ly()
, add_trace()
, layout()
, and style()
functions).
(2) New print methods which make it easier to create, modify, and embed Plotly graphs.
(3) Added a subplot()
function for putting several graphs on a single page.
(4) Added the renderPlotly()
and plotlyOutput()
functions for embedding plotly graphs in shiny applications.
(5) Added offline()
function for creating standalone HTML pages via Plotly Offline (see http://purchasing.plot.ly/)
For more details, see the new vignettes with browseVignettes(package = "plotly")
and/or the pull request -> https://github.com/ropensci/plotly/pull/226
0.6.3 -- 2 June 2015
Add new tests inspired by the R Cookbook distributions #214
0.6.2 -- 19 May 2015
In geom_bar(stat = "identity"), sum y values if multiple for a given x.
0.6.1 -- 5 May 2015
Add test-cookbook-lines.R and fix bugs that showed up in those tests.
0.6 -- 4 May 2015
Let gg2list() return a figure object (backwards incompatible change).
0.5.29 -- 16 April 2015
geom_density() as filled area chart #202
0.5.28 -- 15 April 2015
Let ggplot handle histogram binning. Fix #198
0.5.27 -- 19 Mar 2015
Reimplement geom_ribbon as a basic polygon. Fix #191. Fix #192.
0.5.26 -- 18 Mar 2015
Implemented geom_rect #178
0.5.25 -- 10 March 2015
Implemented geom_smooth() #183
0.5.24 -- 10 March 2015
Implemented facet_wrap(scales="free") #167
0.5.23 -- 10 March 2015.
geom_ribbon() now respects alpha transparency
0.5.22 -- 2 March 2015.
Fixes for ylim() #171.
0.5.21 -- 23 February 2015.
Fixes for error bars and tick marks.
0.5.20 -- 9 February 2015.
Add alpha transparency to fill conversion. Let geom_area support colour and fill aesthetics.
0.5.19 -- 23 January 2015.
Support class conversion such as as.Date() within ggplot code.
0.5.18 -- 22 January 2015.
Return proper filepath when filename contains directories.
0.5.17 -- 30 December 2014.
Support date-time binning in histograms.
0.5.16 -- 29 December 2014.
Support colour aesthetic in geom_text().
0.5.15 -- 19 December 2014.
Use proper RCurlOptions in get_figure() method.
0.5.14 -- 1 December 2014.
Make layers geom_line + geom_point only one trace in Plotly.
0.5.13 -- 27 November 2014.
Rename translation file and server endpoint parameter to be hip.
0.5.12 -- 12 November 2014.
Improve legend title position.
0.5.11 -- 11 November 2014.
Show legend title.
0.5.10 -- 7 November 2014.
Improve showlegend and fix legend’s x
position.
0.5.9 -- 3 November 2014.
Default colours for geom_polygon().
0.5.8 -- 30 October 2014.
Support hline over a factor x range. Default colours for geom_boxplot().
0.5.7 -- 29 October 2014.
Default colours for geom_area() and geom_ribbon().
0.5.6 -- 28 October 2014.
Convert line size faithfully.
0.5.5 -- 24 October 2014.
Support category histograms (with factors).
0.5.4 -- 22 October 2014.
Support conversion of geom_vline().
0.5.3 -- 21 October 2014.
Support conversion of geom_bar() with position_dodge().
0.5.2 -- 18 October 2014.
Support aesthetic shape in geom_path() and, hence, geom_line() (conversion).
0.5.1 -- 15 October 2014.
Do not show zero lines by default (as in ggplot2 plots).
0.5.0 -- 15 October 2014.
From now on, version numbers are meaningful again... Many changes meanwhile, especially support for more geoms.
0.4 -- 7 April 2014.
Re-write geom to trace conversion code.
0.3.8 -- 21 March 2014.
ggplotly takes the last_plot() by default.
Support for ggplotly layout elements title, tickcolor, gridcolor, showlegend, plot_bgcolor, paper_bgcolor, tickangle, axis titles, plot border colors.
0.3.7 -- 14 March 2014.
For ggplotly:
if on the command line, open a web browser (as before).
if in knitr/Rmd in a chunk with plotly=TRUE, embed the plot.
0.3.6 -- 10 March 2014.
Merge ggplotly code.
0.3.5
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.