Description
[](https://pypi.org/project/matplotlib/) [](https://anaconda.org/conda-forge/matplotlib) [](https://pypi.org/project/matplotlib) [](https://numfocus.org) [](https://discourse.matplotlib.org) [](https://gitter.im/matplotlib/matplotlib) [](https://github.com/matplotlib/matplotlib/issues) [](https://matplotlib.org/stable/devel/index.html) [](https://github.com/matplotlib/matplotlib/actions?query=workflow%3ATests) [](https://dev.azure.com/matplotlib/matplotlib/_build/latest?definitionId=1&branchName=main) [](https://ci.appveyor.com/project/matplotlib/matplotlib) [](https://app.codecov.io/gh/matplotlib/matplotlib) [](https://jacobtomlinson.dev/effver)  Matplotlib is a comprehensive library for creating static, animated, and interactive visualizations in Python. Check out our [home page](https://matplotlib.org/) for more information.  Matplotlib produces publication-quality figures in a variety of hardcopy formats and interactive environments across platforms. Matplotlib can be used in Python scripts, Python/IPython shells, web application servers, and various graphical user interface toolkits. ## Install See the [install documentation](https://matplotlib.org/stable/users/installing/index.html), which is generated from `/doc/install/index.rst` ## Contribute You've discovered a bug or something else you want to change — excellent! You've worked out a way to fix it — even better! You want to tell us about it — best of all! Start at the [contributing guide](https://matplotlib.org/devdocs/devel/contribute.html)! ## Contact [Discourse](https://discourse.matplotlib.org/) is the discussion forum for general questions and discussions and our recommended starting point. Our active mailing lists (which are mirrored on Discourse) are: - [Users](https://mail.python.org/mailman/listinfo/matplotlib-users) mailing list: <matplotlib-users@python.org> - [Announcement](https://mail.python.org/mailman/listinfo/matplotlib-announce) mailing list: <matplotlib-announce@python.org> - [Development](https://mail.python.org/mailman/listinfo/matplotlib-devel) mailing list: <matplotlib-devel@python.org> [Gitter](https://gitter.im/matplotlib/matplotlib) is for coordinating development and asking questions directly related to contributing to matplotlib. ## Citing Matplotlib If Matplotlib contributes to a project that leads to publication, please acknowledge this by citing Matplotlib. [A ready-made citation entry](https://matplotlib.org/stable/users/project/citing.html) is available.
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 3.10.8 | Imported from PyPI (3.10.8) | Low | 4/21/2026 |
| v3.10.8 | This is a bugfix release in the 3.10.x series. The primary highlights of this release are: - Properly allow freethreaded mode in the MacOS backend - Better error handling for MacOS backend | Low | 11/13/2025 |
| v3.10.7 | This is the latest bugfix release in the 3.10.x series. The most important update in this release is that the minimum version of `pyparsing` has been updated to version 3.0. | Low | 10/8/2025 |
| v3.10.6 | This is a bugfix release in the 3.10.x series. Highlights from this release include: - Fix regression of hi-dpi support for Qt - Fix race condition in TexManager.make_dvi & make_png - Various documentation and other bugfixes | Low | 8/29/2025 |
| v3.10.5 | This is the fourth bugfix release of the 3.10.x series. Included in this release is distributed wheels for Python 3.14 (including freethreaded) and Windows ARM. There are also several smaller bugfixes. | Low | 7/31/2025 |
| v3.10.3 | This is the third bugfix release of the 3.10.x series | Low | 5/9/2025 |
| v3.10.1 | This is the first bugfix release of the 3.10.x series. This release contains several bug-fixes and adjustments: - Respect array alpha with interpolation_stage='rgba' in _Imagebase::_make_image - Remove md5 usage to prevent issues on FIPS enabled systems - Fix pyplot.matshow figure handling - Fix modifying Axes' position also alters the original Bbox object used for initialization - Fix title position for polar plots - Add version gate to GTK4 calls when necessary - Raise warning if b | Low | 2/27/2025 |
| v3.10.0 | Highlights of this release include: - Preliminary support for free-threaded CPython 3.13 - New more-accessible color cycle - Dark-mode diverging colormaps - Exception handling control - InsetIndicator artist - FillBetweenPolyCollection - Fill between 3D lines - Data in 3D plots can now be dynamically clipped to the axes view limits - Rotating 3d plots with the mouse - Increased Figure limits with Agg renderer - Subfigures no longer pro | Low | 12/14/2024 |
| v3.9.4 | This is the fourth bugfix release of the 3.9.x series. This release contains two bug-fixes: - Fix toolbar icons in GTK backend - Fix `Poly3DCollection` initialization with list of lists | Low | 12/13/2024 |
| v3.9.3 | This is the third bugfix release of the 3.9.x series. This release contains several bug-fixes and adjustments: - Fix `axline` with extremely small slopes - Fix `axline` with non-linear axis scales - Fix `minimumSizeHint` with Qt backend - Fix config directory usage when it's behind a symlink - Fix draggable legend when blitting is enabled - Fix high CPU utilization in the `macosx` backend - Fix multiple hatch `edgecolors` passed to `contourf` - Improve compatibility with `pytest` 8. | Low | 11/30/2024 |
| v3.10.0rc1 | This is the first release candidate for Matplotlib 3.10.0 | Low | 11/1/2024 |
| v3.9.2 | This is the second bugfix release of the 3.9.x series. This release contains several bug-fixes and adjustments: - Be more resilient to I/O failures when writing font cache - Fix nondeterministic behavior with subplot spacing and constrained layout - Fix sticky edge tolerance relative to data range - Improve formatting of image values in cases of singular norms Windows wheels now bundle the MSVC runtime DLL statically to avoid inconsistencies with other wheels and random crashes depen | Low | 8/13/2024 |
| v3.9.1 | This is the first bugfix release of the 3.9.x series. This release contains several bug-fixes and adjustments: - Add GitHub artifact attestations for sdist and wheels - Re-add `matplotlib.cm.get_cmap`; note this function will still be removed at a later date - Allow duplicate backend entry points - Fix `Axes` autoscaling of thin bars at large locations - Fix `Axes` autoscaling with `axhspan` / `axvspan` - Fix `Axes3D` autoscaling of `Line3DCollection` / `Poly3DCollection` - Fix `Axes | Low | 7/4/2024 |
| v3.9.0 | Highlights of this release include: - Plotting and Annotation improvements - Axes.inset_axes is no longer experimental - Legend support for Boxplot - Percent sign in pie labels auto-escaped with usetex=True - hatch parameter for stackplot - Add option to plot only one half of violin plot - axhline and axhspan on polar axes - Subplot titles can now be automatically aligned - axisartist can now be used together with standard Formatters - Toggle minorticks on | Low | 5/15/2024 |
| v3.9.0rc2 | This is the second release candidate for the meso release 3.9.0. | Low | 4/9/2024 |
| v3.8.4 | 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 | Low | 4/4/2024 |
| v3.7.5 | 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 | Low | 2/16/2024 |
| v3.8.3 | 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 | Low | 2/15/2024 |
| v3.7.4 | 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 | Low | 11/18/2023 |
| v3.8.2 | 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 | Low | 11/17/2023 |
| v3.8.1 | 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 sdi | Low | 10/31/2023 |
| v3.8.0 | 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 | Low | 9/15/2023 |
| v3.7.3 | 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` mul | Low | 9/12/2023 |
| v3.8.0rc1 | First release candidate for Matplotlib v3.8.0 | Low | 8/10/2023 |
| v3.7.2 | 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 w | Low | 7/5/2023 |
| v3.7.1 | 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 valu | Low | 3/4/2023 |
| v3.7.0 | 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 gridl | Low | 2/13/2023 |
| v3.7.0rc1 | First release candidate for 3.7.0 | Low | 1/25/2023 |
| v3.6.3 | 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 | Low | 1/12/2023 |
| v3.6.2 | 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 | Low | 11/3/2022 |
| v3.6.1 | 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 | Low | 10/8/2022 |
| v3.6.0 | 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 c | Low | 9/16/2022 |
| v3.6.0rc2 | Second release candidate for 3.6.0 | Low | 8/29/2022 |
| v3.6.0rc1 | First release candidate for 3.6.0 | Low | 8/29/2022 |
| v3.5.3 | 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 `SubFigure`s * Fix cursor output: * for `imshow` with all negative values * when using `BoundaryNorm` * Fix interactivity in IPython/Jupyter * F | Low | 8/11/2022 |
| v3.5.2 | 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 * | Low | 5/3/2022 |
| v3.5.1 | 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 wind | Low | 12/11/2021 |
| v3.5.0 | 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 | Low | 11/16/2021 |
| v3.5.0rc1 | First release candidate for v3.5.0 | Low | 10/2/2021 |
| v3.5.0b1 | First beta release for v3.5.0 | Low | 8/24/2021 |
| v3.4.3 | 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 `Nor | Low | 8/13/2021 |
| v3.4.2 | 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 zoom | Low | 5/8/2021 |
| v3.4.1 | 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 | Low | 3/31/2021 |
| v3.4.0 | 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 | Low | 3/26/2021 |
| v3.4.0rc3 | This is the third release candidate for Matplotlib 3.4.0. | Low | 3/11/2021 |
| v3.4.0rc2 | This is the second release candidate for Matplotlib 3.4.0. | Low | 3/11/2021 |
| v3.4.0rc1 | This is the first release candidate for Matplotlib 3.4.0. | Low | 2/19/2021 |
| v3.3.4 | This is the fourth bugfix release of the 3.3.x series. This release contains several critical bug-fixes: * Fix WebAgg initialization. * Fix parsing `QT_API` setting with mixed case. * Fix build with link-time optimization disabled in environment. * Fix test compatibility with NumPy 1.20. * Fix test compatibility with pytest 6.2. | Low | 1/28/2021 |
| v3.3.3 | This is the third bugfix release of the 3.3.x series. This release contains several critical bug-fixes: * Fix calls to `Axis.grid` with argument `visible=True`. * Fix fully masked `imshow`. * Fix inconsistent color mapping in scatter for 3D plots. * Fix notebook/nbAgg figures when used with ipywidgets in the same cell. * Fix notebook/nbAgg/WebAgg on older (e.g., Firefox ESR) browsers. * Fix pcolormesh with `datetime` coordinates. * Fix performance regression with `datetime`s. * Fix | Low | 11/12/2020 |
| v3.3.2 | This is the second bugfix release of the 3.3.x series. This release contains several critical bug-fixes: * fix `Axis` scale on twinned `Axes` * fix auto-close of `Figure`s in nbagg * fix automatic title placement if `Axes` is off the `Figure` * fix autoranging of log scales with barstacked histogram * fix extra redraws when using `Button` or `TextBox` widgets * fix imshow with `LogNorm` and large vmin/vmax ranges * fix plotting Pandas `DataFrame` with string `MultiIndex` * fix `scat | Low | 9/15/2020 |
| v3.3.1 | This is the first bugfix release of the 3.3.x series. This release contains several critical bug-fixes: * fix docstring import issues when running Python with optimization * fix `hist` with categorical data, such as with Pandas * fix install on BSD systems * fix nbagg compatibility with Chrome 84+ * fix ordering of scatter marker size in 3D plots * fix performance regression when plotting `Path`s * fix reading from URL in `imread` * fix several regressions with new date epoch handli | Low | 8/14/2020 |
Dependencies & License Audit
Loading dependencies...
Similar Packages
azure-core-tracing-opentelemetryMicrosoft Azure Azure Core OpenTelemetry plugin Library for Pythonazure-template_0.1.0b6187637