v4.7.0

Updated

• Updated Plotly.js to version 1.54.1. See the plotly.js CHANGELOG for more information. The main new feature of this version of Plotly.js is the possibility to draw layout shapes, using custom dragmodes and corresponding modebar buttons.
• The sphinx-gallery scraper has been updated to work with different structures of galleries #2149

Added

• The hover_data parameter of px functions can now be a dictionary. This makes it possible to skip hover information for some arguments or to change the formatting of hover informatiom #2377.
• It's now possible to build a development version of Plotly.py against the build artifacts from a non-master branch of Plotly.js, which makes for faster QA and development cycles #2349. Thanks @zouhairm for this Pull Request!

Fixed

• Plotly Express trendlines now handle missing data correctly #2357

Performance

This version includes several performance improvements (#2368, #2403).

• Child graph objects (e.g. figure.layout.xaxis) are no longer created eagerly during graph object construction. Instead, they are created lazily the first time the property is accessed.
• Property validation is now disabled for select internal operations.
• When used with Python 3.7 and above, ploty.py now takes advantage of PEP-562 to perform submodule imports lazily. This dramatically improves import times.

v4.6.0

Updated

• Updated Plotly.js to version 1.53.0. See the plotly.js CHANGELOG for more information on the numerous new features and bug fixes of this release. The main features of the Plotly.js release are
  • Introduce range breaks on date axes (for example, to remove week-ends) via layout.xaxis.rangebreaks
  • Introduce a new unified x (or y) hovermode (layout.hovermode="x unified"), in which the hover box shows the information for all traces at a given x (or y) position
  • Add node.customdata and link.customdata to sankey traces
• Updated contributing notes for more explanations on how to contribute to plotly.py #2290. Please give feedback on these notes!
• Updated documentation examples #2325, and to show how to color links in Sankey diagrams #2291.
• Special thanks to @SylwiaOliwia2 and @dangercrow for improving our documentation!

Added

• px.imshow now accepts xarray inputs, with metadata being used for axis labels, hover and colorbar #2166

Fixed

• Fixed handling of opacity in px.pie, px.funnel_area, px.density_mapbox, px.funnel #2317, with thanks to @tvaucher for the contribution!

v4.5.4

Updated

• The documentation of the API https://plot.ly/python-api-reference/ now
  documents the full API #2243
• New documentation examples for facets #2235, legend #2227, subplots #2226, axes #2234 and histograms #2242.
  Thanks to @SylwiaOliwia2 for all these great
  examples!

Fixed

• Jupyterlab extension now compatible with both Jupyterlab 1.2 and 2.0 #2261 with thanks to @consideRatio for the contribution!
• Fixed a bug when using boolean values for the color argument of px functions #2127
• Corrected import bug which was occuring with old versions of ipywidgets #2265
• Fixed python 3.8 syntax warning #2262, with thanks to @sgn for the contribution!

v4.5.3

Updated

• Removed development dependency on nose testing framework #2217

Fixed

• JupyterLab extension now compatible with JupyterLab 2.0 #2245 with thanks to @consideRatio for the contribution!

v4.5.2

Fixed

• Fix build errors in JupyterLab extension by pinning version of @types/plotly.js #2223

v4.5.1

Updated

• Updated Plotly.js to version 1.52.2. See the plotly.js CHANGELOG for more information on bug fixes.

Fixed

• update_annotations, update_shapes and update_layout_images now no longer require the patch argument, as per the docstring #2167
• px.defaults no longer accepts arbitrary keys #2168
• better error message when pandas is not installed #2125
• support columns of numerical type in path argument of px.sunburst/px.treemap and add values of color column in hoverlabel for px.sunburst/px.treemap #2133

v4.5.0

[4.5.0] - 2020-01-22

Updated

• Updated Plotly.js to version 1.52.1. See the plotly.js CHANGELOG for more information on numerous new attribute and bug fixes.
• Plotly Express uses the new legend.title attribute and so now has shorter trace names #2051
• The heuristic used by px.parallel_categories to determine which columns of the data frame to draw has been changed and made more configurable with the dimensions_max_cardinality argument #2102
• The simple_white colorbar styling has been streamlined #2110
• The jupyterlab-plotly and plotlywidget JupyterLab extensions should now share code when installed together, resulting in smaller JupyterLab vendor bundle sizes #2103

Fixed

• Plotly Express category_orders are now respected independent of the contents of the data set #2084
• go.Scattergl symbols now accept numeric specification #1928
• px.scatter trendline coefficients are now more readable #1984
• Built-in cyclical color scales now all have identical start and end points #2016

Added

• px.sunburst and px.treemap now accept a path argument for passing
  columns of a rectangular dataframe to build the charts #2006
• px.choropleth now accepts a user-supplied geojson attribute #2057
• px.choropleth and px.choropleth_mapbox now accept featureidkey to specify the GeoJSON field to use to match locations #2057
• px.choropleth and px.choropleth_mapbox now accept discrete color #2057
• px.bar_polar now accepts continuous color #2017
• New layout.uniformtext attribute allows for automatic standardization of font sizes across bar-like and hierarchical traces. See the plotly.js CHANGELOG for more information

v4.4.1

[4.4.1] - 2019-12-10

Fixed

• Fixed improper JSON encoding exception when the pillow module not installed #1993

v4.4.0

[4.4.0] - 2019-12-10

Added

• Extended the plotly.express functional API with 7 new functions: px.pie,
  px.sunburst, px.treemap, px.funnel, and px.funnel_area (#1909) px.density_mapbox and
  px.choropleth_mapbox #1937.
• plotly.express mapbox functions in plotly.express have new arguments center and mapbox_style #1937.
• plotly.express polar plots (scatter_polar, line_polar, bar_polar) now
  have a range_theta keyword argument for representing only an angular
  section #1969.
• All continuous colorscales now accept a _r suffix that reverses their direction #1933
• Docstrings of plotly.py are now doctested #1921.

Updated

• Updated Plotly.js to version 1.51.2. See the
  plotly.js CHANGELOG
  for more information
• The tutorials of the plotly.py documentation are
  now in the main plotly.py Github repository. Contributions in order to improve or extend the documentation are very welcome!
• plotly.express generated plots no longer have a default height of 600 pixels, instead they inherit the default height of regular figures #1990. To restore the old behavior, set px.defaults.height=600 once per session, or set the height keyword arguement to any px.function() to 600.

Fixed

• Fixed a plotly.express input bug when using data frame indices#1934
• Fixed how to display facet labels with plotly express #1966
• Fixed a bug to use correctly the zmin/zmax parameter in px.imshow for single-channel images #1981
• Clipped docstring width for better display in Jupyterlab #1939. Thank you @joelostblom!
• Fixed a bug in the case of external orca server #1915 thank you @dev-dsp!

v4.3.0

[4.3.0] - 2019-11-11

Updated

• Updated Plotly.js to version 1.51.1. See the
  plotly.js CHANGELOG
  for more information
• Improved propagation of empty templates (#1892)
• Update the add_annotations/add_shapes/add_images methods to no longer default to adding objects in paper coordinates. This allows plotly.js to determine the default reference frame based on context (#1888)
• Use the default template's background color for displaying color swatches (#1872). Special thanks to @joelostblom for this contribution!
• Improved docstrings (#1835, #1837)

Added

• Added image trace type (plotly.js#4289, plotly.js#4307, plotly.js#4313, plotly.js#4319)
• Added matplotlib-style plotly.express.imshow convenience function to display images and heatmaps (#1855, #1885)
• Added matplotlib-style simple_white template (#1864). Special thanks to @joelostblom for this contribution.
• Added support for using an externally managed orca server for image export features (#1850). Special thanks to @miriad for this contribution.
• Added facet wrapping support to plotly express functions using the new facet_col_wrap argument (#1838)