matplotlib

Matplotlib is a comprehensive library for creating static, animated, and interactive visualizations in Python.

Check out our home page for more information.

https://matplotlib.org/_static/readme_preview.png

Matplotlib produces publication-quality figures in a variety of hardcopy formats and interactive environments across platforms. Matplotlib can be used in Python scripts, the Python and IPython shell, web application servers, and various graphical user interface toolkits.

Install

For installation instructions and requirements, see INSTALL.rst or the install documentation.

Test

After installation, launch the test suite:

python -m pytest

Read the testing guide for more information and alternatives.

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!

Contact

Discourse 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 mailing list: matplotlib-users@python.org
Announcement mailing list: matplotlib-announce@python.org
Development mailing list: matplotlib-devel@python.org

Gitter 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 is available.

Release files for matplotlib 3.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for matplotlib 3.4.0
File	Size	Uploaded
matplotlib-3.4.0.tar.gz	37.1 MB	Mar 26, 2021	Details

Built distributions (wheels)

Table of built distributions (wheels) for matplotlib 3.4.0
File	Interpreter	ABI	Platform	Reset
matplotlib-3.4.0-cp39-cp39-win_amd64.whl 7.1 MB Mar 26, 2021	CPython 3.9	CPython 3.9	Windows x86-64	Details
matplotlib-3.4.0-cp39-cp39-win32.whl 7.0 MB Mar 26, 2021	CPython 3.9	CPython 3.9	Windows x86-32	Details
matplotlib-3.4.0-cp39-cp39-manylinux2014_aarch64.whl 9.0 MB Mar 26, 2021	CPython 3.9	CPython 3.9	Linux glibc 2.17+ ARM64	Details
matplotlib-3.4.0-cp39-cp39-manylinux1_x86_64.whl 10.3 MB Mar 26, 2021	CPython 3.9	CPython 3.9	Linux glibc 2.5+ x86-64	Details
matplotlib-3.4.0-cp39-cp39-manylinux1_i686.whl 10.0 MB Mar 26, 2021	CPython 3.9	CPython 3.9	Linux glibc 2.5+ x86-32	Details
matplotlib-3.4.0-cp39-cp39-macosx_10_9_x86_64.whl 7.2 MB Mar 26, 2021	CPython 3.9	CPython 3.9	macOS 10.9+ x86-64	Details
matplotlib-3.4.0-cp38-cp38-win_amd64.whl 7.1 MB Mar 26, 2021	CPython 3.8	CPython 3.8	Windows x86-64	Details
matplotlib-3.4.0-cp38-cp38-win32.whl 7.0 MB Mar 26, 2021	CPython 3.8	CPython 3.8	Windows x86-32	Details
matplotlib-3.4.0-cp38-cp38-manylinux2014_aarch64.whl 9.0 MB Mar 26, 2021	CPython 3.8	CPython 3.8	Linux glibc 2.17+ ARM64	Details
matplotlib-3.4.0-cp38-cp38-manylinux1_x86_64.whl 10.3 MB Mar 26, 2021	CPython 3.8	CPython 3.8	Linux glibc 2.5+ x86-64	Details
matplotlib-3.4.0-cp38-cp38-manylinux1_i686.whl 10.0 MB Mar 26, 2021	CPython 3.8	CPython 3.8	Linux glibc 2.5+ x86-32	Details
matplotlib-3.4.0-cp38-cp38-macosx_10_9_x86_64.whl 7.2 MB Mar 26, 2021	CPython 3.8	CPython 3.8	macOS 10.9+ x86-64	Details
matplotlib-3.4.0-cp37-cp37m-win_amd64.whl 7.1 MB Mar 26, 2021	CPython 3.7	CPython 3.7 pymalloc	Windows x86-64	Details
matplotlib-3.4.0-cp37-cp37m-win32.whl 7.0 MB Mar 26, 2021	CPython 3.7	CPython 3.7 pymalloc	Windows x86-32	Details
matplotlib-3.4.0-cp37-cp37m-manylinux2014_aarch64.whl 9.0 MB Mar 26, 2021	CPython 3.7	CPython 3.7 pymalloc	Linux glibc 2.17+ ARM64	Details
matplotlib-3.4.0-cp37-cp37m-manylinux1_x86_64.whl 10.3 MB Mar 26, 2021	CPython 3.7	CPython 3.7 pymalloc	Linux glibc 2.5+ x86-64	Details
matplotlib-3.4.0-cp37-cp37m-manylinux1_i686.whl 10.0 MB Mar 26, 2021	CPython 3.7	CPython 3.7 pymalloc	Linux glibc 2.5+ x86-32	Details
matplotlib-3.4.0-cp37-cp37m-macosx_10_9_x86_64.whl 7.2 MB Mar 26, 2021	CPython 3.7	CPython 3.7 pymalloc	macOS 10.9+ x86-64	Details

Total release size: 188.9 MB

Release files / matplotlib-3.4.0.tar.gz

Download URL	matplotlib-3.4.0.tar.gz
Size	37.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`424ddb3422c65b284a38a97eb48f5cb64b66a44a773e0c71281a347f1738f146`
BLAKE2b-256 checksum How to use checksums	`053d45415c62fe3f3e7f0dd0b06b8edb0ed2f3dd5f9ceedb7874642976cb3624`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp39-cp39-win_amd64.whl

Download URL	matplotlib-3.4.0-cp39-cp39-win_amd64.whl
Size	7.1 MB
Tags	CPython 3.9 Windows x86-64
SHA-256 checksum How to use checksums	`fa0f7f3b2a0067ee5806264478f39fa52d7ddf8ee9b3012e5257b2ff39a15e0b`
BLAKE2b-256 checksum How to use checksums	`145173c049ba40d07576fbfb867a9d89aeb640cc16d2b532448c7dd04c66d7c1`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp39-cp39-win32.whl

Download URL	matplotlib-3.4.0-cp39-cp39-win32.whl
Size	7.0 MB
Tags	CPython 3.9 Windows x86-32
SHA-256 checksum How to use checksums	`4002b0928bcd695eb7f23bf18c52e3cf23501a9c06a1de596079d74932aa4068`
BLAKE2b-256 checksum How to use checksums	`fe117a1ccb4f64644f6aa797ef37f7e0dc3a4381e03ed768aa9e403575fc3e78`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp39-cp39-manylinux2014_aarch64.whl

Download URL	matplotlib-3.4.0-cp39-cp39-manylinux2014_aarch64.whl
Size	9.0 MB
Tags	CPython 3.9 Linux glibc 2.17+ ARM64
SHA-256 checksum How to use checksums	`966a1bb53ce56dcd542b4edb667166aac14c8eaf2a3acd68f403eccedf0d21a7`
BLAKE2b-256 checksum How to use checksums	`6d42dff06adf9c52e66156e1c8c451d27301baf00373c052893235f7fa7c024f`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp39-cp39-manylinux1_x86_64.whl

Download URL	matplotlib-3.4.0-cp39-cp39-manylinux1_x86_64.whl
Size	10.3 MB
Tags	CPython 3.9 Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`36e2f68b7d2f22eacc4d9d4dfdf3a975c9db31fa6e36e16a2d60bf4c1ff5a35c`
BLAKE2b-256 checksum How to use checksums	`d6a43004939737e2b1039a1ad0e60324a24742ec344c34ce7ee3a5c41a8e950c`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp39-cp39-manylinux1_i686.whl

Download URL	matplotlib-3.4.0-cp39-cp39-manylinux1_i686.whl
Size	10.0 MB
Tags	CPython 3.9 Linux glibc 2.5+ x86-32
SHA-256 checksum How to use checksums	`133469eb5d54a0a963d08a07356d03f6de41b6789f2a9d15aed0e6f3aabbf502`
BLAKE2b-256 checksum How to use checksums	`ef07e7c349af9e2b8d5478b88d5960403f8e734117e7e119a4e471604be73aee`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp39-cp39-macosx_10_9_x86_64.whl

Download URL	matplotlib-3.4.0-cp39-cp39-macosx_10_9_x86_64.whl
Size	7.2 MB
Tags	CPython 3.9 macOS 10.9+ x86-64
SHA-256 checksum How to use checksums	`a960ee5a139011e1d203df75eafc4e98013927f36ab69510313bc7d9d4641e38`
BLAKE2b-256 checksum How to use checksums	`14178797d8bf7d4b059f2bdb006518d9433ddd1623af4f3302b84fc77326ffda`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp38-cp38-win_amd64.whl

Download URL	matplotlib-3.4.0-cp38-cp38-win_amd64.whl
Size	7.1 MB
Tags	CPython 3.8 Windows x86-64
SHA-256 checksum How to use checksums	`3bcee5685afb76d2a31f8a6b190caf2e52be250d214155b91830110416767de3`
BLAKE2b-256 checksum How to use checksums	`6d6f8a3d1e91b7fa6f9f122b5155d14bd3c04a7e19008e7ce47133e242695405`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp38-cp38-win32.whl

Download URL	matplotlib-3.4.0-cp38-cp38-win32.whl
Size	7.0 MB
Tags	CPython 3.8 Windows x86-32
SHA-256 checksum How to use checksums	`a2828982c5329cceea67bae0af49e2bfae3471499d6d6aa4359efa0ef491b0f7`
BLAKE2b-256 checksum How to use checksums	`12c8538499568e79e20b5190e7ad713a93609ceeb0bf5f970188d431cbf74b3f`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp38-cp38-manylinux2014_aarch64.whl

Download URL	matplotlib-3.4.0-cp38-cp38-manylinux2014_aarch64.whl
Size	9.0 MB
Tags	CPython 3.8 Linux glibc 2.17+ ARM64
SHA-256 checksum How to use checksums	`85d7b8da66bb71054f3d73210b4fe24cca8afc6f92f00569b2ad24ca32438034`
BLAKE2b-256 checksum How to use checksums	`fda0f58294704441dbe23905c561c3ec29f3f1324230444cc7b7f26a057b3f39`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp38-cp38-manylinux1_x86_64.whl

Download URL	matplotlib-3.4.0-cp38-cp38-manylinux1_x86_64.whl
Size	10.3 MB
Tags	CPython 3.8 Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`2b54bbce73115f6f95912f57348b2e0fc03cc86a09c73191f1216d79c16cda3c`
BLAKE2b-256 checksum How to use checksums	`156d13e0e8a75e0c8db048091ebc7c0630d4e36af3fc5ea9b33de23281dca544`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp38-cp38-manylinux1_i686.whl

Download URL	matplotlib-3.4.0-cp38-cp38-manylinux1_i686.whl
Size	10.0 MB
Tags	CPython 3.8 Linux glibc 2.5+ x86-32
SHA-256 checksum How to use checksums	`7571d470cd5df2d6c27ee0e6dabbebd130eae91da19c3749c6946918f8bcad49`
BLAKE2b-256 checksum How to use checksums	`6bab0a416f29bdeaad7f72f89dc3c86cdbbaa5903259b0634401ed0fa22f905d`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp38-cp38-macosx_10_9_x86_64.whl

Download URL	matplotlib-3.4.0-cp38-cp38-macosx_10_9_x86_64.whl
Size	7.2 MB
Tags	CPython 3.8 macOS 10.9+ x86-64
SHA-256 checksum How to use checksums	`85388289b356f5f19464b84eaa7532cd10d3f701505ae8d988b3dfb1332d785f`
BLAKE2b-256 checksum How to use checksums	`7f477ce23a198dfd23e24bf0ed3a30efa853afa2f8407553ee2e7e11f940e8d2`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp37-cp37m-win_amd64.whl

Download URL	matplotlib-3.4.0-cp37-cp37m-win_amd64.whl
Size	7.1 MB
Tags	CPython 3.7 CPython 3.7 pymalloc Windows x86-64
SHA-256 checksum How to use checksums	`3c617fc6f7d6ac0c6142e34f3066520273195c75fb5371eabfddb3da04a75174`
BLAKE2b-256 checksum How to use checksums	`3bf8edee615ebd1c076b55691ffd7bc1419eecb6db8c8a1dcbf4a8f1241cf1ec`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp37-cp37m-win32.whl

Download URL	matplotlib-3.4.0-cp37-cp37m-win32.whl
Size	7.0 MB
Tags	CPython 3.7 CPython 3.7 pymalloc Windows x86-32
SHA-256 checksum How to use checksums	`3847ce29a01e1d1f0aa691263e510ce8504a20d158a811ed3a45c4c1d9e708e7`
BLAKE2b-256 checksum How to use checksums	`3f74b65b12b6fe3fcdbf93e19f13ba5984cdd4bf8c4acf0e343c20aeb49ba23a`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp37-cp37m-manylinux2014_aarch64.whl

Download URL	matplotlib-3.4.0-cp37-cp37m-manylinux2014_aarch64.whl
Size	9.0 MB
Tags	CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.17+ ARM64
SHA-256 checksum How to use checksums	`7e76956b8dd4bd8a6be71e401e4a24d975e57d5849a80c24a35551040ff82df0`
BLAKE2b-256 checksum How to use checksums	`7602e6e4062400e188fdb199b723fc96e0928f0651fe32371b3ea076fd86624a`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp37-cp37m-manylinux1_x86_64.whl

Download URL	matplotlib-3.4.0-cp37-cp37m-manylinux1_x86_64.whl
Size	10.3 MB
Tags	CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`8b046715f710b58dc89241eb3c8e907a30b269e915df6a134bb419f05a6507bf`
BLAKE2b-256 checksum How to use checksums	`83ee8d7e0149ecf95fae7e744c5a93f51a8c9f7a96c63691d10aed6d2c1d8735`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp37-cp37m-manylinux1_i686.whl

Download URL	matplotlib-3.4.0-cp37-cp37m-manylinux1_i686.whl
Size	10.0 MB
Tags	CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.5+ x86-32
SHA-256 checksum How to use checksums	`e879b5915f0c8e765d0e1ae4ecf93fafbde4a1dee88409427ac0ca55d31a41a9`
BLAKE2b-256 checksum How to use checksums	`1230e77a980afa538a3598b3155c695881dd755c8a88c2dbc5fc8de552b8bd0b`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release files / matplotlib-3.4.0-cp37-cp37m-macosx_10_9_x86_64.whl

Download URL	matplotlib-3.4.0-cp37-cp37m-macosx_10_9_x86_64.whl
Size	7.2 MB
Tags	CPython 3.7 CPython 3.7 pymalloc macOS 10.9+ x86-64
SHA-256 checksum How to use checksums	`fe4676d7f25d2915562aa551996843e97e7d25aefc54617a3b0fe74a967bc2c8`
BLAKE2b-256 checksum How to use checksums	`3b2c69a8b8edcd18c4b8a40274872c61809abedd3d8908b003c0fe58da63c434`
Upload date	Mar 26, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1`

Release history Release notifications | RSS feed

3.11.2

Sep 11, 2026 53 release files

3.11.1

Jul 18, 2026 46 release files

3.11.0

Jun 12, 2026 46 release files

Pre-release

3.11.0rc2

May 13, 2026 46 release files

Pre-release

3.11.0rc1

Apr 24, 2026 46 release files

3.10.9

Apr 24, 2026 55 release files

3.10.8

Dec 10, 2025 55 release files

3.10.7

Oct 9, 2025 55 release files

3.10.6

Aug 30, 2025 55 release files

3.10.5

Jul 31, 2025 55 release files

3.10.3

May 8, 2025 34 release files

3.10.1

Feb 27, 2025 34 release files

3.10.0

Dec 14, 2024 34 release files

Pre-release

3.10.0rc1

Nov 1, 2024 34 release files

3.9.4

Dec 13, 2024 41 release files

3.9.3

Nov 30, 2024 41 release files

3.9.2

Aug 13, 2024 40 release files

3.9.1.post1

Aug 6, 2024 29 release files

Yanked

3.9.1

Jul 4, 2024 24 release files

Yanked reason: The Windows wheels, under some conditions, caused segfaults in unrelated user code. Due to this we deleted the Windows wheels to prevent these segfaults, however this caused greater disruption as pip then began to try (and fail) to build 3.9.1 from the sdist on Windows which impacted far more users. Yanking the whole release is the only tool available to eliminate these failures without changes to on the user side. The sdist, OSX wheel, and manylinux wheels are all functional and there are no critical bugs in the release. Downstream packagers should not yank their builds of Matplotlib 3.9.1. See https://github.com/matplotlib/matplotlib/issues/28551 for details.

3.9.0

May 15, 2024 29 release files