v5.17.0

Updated

• Improved json docstrings, added BasePlotlyType.to_json() method [#4301]
• Updated Plotly.js from version 2.25.2 to version 2.26.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add "min", "max", "min reversed" and "max reversed" autorange options and handle partial ranges (i.e. one end being null), add autorangeoptions (clipmin, clipmax, minallowed, maxallowed, include) as well as minallowed and maxallowed to cartesian, gl3d and radial axes [#6547]
  • Add [n]-sigma (std deviations) box plots as an alternative to quartiles [#6697], with thanks to @28raining for the contribution!
  • Add "top left" & "top center" side options to legend title [#6711], with thanks to @28raining for the contribution!
  • Add "false" option to scaleanchor to allow removing a constraint that is set by default [#6712], with thanks to @lvlte for the contribution!

Fixed

• Fixed two issues with px.imshow: [#4330] when facet_col is an earlier dimension than animation_frame for xarrays and [#4329] when facet_col has string coordinates in xarrays [#4331]

v5.16.1

Fixed

• Fixed issue with necessary columns from complex arguments dropped when interchanging dataframes [#4324]

v5.16.0

Updated

• Updated Plotly.js from version 2.24.1 to version 2.25.2. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add "Equal Earth" projection to geo subplots [#6670],
    with thanks to @apparebit for the contribution!
  • Add options to include legends for shapes and newshape [#6653]
• px methods now accept data-frame-like objects that support a dataframe interchange protocol, such as polars, vaex, modin etc. This protocol has priority on to_pandas call, but will only be used if pandas>=2.0.2 is installed in the environment.
• px methods now accept data-frame-like objects that support a toPandas() method, such as Spark DataFrames, or a to_pandas_df() method, such as Vaex DataFrames.

Fixed

• Fixed Pandas performance warning issue caused by multiple frame.insert [#4246]

v5.15.0

Updated

• Updated Plotly.js from version 2.20.0 to version 2.24.1. See the plotly.js CHANGELOG for more information. Notable changes include:
  • Add pattern to pie, funnelarea, sunburst, icicle and treemap traces [#6601, #6619, #6622, #6626, #6627, #6628, #6629], with thanks to @thierryVergult for the contribution!
  • Add texttemplate to shape.label for parametric shapes i.e. line, rect and circle [#6527],
    with thanks to the Volkswagen Center of Excellence for Battery Systems for sponsoring development!
  • Add strict option to custom bundle command [#6557],
    with thanks to @CallumNZ for the contribution!
  • Add legend references to traces and legend2, legend3, etc. to layout,
    also add visible to legend i.e. to allow positioning multiple legends on a graph [#6535],
    this feature was anonymously sponsored: thank you to our sponsor!
  • Add legend.xref and legend.yref to enable container-referenced positioning of legends [#6589], with thanks to Gamma Technologies for sponsoring the related development.
  • Add colorbar.xref and colorbar.yref to enable container-referenced positioning of colorbars [#6593], with thanks to Gamma Technologies for sponsoring the related development.
• px methods now accept data-frame-like objects that support a to_pandas() method, such as polars, cudf, vaex etc

Fixed

• Fixed another compatibility issue with Pandas 2.0, just affecting px.*(line_close=True) [#4190]
• Empty pandas dataframe with facet row/column set no longer fails [#4038]
• Added some rounding to the make_subplots function to handle situations where the user-input specs cause the domain to exceed 1 by small amounts [#4153]
• Sanitize JSON output to prevent an XSS vector when graphs are inserted directly into HTML [#4196]
• Fixed issue with shapes and annotations plotting on the wrong y axis when supplied with a specific axis in the yref parameter [#4177]
• Remove use_2to3 setuptools arg, which is invalid in the latest Python and setuptools versions [#4206]
• Fix #4066 JupyterLab v4 giving tiny default graph height [#4227]
• Fixed issue with colors.n_colors where generated RGB color values were not being constrained to stay between 0 and 255 [#4110]
• Fix streamline figure factory with recent versions of Numpy
• Fix issue with shapes and annotations not drawing on correct axis [#4177]

v5.14.1

Fixed

• Fixed compatibility issue with Pandas 2.0 [#4103]

v5.14.0

Updated

• Updated Plotly.js from version 2.18.2 to version 2.20.0. See the plotly.js CHANGELOG for more information. Notable changes include:
  • Add title.automargin to enable automatic top and bottom margining for both container and paper referenced titles [#6428],
    with thanks to Gamma Technologies for sponsoring the related development.
  • Add label attribute to shapes [#6454], with thanks to the Volkswagen Center of Excellence for Battery Systems for sponsoring development!
  • Add labelalias to various axes namely cartesian, gl3d, polar, smith, ternary, carpet,
    indicator and colorbar [#6481],
    this feature was anonymously sponsored: thank you to our sponsor!
• Key errors no longer precalculated when performing updates on plots [#4101]

Fixed

• Fixed an issue with characters displaying incorrectly, by adding charset="utf-8" to scripts in to_html [#4114]
• Added packaging to install requirements, fixing a No module named 'packaging error on Python 3.6 [#4113]

Added

• Added option to allow passing a column name as a str in hover_data and custom_data in plotly.express [4083]

v5.13.1

Updated

• Updated Plotly.js to from version 2.18.0 to version 2.18.2. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module.
• Updated distutils.Version to packaging.Version #3897] and #4055]

v5.13.0

See the full release announcement with graphical examples on the forum: https://community.plotly.com/t/announcing-plotly-py-5-13-0-grouped-scatter-new-markers-and-marker-angles-sankey-links-with-arrows/72205

Updated

• Updated Plotly.js to from version 2.17.1 to version 2.18.0. See the plotly.js CHANGELOG for more information. Notable changes include:
  • Add sync tickmode option [#6356, #6443], with thanks to @filipesantiagoAM and @VictorBezak for the contribution!
• Build process now uses Node 18.x and version 2 lockfile (should be an invisible change for users) [#4034]

Fixed

• write_html() now explicitly encodes output as UTF-8 because Plotly.js' bundle contains such characters [#4021] and [#4022]
• fixed iframe renderer regression from 5.12 and also fixed error when this renderer was used in the very first cell in a notebook [#4036]

v5.12.0

Updated

• Support for ipywidgets 8 [#3930]
• Updated Plotly.js to from version 2.16.1 to version 2.17.1. See the plotly.js CHANGELOG for more information. Notable changes include:
  • Add shift and autoshift to cartesian y axes to help avoid overlapping of multiple axes [#6334],
    with thanks to Gamma Technologies for sponsoring the related development!
  • Introduce group attributes for scatter trace i.e. alignmentgroup, offsetgroup, scattermode and scattergap [#6381],
    this feature was anonymously sponsored: thank you to our sponsor!
  • Add marker.cornerradius attribute to treemap trace [#6351]

Fixed

• Fixed the usage of some deprecated NumPy types which were removed in NumPy 1.24 [#3997]
• Fixed bug for trendlines with datetime axes [#3683]
• marker.angle attribute now accepts iterables where appropriate [#4013]
• selector=0 now correctly returns the first trace in .select_traces() and related methods [#3817]

v5.11.0

Updated

• Updated Plotly.js to from version 2.14.0 to version 2.16.1. See the plotly.js CHANGELOG for more information. Notable changes include:
  • Add clustering options to scattermapbox [#5827],
    with thanks to @elben10 for the contribution!
  • Add bounds to mapbox suplots [6339]
  • Add angle, angleref and standoff to marker and add backoff to line; also introduce new arrow symbols to facilitate drawing networks [#6297]
  • Add minreducedwidth and minreducedheight to layout for increasing control over automargin [#6307]
  • Add entrywidth and entrywidthmode to legend [#6202, #6324]