v3.9.0

Compare Source

v3.8.4: REL: v3.8.4

Compare Source

This is the fourth micro release of the 3.8 series.

Highlights of the 3.8.4 release include:

• Enable building against numpy 2.0; released wheels are built against numpy 2
• macosx: Clean up single-shot timers correctly
• Add a draw during show for macos backend
• Fix color sequence data for Set2 and Set3
• gtk: Ensure pending draws are done before GTK draw
• Update "Created with" url in hand.svg
• Avoid modifying user input to Axes.bar
• fix quiver3d incorrect arrow colors

v3.8.3: REL: v3.8.3

Compare Source

This is the third micro release of the 3.8 series.

Highlights of the 3.8.3 release include:

• Improvements to the MacOS backend
  • Fix hanging on plt.pause
  • Fix warnings about "Secure coding is not enabled for restorable state"
• Fix crash at exit for PGF backend

v3.8.2: REL: v3.8.2

Compare Source

REL: v3.8.2

This is the second bugfix release of the 3.8 series.

Highlights of this release include:

• Fix a segfault in the MacOS backend when running on Python 3.12
• Fix Contour labeling manual positions selecting incorrect contours.
• Various documentation improvements

v3.8.1: REL: v3.8.1

Compare Source

This is the first bugfix release of the 3.8.x series.

This release contains several bug fixes and adjustments:

• Bump setuptools required version because of setuptools_scm v8
• Update find_nearest_contour and revert contour deprecations
• allsegs and allkinds return individual segments
• Restore default behavior of hexbin mincnt with C provided
• Try/except import of Axes3D
• Ensure valid path mangling for ContourLabeler
• BLD: Remove development dependencies from sdists
• FIX 2-tuple of colors in to_rgba_array
• Fix issue with non-string labels and legend
• Fix issue with locale comma when not using math text
• Various type hinting improvements
• Various documentation improvements
• Improvements to the MacOS backend

v3.8.0: REL: v3.8.0

Compare Source

REL: v3.8.0

Highlights of this release include:

• Type hints for most public APIs
• Many improvements to Mathtext
  • Addition of \boldsymbol command
  • Additional sizable delimiters
  • Documentation improvements
  • \substack command
  • \middle delimitier
  • \mathbfit for bold italic text
• 3D plotting improvements
  • Specify tick/axis label positions
  • Improved text for coordinates in interactive sessions
  • Ability to share view angles
• New plotting method ecdf (empirical cumulative distribution function)

v3.7.5: REL: v3.7.5

Compare Source

This is the fifth bugfix release of the 3.7.x series.

This release contains two bug-fixes:

• Fix hanging on plt.pause on the MacOS backend
• Fix crash on exit when using the PGF backend on Windows

v3.7.4: REL: v3.7.4

Compare Source

This is the fourth bugfix release of the 3.7.x series.

This release contains one bug-fix:

• Fix a segmentation fault when resizing on Python 3.12 and macOS 14

v3.7.3: REL: v3.7.3

Compare Source

This is the third bugfix release of the 3.7.x series.

This release contains several bug-fixes and adjustments:

• Add Python 3.12 wheels
• Update the license for the bundled colorbrewer colormap data
• Fix Cairo backend when using cairocffi
• Fix axes_grid1 inset axes with bbox_inches=tight
• Fix bugs in Path3DCollection / Poly3DCollection constructors
• Fix setting array labelcolor on Tick
• Improve compatibility with latest NumPy
• Stop warning when calling tight_layout multiple times

v3.7.2: REL: v3.7.2

Compare Source

This is the second bugfix release of the 3.7.x series.

This release contains several bug-fixes and adjustments:

• Avoid modifying input masks in pcolor/pcolormesh
• Fix 3D set_aspect error cases
• Fix IPython's %pylab mode detection
• Fix Figure.get_constrained_layout_pads()
• Fix Legend.set_draggable() with update="bbox"
• Fix TransformedBbox.{,full_}contains
• Fix clipping of bar_label text
• Fix colorbar size when saving with explicit bbox_inches
• Fix errors when an input is entirely NaN
• Fix leaks of exception tracebacks and LayoutGrid objects
• Fix non-interpolated imshow in PDF export
• Fix palettized image optimization in PDF export
• Fix pgf tests with TeXLive 2022
• Fix removal of Axes that contain widgets that are grabbing the mouse
• Fix removal of draggable artists
• Fix subslice optimization for long, fully nan lines
• Fix tight layout if Figure has an existing layout manager
• Fix window extent of AnnotationBbox before first draw
• Fix wspace and hspace in subfigures
• Improve Qt compatibility
• Improve compatibility with Python 3.12
• Prevent under the hood downcasting of values in xcorr
• Remove some NumPy function overrides from pylab
• Remove warning with symlog scales on mouseover

v3.7.1: REL: v3.7.1

Compare Source

This is the first bugfix release of the 3.7.x series.

This release contains several bug-fixes and adjustments:

• Ensure Qhull license is included in binary wheels
• Fix application of rcParams on Axes labels
• Fix compatibility with Pandas datetime unit converter
• Fix compatibility with latest GTK4
• Fix import of styles with relative path
• Fix Lasso unresponsiveness when clicking and immediately releasing
• Fix pickling of draggable legends
• Fix RangeSlider.set_val when new value is outside existing value
• Fix size of Tk spacers when changing display DPI
• Fix wrapped text in constrained layout
• Improve compatibility with third-party backends
• Improve error if animation save path does not exist

v3.7.0: REL: v3.7.0

Compare Source

Highlights of this release include:

• Plotting and Annotation improvements
  • hatch parameter for pie
  • Polar plot errors drawn in polar coordinates
  • Additional format string options in ~matplotlib.axes.Axes.bar_label
  • ellipse boxstyle option for annotations
  • The extent of imshow can now be expressed with units
  • Reversed order of legend entries
  • pcolormesh accepts RGB(A) colors
  • View current appearance settings for ticks, tick labels, and gridlines
  • Style files can be imported from third-party packages
• Improvements to 3D Plotting
  • 3D plot pan and zoom buttons
  • adjustable keyword argument for setting equal aspect ratios in 3D
  • Poly3DCollection supports shading
  • rcParam for 3D pane color
• Figure and Axes Layout
  • colorbar now has a location keyword argument
  • Figure legends can be placed outside figures using constrained_layout
  • Per-subplot keyword arguments in subplot_mosaic
  • subplot_mosaic no longer provisional
• Widget Improvements
  • Custom styling of button widgets
  • Blitting in Button widgets
• Other Improvements
  • Source links can be shown or hidden for each Sphinx plot directive
  • Figure hooks
• New & Improved Narrative Documentation
  • Brand new :doc:Animations </tutorials/introductory/animation_tutorial> tutorial.
  • New grouped and stacked bar chart <../../gallery/index.html#lines_bars_and_markers>_ examples.
  • New section for new contributors and reorganized git instructions in the :ref:contributing guide<contributing>.
  • Restructured :doc:/tutorials/text/annotations tutorial.

v3.6.3: REL: v3.6.3

Compare Source

This is the third bugfix release of the 3.6.x series.

This release contains several bug-fixes and adjustments:

• Fix Artist removal from axes_grid1 Axes classes
• Fix inset_locator in subfigures
• Fix scatter on masked arrays with units
• Fix colorbar ticks with log norm contours
• Fix deprecation warnings in GTK4 backend
• Fix using relative paths in HTMLWriter
• Improve failure message from rcParams string validation for tuple inputs
• Improve performance of QtAgg backends
• No longer modify pil_kwargs argument to imsave and savefig

v3.6.2: REL: v3.6.2

Compare Source

This is the second bugfix release of the 3.6.x series.

This release contains several bug-fixes and adjustments:

• Avoid mutating dictionaries passed to subplots
• Fix bbox_inches='tight' on a figure with constrained layout enabled
• Fix auto-scaling of ax.hist density with histtype='step'
• Fix compatibility with PySide6 6.4
• Fix evaluating colormaps on non-NumPy arrays
• Fix key reporting in pick events
• Fix thread check on PyPy 3.8
• Handle input to ax.bar that is all NaN
• Make rubber band more visible on Tk and Wx backends
• Restore (and warn on) seaborn styles in style.library
• Restore get_renderer function in deprecated tight_layout
• nb/webagg: Fix resize handle on WebKit browsers (e.g., Safari)

v3.6.1: REL: v3.6.1

Compare Source

This is the first bugfix release of the 3.6.x series.

This release contains several bug-fixes and adjustments:

• A warning is no longer raised when constrained layout explicitly
  disabled and tight layout is applied
• Add missing get_cmap method to ColormapRegistry
• Adding a colorbar on a ScalarMappable that is not attached to an
  Axes is now deprecated instead of raising a hard error
• Fix barplot being empty when first element is NaN
• Fix FigureManager.resize on GTK4
• Fix fill_between compatibility with NumPy 1.24 development version
• Fix hexbin with empty arrays and log scaling
• Fix resize_event deprecation warnings when creating figure on macOS
• Fix build in mingw
• Fix compatibility with PyCharm's interagg backend
• Fix crash on empty Text in PostScript backend
• Fix generic font families in SVG exports
• Fix horizontal colorbars with hatches
• Fix misplaced mathtext using eqnarray
• stackplot no longer changes the Axes cycler

v3.6.0: REL: v3.6.0

Compare Source

Highlights of this release include:

• Figure and Axes creation / management
  • subplots, subplot_mosaic accept height_ratios and width_ratios arguments
  • Constrained layout is no longer considered experimental
  • New layout_engine module
  • Compressed layout added for fixed-aspect ratio Axes
  • Layout engines may now be removed
  • Axes.inset_axes flexibility
  • WebP is now a supported output format
  • Garbage collection is no longer run on figure close
• Plotting methods
  • Striped lines (experimental)
  • Custom cap widths in box and whisker plots in bxp and boxplot
  • Easier labelling of bars in bar plot
  • New style format string for colorbar ticks
  • Linestyles for negative contours may be set individually
  • Improved quad contour calculations via ContourPy
  • errorbar supports markerfacecoloralt
  • streamplot can disable streamline breaks
  • New axis scale asinh (experimental)
  • stairs(..., fill=True) hides patch edge by setting linewidth
  • Fix the dash offset of the Patch class
  • Rectangle patch rotation point
• Colors and colormaps
  • Color sequence registry
  • Colormap method for creating a different lookup table size
  • Setting norms with strings
• Titles, ticks, and labels
  • plt.xticks and plt.yticks support minor keyword argument
• Legends
  • Legend can control alignment of title and handles
  • ncol keyword argument to legend renamed to ncols
• Markers
  • marker can now be set to the string "none"
  • Customization of MarkerStyle join and cap style
• Fonts and Text
  • Font fallback
  • List of available font names
  • math_to_image now has a color keyword argument
  • Active URL area rotates with link text
• rcParams improvements
  • Allow setting figure label size and weight globally and separately from title
  • Mathtext parsing can be disabled globally
  • Double-quoted strings in matplotlibrc
• 3D Axes improvements
  • Standardized views for primary plane viewing angles
  • Custom focal length for 3D camera
  • 3D plots gained a 3rd "roll" viewing angle
  • Equal aspect ratio for 3D plots
• Interactive tool improvements
  • Rotation, aspect ratio correction and add/remove state
  • MultiCursor now supports Axes split over multiple figures
  • PolygonSelector bounding boxes
  • Setting PolygonSelector vertices
  • SpanSelector widget can now be snapped to specified values
  • More toolbar icons are styled for dark themes
• Platform-specific changes
  • Wx backend uses standard toolbar
  • Improvements to macosx backend
    • Modifier keys handled more consistently
    • savefig.directory rcParam support
    • figure.raise_window rcParam support
    • Full-screen toggle support
    • Improved animation and blitting support
  • macOS application icon applied on Qt backend
  • New minimum macOS version
  • Windows on ARM support

v3.5.3: REL: v3.5.3

Compare Source

This is the third bugfix release of the 3.5.x series.

This release contains several bug-fixes and adjustments:

• Fix alignment of over/under symbols
• Fix bugs in colorbars:
  • alpha of extensions
  • drawedges=True with extensions
  • handling of panchor=False
• Fix builds on Cygwin and IBM i
• Fix contour labels in SubFigures
• Fix cursor output:
  • for imshow with all negative values
  • when using BoundaryNorm
• Fix interactivity in IPython/Jupyter
• Fix NaN handling in errorbar
• Fix NumPy conversion from AstroPy unit arrays
• Fix positional markerfmt passed to stem
• Fix unpickling:
  • crash loading in a separate process
  • incorrect DPI when HiDPI screens

v3.5.2: REL: v3.5.2

Compare Source

This is the second bugfix release of the 3.5.x series.

This release contains several bug-fixes and adjustments:

• Add support for Windows on ARM (source-only; no wheels provided yet)
• Add year to concise date formatter when displaying less than 12 months
• Disable QuadMesh mouse cursor to avoid severe performance regression in pcolormesh
• Delay backend selection to allow choosing one in more cases
• Fix automatic layout bugs in EPS output
• Fix autoscaling of scatter plots
• Fix clearing of subfigures
• Fix colorbar exponents, inversion of extensions, and use on inset axes
• Fix compatibility with various NumPy-like classes (e.g., Pandas, xarray, etc.)
• Fix constrained layout bugs with mixed subgrids
• Fix errorbar with dashes
• Fix errors in conversion to GTK4 and Qt6
• Fix figure options accidentally re-ordering data
• Fix keyboard focus of TkAgg backend
• Fix manual selection of contour labels
• Fix path effects on text with whitespace
• Fix quiver in subfigures
• Fix RangeSlider.set_val displaying incorrectly
• Fix regressions in collection data limits
• Fix stairs with no edgecolor
• Fix some leaks in Tk backends
• Fix tight layout DPI confusion
• Fix tool button customizability and some tool manager bugs
• Only set Tk HiDPI scaling-on-map for Windows systems
• Partially allow TTC font collection files by selecting the first font

v3.5.1: REL: v3.5.1

Compare Source

This is the first bugfix release of the 3.5.x series.

This release contains several critical bug-fixes:

• fix installation issues when setting a default backend
• fix add_lines on horizontal colorbars
• fix streamplot with start points on right or top edge
• fix colorbars with boundaries or NoNorm
• fix colorbars with negative contours
• fix colorbars with tight layout
• fix setting Axis label alignment to center
• fix subfigure tight bounding box
• fix subplot parameter window on macosx backend
• fix unit handling in Collections.set_offsets
• fix unyt integration in errorbar
• re-display date offset in ConciseDataFormatter after zoom
• reduce do_3d_projection deprecation warnings in external artists

v3.5.0: REL: v3.5.0

Compare Source

Highlights of this release include:

• Figure and Axes creation / management
  • subplot_mosaic supports simple Axes sharing
  • Figure now has draw_without_rendering method
  • Figure __init__ passes keyword arguments through to set
• Plotting methods
  • Add Annulus patch
  • set_data method for FancyArrow patch
  • New arrow styles in ArrowStyle and ConnectionPatch
  • Setting collection offset transform after initialization
• Colors and colormaps
  • Colormap registry (experimental)
  • Image interpolation now possible at RGBA stage
  • imshow supports half-float arrays
  • A callback registry has been added to Normalize objects
• Titles, ticks, and labels
  • Settings tick positions and labels simultaneously in set_ticks
• Fonts and Text
  • Triple and quadruple dot mathtext accents
  • Font properties of legend title are configurable
  • Text and TextBox parse_math option
  • Text can be positioned inside TextBox widget
  • Simplified font setting for usetex mode
  • Type 42 subsetting is now enabled for PDF/PS backends
• rcParams improvements
  • Allow setting default legend labelcolor globally
• 3D Axes improvements
  • Axes3D now allows manual control of draw order
  • Allow changing the vertical axis in 3D plots
  • plot_surface supports masked arrays and NaNs
  • 3D plotting methods support data keyword argument
• Interactive tool improvements
  • Colorbars now have pan and zoom functionality
  • Updated appearance of Slider widgets
  • Selector additions of clearing, dragging, and removal
  • CallbackRegistry objects gain a method to temporarily block signals
  • Directional sizing cursors
• Sphinx extensions
  • More configuration of mathmpl sphinx extension
• Backend-specific improvements
  • New GTK4 backend
  • New Qt6 backend
  • HiDPI support in Cairo-based, GTK, and Tk backends
  • Qt figure options editor improvements
  • WX backends support mouse navigation buttons
  • WebAgg uses asyncio instead of Tornado

v3.4.3: REL: v3.4.3

Compare Source

This is the third bugfix release of the 3.4.x series.

This release contains several critical bug-fixes:

• Clarify deprecation of Axes.figbox
• Disable MultiCursor widget on Axes subplots which it is not tracking
• Don't simplify path in LineCollection.get_segments
• Fix DPI in subfigures, affecting tick spacing, and scatter marker size
• Fix broken EPS output when using Type 42 STIX fonts
• Fix change in tick behaviour when calling Axes.clear
• Fix class docstrings for Norms created from Scales
• Fix compatibility with NumPy 1.21.0
• Fix crash on broken TrueType fonts
• Fix incorrect hits from Path.intersects_path
• Fix leak if affine_transform is passed invalid vertices
• Fix legends of stackplot with edgecolors='face'
• Fix plot directive when building in parallel
• Fix supxlabel and supylabel behaviour in constrained layout
• Fix tests with latest Inkscape and Ghostscript
• Improve DateFormatter styling for month names when usetex=True
• Re-disable autoscaling after interactive zoom
• Work around bug in Pillow 8.3.0

v3.4.2: REL: v3.4.2

Compare Source

This is the second bugfix release of the 3.4.x series.

This release contains several critical bug-fixes:

• Generate wheels usable on older PyPy7.3.{0,1}
• Fix compatibility with Python 3.10
• Add subplot_mosaic Axes in the order the user gave them to us
• Correctly handle 'none' facecolors in do_3d_projection
• Ensure that Matplotlib is importable even if there's no HOME
• Fix CenteredNorm with halfrange
• Fix bar_label for bars with NaN values
• Fix clip paths when zoomed such that they are outside the figure
• Fix creation of RangeSlider with valinit
• Fix handling of "d" glyph in backend_ps, fixing EPS output
• Fix handling of datetime coordinates in pcolormesh with Pandas
• Fix processing of some errorbar arguments
• Fix removal of shared polar Axes
• Fix resetting grid visibility
• Fix subfigure indexing error and tight bbox
• Fix textbox cursor color
• Fix TkAgg event loop error on window close
• Ignore errors for sip with no setapi (Qt4Agg import errors)

v3.4.1: REL: v3.4.1

Compare Source

This is the first bugfix release of the 3.4.x series.

This release contains several critical bug-fixes:

• fix errorbar when specifying fillstyle
• fix Inkscape cleanup at exit on Windows for tests
• fix legends of colour-mapped scatter plots
• fix positioning of annotation fancy arrows
• fix size and color rendering for 3D scatter plots
• fix suptitle manual positioning when using constrained layout
• respect antialiasing settings in cairo backends as well

v3.4.0: REL: v3.4.0

Compare Source

Highlights of this release include:

• Figure and Axes creation / management
  • New subfigure functionality
  • Single-line string notation for subplot_mosaic
  • Changes to behavior of Axes creation methods (gca, add_axes, add_subplot)
  • add_subplot/add_axes gained an axes_class parameter
  • Subplot and subplot2grid can now work with constrained layout
• Plotting methods
  • axline supports transform parameter
  • New automatic labeling for bar charts
  • A list of hatches can be specified to bar and barh
  • Setting BarContainer orientation
  • Contour plots now default to using ScalarFormatter
  • Axes.errorbar cycles non-color properties correctly
  • errorbar errorevery parameter matches markevery
  • hexbin supports data reference for C parameter
  • Support callable for formatting of Sankey labels
  • Axes.spines access shortcuts
  • New stairs method and StepPatch artist
  • Added orientation parameter for stem plots
  • Angles on Bracket arrow styles
  • TickedStroke patheffect
• Colors and colormaps
  • Collection color specification and mapping
  • Transparency (alpha) can be set as an array in collections
  • pcolormesh has improved transparency handling by enabling snapping
  • IPython representations for Colormap objects
  • Colormap.set_extremes and Colormap.with_extremes
  • Get under/over/bad colors of Colormap objects
  • New cm.unregister_cmap function
  • New CenteredNorm for symmetrical data around a center
  • New FuncNorm for arbitrary normalizations
  • GridSpec-based colorbars can now be positioned above or to the left of the main axes
• Titles, ticks, and labels
  • supxlabel and supylabel
  • Shared-axes subplots tick label visibility is now correct for top or left labels
  • An iterable object with labels can be passed to Axes.plot
• Fonts and Text
  • Text transform can rotate text direction
  • matplotlib.mathtext now supports overset and underset LaTeX symbols
  • math_fontfamily parameter to change Text font family
  • TextArea/AnchoredText support horizontalalignment
  • PDF supports URLs on Text artists
• rcParams improvements
  • New rcParams for dates: set converter and whether to use interval_multiples
  • Date formatters now respect usetex rcParam
  • Setting image.cmap to a Colormap
  • Tick and tick label colors can be set independently using rcParams
• 3D Axes improvements
  • Errorbar method in 3D Axes
  • Stem plots in 3D Axes
  • 3D Collection properties are now modifiable
  • Panning in 3D Axes
• Interactive tool improvements
  • New RangeSlider widget
  • Sliders can now snap to arbitrary values
  • Pausing and Resuming Animations
• Sphinx extensions
  • plot_directive caption option
• Backend-specific improvements
  • Consecutive rasterized draws now merged
  • Support raw/rgba frame format in FFMpegFileWriter
  • nbAgg/WebAgg support middle-click and double-click
  • nbAgg support binary communication
  • Indexed color for PNG images in PDF files when possible
  • Improved font subsettings in PDF/PS
  • Kerning added to strings in PDFs
  • Fully-fractional HiDPI in QtAgg
  • wxAgg supports fullscreen toggle