Next API changes#
- Behavior change template
- All Axes have
get_subplotspec
andget_gridspec
methods now, which returns None for Axes not positioned via a gridspec HostAxesBase.get_aux_axes
now defaults to using the same base axes class as the host axesplt.get_cmap
andmatplotlib.cm.get_cmap
return a copyTrapezoidMapTriFinder
uses different random number generatorFuncAnimation(save_count=None)
CenteredNorm
halfrange is not modified when vcenter changesfig.subplot_mosaic
no longer passes thegridspec_kw
args to nested gridspecs.HPacker
alignment with bottom or top are now correct- On Windows only fonts known to the registry will be discovered
QuadMesh.set_array
now always raisesValueError
for inputs with incorrect shapescontour
andcontourf
auto-select suitable levels when given boolean inputsAxesImage.set_extent
now raisesTypeError
for unknown keyword argumentscontour
no longer warns if no contour lines are drawn.- TwoSlopeNorm now auto-expands to always have two slopes
- Streamplot now draws streamlines as one piece if no width or no color variance
- Change of
legend(loc="best")
behavior - Template for deprecations
Cursor
andMultiCursor
event handlers are now privatepassthru_pt
axes3d.vvec
,axes3d.eye
,axes3d.sx
, andaxes3d.sy
- Deprecation aliases in cbook
AXes
subclasses should overrideclear
instead ofcla
draw_gouraud_triangle
matplotlib.pyplot.get_plot_commands
matplotlib.tri
submodules are deprecated- Passing undefined label_mode to
Grid
- Colorbars for orphaned mappables are deprecated, but no longer raise
Animation
attributescontour.ClabelText
andContourLabeler.set_label_props
ContourLabeler
attributesbackend_ps.PsBackendHelper
andbackend_ps.ps_backend_helper
backend_webagg.ServerThread
is deprecatedparse_fontconfig_pattern
will no longer ignore unknown constant namesBufferRegion.to_string
andBufferRegion.to_string_argb
num2julian
,julian2num
andJULIAN_OFFSET
unit_cube
,tunit_cube
, andtunit_edges
- Most arguments to widgets have been made keyword-only
SimpleEvent
RadioButtons.circles
OffsetBox.get_extent_offsets
andOffsetBox.get_extent
CheckButtons.rectangles
andCheckButtons.lines
legend.legendHandles
ticklabels
parameter ofAxis.set_ticklabels
renamed tolabels
offsetbox.bbox_artist
Quiver.quiver_doc
andBarbs.barbs_doc
- rcParams type
- Deprecate unused parameter x to
TextBox.begin_typing
- Deprecation of top-level cmap registration and access functions in
mpl.cm
BrokenBarHCollection
is deprecated- Passing inconsistent
loc
andnth_coord
to axisartist helpers bbox.anchored()
with no explicit container- Functions in
mpl_toolkits.mplot3d.proj3d
- Arguments other than
renderer
toget_tightbbox
- Development change template
- pyparsing>=2.3.1 is now required
- importlib_resources>=2.3.0 is now required on Python<3.10
- Support for Qt<5.10 has been dropped
- Windows wheel runtime bundling
- numpy>=1.20 is now required
- Maximum line length increased to 88 characters
- Increase to minimum supported versions of dependencies
- Removal change template
- plot directive removals
- Miscellaneous removals
epoch2num
andnum2epoch
are removed- Locator and Formatter wrapper methods
- Interactive cursor details
auto_add_to_figure=True
forAxes3D
- The first parameter of
Axes.grid
andAxis.grid
has been renamed to visible - Removal of deprecations in the Selector widget API
backend_template.show
- Unused positional parameters to
print_<fmt>
methods QuadMesh
signature- Expiration of
FancyBboxPatch
deprecations - cbook removals
- Groupers from
get_shared_x_axes
/get_shared_y_axes
are immutable - Testing support
- Auto-removal of grids by
pcolor
andpcolormesh
- Modification of
Axes
children sublists - Passing incorrect types to
Axes.add_*
methods ConversionInterface.convert
no longer accepts unitless values- Normal list of
Artist
objects now returned byHandlerLine2D.create_artists
- rcParams will no longer cast inputs to str
- Case-insensitive scales
- Support for
nx1 = None
orny1 = None
inAxesLocator
andDivider.locate
- change signature of
.FigureCanvasBase.enter_notify_event
Colorbar
tick update parameters- Deprecated modules removed