Releases: plotly/plotly.py
v5.1.0
- Updated Plotly.js from version 2.1.0 to version 2.2.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated
plotly.graph_objects
module. Notable changes include:- new
<trace>.legendgrouptitle
attribute for legend group titles - new
%h
text formatting directive for half-years - performance improvements and bug fixes
- new
v5.0.0 - a new federated Jupyter extension, Icicle charts, and Bar chart patterns
See the full release announcement here: https://community.plotly.com/t/introducing-plotly-py-5-0-0-a-new-federated-jupyter-extension-icicle-charts-and-bar-chart-patterns/54039
Updated/Changed
Items in this section may be considered backwards-incompatible changes for the purposes of Semantic Versioning but we expect the vast majority of users to be able to upgrade to version 5.0 without encountering any issues.
- Dropped support for Python older than 3.6 #3160
- Updated Plotly.js to from version 1.58.4 to version 2.1.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated
plotly.graph_objects
module. Notable changes include:- dropped support for IE9 and IE10
- dropped support for long-deprecated
graph_objects
likearea
traces andscatter.(t|r)
andlayout.(radial|angular)axis
attributes - modebar no longer has hovermode or spikeline buttons by default (can be added back with
fig.update_layout(modebar_add=["v1hovermode", "toggleSpikeLines"])
) - "Aa" text no longer appears on legend items unless
mode="text"
- In
bar
traces,textposition
now defaults to"auto"
- Font size for legend and colorbar titles now matches axis title font size (slightly bigger)
- deprecated
heatmapgl
,pointcloud
traces as well as alltransform
attributes
- Combined
plotlywidget
intojupyterlab-plotly
and packaged them as a federated extension #3142 with massive thanks to @fcollonval for the contribution- In addition to this change, large Plotly.js bundles are now lazily loaded on-demand by JupyterLab
- Plotly.js CDN url will now be versioned by default for HTML exports using
include_plotlyjs='cdn'
and for "connected" renderers. #2961 with thanks to @adehad for the contribution - Recommending Kaleido by default over Orca #3094
- Replaced
retrying
dependency withtenacity
#2911 with thanks to @jmsmdy for the contribution - Plotly Express now always takes into account every value in
category_orders
when computing discrete mappings (color, symbol, line-dash, pattern-shapes) as well as facets, even those values which are absent in the data #3247
Added
- Additions due to bumping Plotly.js from 1.58.4 to 2.1.0 (see changelog):
- New
icicle
trace type, with thanks to @Kully and @mtwichan of Zyphr for their contribution! - New
marker.pattern
options forbar
-like trace types with thanks to @s417-lama for the contribution! - New
legendrank
attribute to control rank of traces within legends
- New
- Plotly Express'
px.bar()
,px.histogram()
andpx.bar_polar()
now support thepattern_shape
argument #3252 - New Plotly Express
px.icicle()
function, with thanks to @Kully and @mtwichan of Zyphr for their contribution! #3256 - New functions in
plotly.colors
:get_colorscale()
andsample_colorscale()
#3136 and #3186 with thanks to @CarlAndersson for the contributions - Faster JSON encoding when
orjson
is present #2955
Fixed
- Pandas and Numpy datetime serialization fixes #3022
- Fixed selected points of histograms in FigureWidget #2771 with thanks to @meffmadd for the contribution
- Static image export now honors
layout.(width|height)
#3240 - Improvements to "matplotlylib" conversion utility in
plotly.tools.mpl_to_plotly()
with thanks to @fdion #3143
v5.0.0rc2
Find out more about the RC process on our Forum: https://community.plotly.com/t/plotly-py-5-0-is-coming-soon-try-the-release-candidate-today/53470
Updated
- Updated Plotly.js to version 2.0.0. See the plotly.js 2.0.0 CHANGELOG for more information. These changes are reflected in the auto-generated
plotly.graph_objects
module. Notable changes include:- new
marker.pattern
options forbar
-like trace types - dropped support for IE9 and IE10
- dropped support for long-deprecated
graph_objects
likearea
traces andscatter.(t|r)
andlayout.(radial|angular)axis
attributes - deprecated
heatmapgl
,pointcloud
traces as well as alltransform
attributes
- new
- Combined
plotlywidget
intojupyterlab-plotly
and packaged them as a federated extension #3142 with massive thanks to @fcollonval for the contribution - Plotly.js CDN url will now be versioned by default for HTML exports using
include_plotlyjs='cdn'
and for "connected" renderers. #2961 with thanks to @adehad for the contribution - Dropped support for Python older than 3.6 #3160
- Recommending Kaleido by default over Orca #3094
- Replaced
retrying
dependency withtenacity
#2911 with thanks to @jmsmdy for the contribution
Added
- New functions in
plotly.colors
:get_colorscale()
andsample_colorscale()
#3136 and #3186 with thanks to @CarlAndersson for the contributions - Faster JSON encoding when
orjson
is present #2955
Fixed
v5.0.0rc1
Find out more about the RC process on our Forum: https://community.plotly.com/t/plotly-py-5-0-is-coming-soon-try-the-release-candidate-today/53470
Updated
- Updated Plotly.js to version 2.0.0-rc.2. See the plotly.js 2.0.0 CHANGELOG for more information. These changes are reflected in the auto-generated
plotly.graph_objects
module. Notable changes include:- new
marker.pattern
options forbar
-like trace types - dropped support for IE9 and IE10
- dropped support for long-deprecated
graph_objects
likearea
traces andscatter.(t|r)
andlayout.(radial|angular)axis
attributes - deprecated
heatmapgl
,pointcloud
traces as well as alltransform
attributes
- new
- Combined
plotlywidget
intojupyterlab-plotly
and packaged them as a federated extension #3142 with massive thanks to @fcollonval for the contribution - Plotly.js CDN url will now be versioned by default for HTML exports using
include_plotlyjs='cdn'
and for "connected" renderers. #2961 with thanks to @adehad for the contribution - Dropped support for Python older than 3.6 #3160
- Recommending Kaleido by default over Orca #3094
- Replaced
retrying
dependency withtenacity
#2911 with thanks to @jmsmdy for the contribution
Added
- New functions in
plotly.colors
:get_colorscale()
andsample_colorscale()
#3136 and #3186 with thanks to @CarlAndersson for the contributions - Faster JSON encoding when
orjson
is present #2955
Fixed
v4.14.3
v4.14.2
Updated
- JupyterLab extensions now compatible with JupyterLab 3.x 3016
- Updated Plotly.js to version 1.58.4. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated
plotly.graph_objects
module. Notable changes include:- fixes for rendering 3d plots on recent Safari versions
- fixes to inside ticklabels
- regression fixes
Fixed
v4.14.1
See the full announcement at https://community.plotly.com/t/announcing-plotly-py-4-14-faceted-and-animated-images-and-heatmaps-inside-tick-labels-better-axis-type-detection/48079
Updated
- Updated Plotly.js to version 1.58.2. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated
plotly.graph_objects
module. Notable changes include:- fixes for new
ticklabelposition
attribute - fixes for a regression related to treemaps in the previous version
- fixes for new
v4.14.0 - Faceted and Animated Images and Heatmaps, Inside Tick Labels, Better Axis Type Detection
See the full announcement at https://community.plotly.com/t/announcing-plotly-py-4-14-faceted-and-animated-images-and-heatmaps-inside-tick-labels-better-axis-type-detection/48079
Added
px.imshow
now supportsfacet_col
andanimation_frame
arguments for visualizing 3-d and 4-d images 2746px.defaults
now supportscolor_discrete_map
,symbol_map
,line_dash_map
,labels
andcategory_orders
as well as a.reset()
method 2957
Fixed
- axes will now auto-type numeric strings as categorical data rather than linear in the default templates 2951
Updated
- Updated Plotly.js to version 1.58.1. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated
plotly.graph_objects
module. Notable changes include:- a new
ticklabelposition
attribute to enable positioning tick labels inside the plotting area - better support for
scaleanchor
andmatches
on cartesian axes for matched square subplots - a new
autotypenumbers
attribute which is now set tostrict
in the default templates - various fixes relating to
automargins
for small figures
- a new
v4.13.0 - Magical Error Messages and Documentation, plus Speedups and Faceted Maps
See the fully release announcement at https://community.plotly.com/t/announcing-plotly-py-4-13-magical-error-messages-and-documentation-plus-speedups-and-faceted-maps/47497
Added
px.choropleth
,px.scatter_geo
andpx.line_geo
now support faceting as well asfitbounds
andbasemap_visible
2923px.scatter_geo
andpx.line_geo
now supportgeojson
/featureidkey
input 2923px.scatter_geo
now supportssymbol
2923go.Figure
now has aset_subplots
method to set subplots on an already
existing figure. 2866- Added
Turbo
colorscale and fancier swatch display functions
2882 - A utility function
image_array_to_data_uri
has been added in
plotly.utils
, in order to transform NumPy arrays to data b64 URIs (which
can be passed to the source parameter ofgo.Image
, or to layout images).
2879 - the
selector
argument to updater/selector functions now acceptsint
s andstr
s
2894
Updated
- the JSON serialization of plotly figures has been accelerated thanks to a
different handling of Infinity and NaN values. For example, a figure with a
1000x1000 Heatmap should now serialize 2x faster. 2880 - Coding mistakes with "magic underscores" now return significantly more ergonomic error
messages 2843 - Error messages related to impossible subplot geometries are now much more helpful
2897
Fixed
px.scatter_geo
support fortext
is fixed 2923- the
x
andy
parameters ofpx.imshow
are now used also in the case where
an Image trace is used (for RGB data or withbinary_string=True
). However,
only numerical values are accepted (while the Heatmap trace allows date or
string values forx
andy
). 2761
v4.12.0 - Horizontal and Vertical Lines and Rectangles
See the full release announcement at https://community.plotly.com/t/announcing-plotly-py-4-12-horizontal-and-vertical-lines-and-rectangles/46783
Added
- For
add_trace
,add_shape
,add_annotation
andadd_layout_image
, therow
and/orcol
argument now also accept the string"all"
.row="all"
adds the object to all the subplot rows andcol="all"
adds the object to all the subplot columns. (#2840) - Shapes that reference the plot axes in one dimension and the data in another dimension can be added with the new
add_hline
,add_vline
,add_hrect
,add_vrect
functions, which also support therow="all"
andcol="all"
arguments. (#2840) - The
add_trace
,add_shape
,add_annotation
,add_layout_image
,add_hline
,add_vline
,add_hrect
,add_vrect
functions accept an argumentexclude_empty_subplots
which ifTrue
, only adds the object to subplots already containing traces or layout objects. This is useful in conjunction with therow="all"
andcol="all"
arguments. (#2840) - For all
go.Figure
functions accepting a selector argument (e.g.,select_traces
), this argument can now also be a function which is passed each relevant graph object (in the case ofselect_traces
, it is passed every trace in the figure). For graph objects where this function returns true, the graph object is included in the selection. (#2844)
Updated
- Updated Plotly.js to version 1.57.1. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated
plotly.graph_objects
module.