v3.1.0

[3.1.0] - 2018-07-20

JupyterLab Versions

For use with JupyterLab, the following versions of the following packages
must be installed. See README.md for instructions.

• Python Packages

  • plotly==3.1.0
  • ipywidgets>=7.2
  • notebook>=5.3
  • jupyterlab==0.32.1

• JupyterLab Extensions

  • plotlywidget@0.2.0
  • @jupyter-widgets/jupyterlab-manager@0.35
  • @jupyterlab/plotly-extension@0.16

Updated

• Updated Plotly.js to version 1.39.2
• See highlights below
• See the plotly.js CHANGELOG for more information.

Added

• Added 3D streamtube traces
  plotly/plotly.js#2658
• Added support for on-graph text in scattergl traces
• Added gridshape attribute to polar subplots with values 'circular' (the default) and 'linear' (to draw polygon grids)
  plotly/plotly.js#2739

v3.0.2

[3.0.2] - 2018-07-17

This is a minor bug-fix release to 3.0.0

JupyterLab plotlywidget version: 0.1.1

Plotly.js version: 1.38.3

Fixed

• Several errors related to numbered subplot labels (e.g. xaxis2, polar3, etc.)
  GH1057
• Error where the v property was ignored in cone traces
  GH1060
• Assorted performance improvements when constructing graph objects
  GH1061

v3.0.0

[3.0.0] - 2018-07-05

This is a major version with many exciting updates. See the Introducing plotly.py 3.0.0 post for more information.

JupyterLab plotlywidget version: 0.1.1

Plotly.js version: 1.38.3

Added

• Full Jupyter ipywidgets integration with the new graph_objs.FigureWidget class
• FigureWidget figures can be updated interactively using property assignment syntax
• The full trace and layout API is generated from the plotly schema to provide a great experience for interactive use in the notebook
• Support for setting array properties as numpy arrays. When numpy arrays are used, ipywidgets binary serialization protocol is used to avoid converting these to JSON strings.
• Context manager API for animation. Run help(go.Figure().batch_animate) for the full doc string.
• Perform automatic retries when communicating with plot.ly services. This introduces a new required dependency on the retrying library.
• Improved data validation covering the full API with clear, informative error messages. This means that incorrect properties and/or values now always raise a ValueError with a description of the error, the invalid property, and the available properties on the level that it was placed in the graph object. Eg. go.Scatter(foo=123) raises a validation error. See https://plot.ly/python/reference/ for a reference to all valid properties and values in the Python API.
• Error message for plotly.figure_factory.create_choropleth is now helpful to Anaconda users who do not have the correct modules installed for the County Choropleth figure factory.

Changed / Deprecated

Please see the migration guid for a full list of the changes and deprecations in version 3.0.0

v2.0.0

Same as the pre-release, but this one corresponds to the 2.0.0 on PyPI and is the first official 2.x release. Please note the deprecation section from the changelog (copied below for convenience).

[2.0.0] - 2017-01-25

Changed

• plotly.exceptions.PlotlyRequestException is always raised for network
  failures. Previously either a PlotlyError, PlotlyRequestException, or a
  requests.exceptions.ReqestException could be raised. In particular, scripts
  which depend on try-except blocks containing network requests should be
  revisited.
• plotly.py:sign_in now validates to the plotly server specified in your
  config. If it cannot make a successful request, it raises a PlotlyError.
• plotly.figure_factory will raise an ImportError if numpy is not
  installed.
• plotly.figure_factory.create_violin() now has a rugplot parameter which
  determines whether or not a rugplot is draw beside each violin plot.

Deprecated

• plotly.tools.FigureFactory. Use plotly.figure_factory.*.
• (optional imports) plotly.tools._*_imported It was private anyhow, but now
  it's gone. (e.g., _numpy_imported)
• (plotly v2 helper) plotly.py._api_v2 It was private anyhow, but now it's
  gone.

v2.0.0-pre

[2.0.0]

Most notably, this changes how exceptions are handled and raised for all network requests. See CHANGELOG.md for more details (copied below for convenience).

Changed

• plotly.exceptions.PlotlyRequestException is always raised for network
  failures. Previously either a PlotlyError, PlotlyRequestException, or a
  requests.exceptions.ReqestException could be raised. In particular, scripts
  which depend on try-except blocks containing network requests should be
  revisited.
• plotly.py:sign_in now validates to the plotly server specified in your
  config. If it cannot make a successful request, it raises a PlotlyError.
• plotly.figure_factory will raise an ImportError if numpy is not
  installed.

Deprecated

• plotly.tools.FigureFactory. Use plotly.figure_factory.*.
• (optional imports) plotly.tools._*_imported It was private anyhow, but now
  it's gone. (e.g., _numpy_imported)
• (plotly v2 helper) plotly.py._api_v2 It was private anyhow, but now it's
  gone.

v1.13.0

[1.13.0] - 2016-01-17

Added

• Python 3.5 has been added as a tested environment for this package.

Updated

• plotly.plotly.create_animations and plotly.plotly.icreate_animations now return appropriate error messages if the response is not successful.
• frames are now integrated into GRAPH_REFERENCE and figure validation.

Changed

• The plot-schema from https://api.plot.ly/plot-schema is no longer updated on import.

1.6.12 - stable strict json encoder, ci fixes

• Previous version (1.6.11) of custom json encoder only supported python 2.7.
• Previous PATH env variable in circle needed adjusting to properly run python versions

1.6.8 - Remove fullData from IPython widget callbacks

#196

1.6.7

Adding plotly.widget.GraphWidget.plot method for folks to use their existing graph objects with the graph widget.