matplotlib · timhoffm · Sep 2, 2021 · Sep 2, 2021 · Sep 2, 2021 · Sep 2, 2021
diff --git a/.circleci/config.yml b/.circleci/config.yml
@@ -105,6 +105,13 @@ commands:
       - run:
           name: Install Matplotlib
           command: python -m pip install --user -ve .
+      - save_cache:
+          key: build-deps-1
+          paths:
+            # FreeType 2.6.1 tarball.
+            - ~/.cache/matplotlib/0a3c7dfbda6da1e8fce29232e8e96d987ababbbf71ebc8c75659e4132c367014
+            # Qhull 2020.2 tarball.
+            - ~/.cache/matplotlib/b5c2d7eb833278881b952c8a52d20179eab87766b00b865000469a45c1838b7e
 
   doc-build:
     steps:

diff --git a/.flake8 b/.flake8
@@ -120,11 +120,15 @@ per-file-ignores =
     examples/style_sheets/plot_solarizedlight2.py: E501
     examples/subplots_axes_and_figures/demo_constrained_layout.py: E402
     examples/text_labels_and_annotations/custom_legends.py: E402
-    examples/ticks_and_spines/date_concise_formatter.py: E402
+    examples/ticks/date_concise_formatter.py: E402
     examples/user_interfaces/embedding_in_gtk3_panzoom_sgskip.py: E402
     examples/user_interfaces/embedding_in_gtk3_sgskip.py: E402
-    examples/user_interfaces/gtk_spreadsheet_sgskip.py: E402
+    examples/user_interfaces/embedding_in_gtk4_panzoom_sgskip.py: E402
+    examples/user_interfaces/embedding_in_gtk4_sgskip.py: E402
+    examples/user_interfaces/gtk3_spreadsheet_sgskip.py: E402
+    examples/user_interfaces/gtk4_spreadsheet_sgskip.py: E402
     examples/user_interfaces/mpl_with_glade3_sgskip.py: E402
-    examples/user_interfaces/pylab_with_gtk_sgskip.py: E402
+    examples/user_interfaces/pylab_with_gtk3_sgskip.py: E402
+    examples/user_interfaces/pylab_with_gtk4_sgskip.py: E402
     examples/user_interfaces/toolmanager_sgskip.py: E402
     examples/userdemo/pgf_preamble_sgskip.py: E402
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -1,3 +1,3 @@
 # These are supported funding model platforms
-github: [numfocus]
+github: [matplotlib, numfocus]
 custom: https://numfocus.org/donate-to-matplotlib
diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
@@ -15,6 +15,7 @@ jobs:
     env:
       min-numpy-version: "1.17.3"
       min-numpy-hash: "b6/d6/be8f975f5322336f62371c9abeb936d592c98c047ad63035f1b38ae08efe"
+      CIBW_ARCHS_MACOS: "x86_64 universal2 arm64"
     strategy:
       matrix:
         os: [ubuntu-18.04, windows-latest, macos-latest]
@@ -60,6 +61,18 @@ jobs:
           CIBW_BUILD: "cp37-* cp38-*"
           CIBW_ARCHS: aarch64
 
+      - name: Build wheels for CPython 3.10
+        run: |
+          python -m cibuildwheel --output-dir dist
+        if: matrix.os != 'macos-latest'
+        env:
+          CIBW_BUILD: "cp310-*"
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux2014
+          CIBW_MANYLINUX_I686_IMAGE: manylinux2014
+          CIBW_BEFORE_BUILD: pip install certifi numpy==1.21.2
+          MPL_DISABLE_FH4: "yes"
+          CIBW_ARCHS: ${{ matrix.cibw_archs }}
+
       - name: Build wheels for CPython 3.9
         run: |
           python -m cibuildwheel --output-dir dist

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -171,37 +171,38 @@ jobs:
           # (sometimes, the install appears to be successful but shared
           # libraries cannot be loaded at runtime, so an actual import is a
           # better check).
-          if [[ "${{ runner.os }}" != 'macOS' ]]; then
-            # PyGObject, pycairo, and cariocffi do not install on OSX 10.12.
-             python -m pip install --upgrade pycairo 'cairocffi>=0.8' PyGObject &&
-               python -c 'import gi; gi.require_version("Gtk", "3.0"); from gi.repository import Gtk' &&
-               echo 'PyGObject is available' ||
-               echo 'PyGObject is not available'
+          # PyGObject, pycairo, and cariocffi do not install on OSX 10.12.
+           python -m pip install --upgrade pycairo 'cairocffi>=0.8' PyGObject &&
+             python -c 'import gi; gi.require_version("Gtk", "3.0"); from gi.repository import Gtk' &&
+             echo 'PyGObject is available' ||
+             echo 'PyGObject is not available'
 
-            # There are no functioning wheels available for OSX 10.12 (as of
-            # Sept 2020) for either pyqt5 (there are only wheels for 10.13+) or
-            # pyside2 (the latest version (5.13.2) with 10.12 wheels has a
-            # fatal to us bug, it was fixed in 5.14.0 which has 10.13 wheels)
-            python -mpip install --upgrade pyqt5${{ matrix.pyqt5-ver }} &&
-              python -c 'import PyQt5.QtCore' &&
-              echo 'PyQt5 is available' ||
-              echo 'PyQt5 is not available'
+          # There are no functioning wheels available for OSX 10.12 (as of
+          # Sept 2020) for either pyqt5 (there are only wheels for 10.13+) or
+          # pyside2 (the latest version (5.13.2) with 10.12 wheels has a
+          # fatal to us bug, it was fixed in 5.14.0 which has 10.13 wheels)
+          python -mpip install --upgrade pyqt5${{ matrix.pyqt5-ver }} &&
+            python -c 'import PyQt5.QtCore' &&
+            echo 'PyQt5 is available' ||
+            echo 'PyQt5 is not available'
+          if [[ "${{ runner.os }}" != 'macOS' ]]; then
             python -mpip install --upgrade pyside2 &&
               python -c 'import PySide2.QtCore' &&
               echo 'PySide2 is available' ||
               echo 'PySide2 is not available'
-            # Qt6 crashes on Github's ubuntu 18.04 runner.
-            if [[ "${{ matrix.os }}" = ubuntu-20.04 ]]; then
-              python -mpip install --upgrade pyqt6 &&
-                python -c 'import PyQt6.QtCore' &&
-                echo 'PyQt6 is available' ||
-                echo 'PyQt6 is not available'
-              python -mpip install --upgrade pyside6 &&
-                python -c 'import PySide6.QtCore' &&
-                echo 'PySide6 is available' ||
-                echo 'PySide6 is not available'
-            fi
           fi
+          # Qt6 crashes on Github's ubuntu 18.04 runner.
+          if [[ "${{ matrix.os }}" = ubuntu-20.04 ]]; then
+            python -mpip install --upgrade pyqt6 &&
+              python -c 'import PyQt6.QtCore' &&
+              echo 'PyQt6 is available' ||
+              echo 'PyQt6 is not available'
+            python -mpip install --upgrade pyside6 &&
+              python -c 'import PySide6.QtCore' &&
+              echo 'PySide6 is available' ||
+              echo 'PySide6 is not available'
+          fi
+
           python -mpip install --upgrade \
             -f "https://extras.wxpython.org/wxPython4/extras/linux/gtk3/${{ matrix.os }}" \
             wxPython &&

diff --git a/.gitignore b/.gitignore
@@ -72,6 +72,7 @@ doc/plot_types
 doc/pyplots/tex_demo.png
 doc/tutorials
 lib/dateutil
+examples/*/*.bmp
 examples/*/*.eps
 examples/*/*.pdf
 examples/*/*.png

diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
@@ -207,8 +207,27 @@ does not float with it.
 
 }
 
+/* slightly reduce horizontal margin compared to gallery.css to
+ * get four columns of thumbnails in the pydata-sphinx-theme. */
+.sphx-glr-thumbcontainer {
+    margin: 5px 2px;
+}
+
+/* workaround: the default padding decenters the image inside the frame */
+.sphx-glr-thumbcontainer .figure {
+    padding: 0;
+}
 
 table.property-table th,
 table.property-table td {
     padding: 4px 10px;
 }
+
+.sidebar-cheatsheets, .sidebar-donate {
+    margin: 2.75rem 0;
+}
+
+.sidebar-donate .mpl-button {
+    /* fix width to width of cheatsheet */
+    width: 210px;
+}
diff --git a/doc/_templates/cheatsheet_sidebar.html b/doc/_templates/cheatsheet_sidebar.html
@@ -0,0 +1,9 @@
+
+<div class="sidebar-cheatsheets">
+  <h3>Matplotlib cheatsheets</h3>
+  <a href="https://github.com/matplotlib/cheatsheets#cheatsheets">
+    <img src="_static/mpl_cheatsheet1.png"
+         alt="Matplotlib cheatsheets"
+         srcset="_static/mpl_cheatsheet1.png 1x, _static/mpl_cheatsheet1_2x.png 2x"/>
+  </a>
+</div>
diff --git a/doc/_templates/donate_sidebar.html b/doc/_templates/donate_sidebar.html
@@ -1,6 +1,8 @@
 
 
 
-<div id="sidebar-donations">
-  <a href="https://numfocus.org/donate-to-matplotlib" target="_blank"> <span class="mpl-button donate_button" >Support Matplotlib</span></a>
+<div class="sidebar-donate">
+  <a href="https://numfocus.org/donate-to-matplotlib" target="_blank">
+    <span class="mpl-button" >Support Matplotlib</span>
+  </a>
 </div>
diff --git a/doc/_templates/mpl_nav_bar.html b/doc/_templates/mpl_nav_bar.html
@@ -0,0 +1,29 @@
+<ul id="navbar-main-elements" class="navbar-nav">
+  <li class="nav-item">
+    <a class="reference internal nav-link" href="{{ pathto('contents') }}" title="Contents">
+      <span><i class="fas fa-list" style="font-size: 1rem"></i>&nbsp;</span>
+      <label class="sr-only">Contents</label>
+   </a>
+  </li>
+  <li class="nav-item">
+    <a class="reference internal nav-link" href="{{ pathto('plot_types/index') }}">Plot types</a>
+  </li>
+  <li class="nav-item">
+    <a class="reference internal nav-link" href="{{ pathto('gallery/index') }}">Examples</a>
+  </li>
+  <li class="nav-item">
+    <a class="reference internal nav-link" href="{{ pathto('tutorials/index') }}">Tutorials</a>
+  </li>
+  <li class="nav-item">
+    <a class="reference internal nav-link" href="{{ pathto('api/index') }}">Reference</a>
+  </li>
+  <li class="nav-item">
+    <a class="reference internal nav-link" href="{{ pathto('contents') }}">Usage guide</a>
+  </li>
+  <li class="nav-item">
+    <a class="reference internal nav-link" href="{{ pathto('devel/index') }}">Develop</a>
+  </li>
+  <li class="nav-item">
+    <a class="reference internal nav-link" href="{{ pathto('users/release_notes') }}">Release notes</a>
+  </li>
+</ul>
diff --git a/doc/_templates/sidebar_versions.html b/doc/_templates/sidebar_versions.html
@@ -36,12 +36,3 @@
 getSnippet('other_versions', '/versions.html');
 </script>
 </div>
-
-<div class="sphinxsidebarwrapper">
-  <h3>Matplotlib cheatsheets</h3>
-  <a href="https://github.com/matplotlib/cheatsheets#cheatsheets">
-    <img src="_static/mpl_cheatsheet1.png"
-         alt="Matplotlib cheatsheets"
-         srcset="_static/mpl_cheatsheet1.png 1x, _static/mpl_cheatsheet1_2x.png 2x"/>
-  </a>
-</div>
diff --git a/doc/api/animation_api.rst b/doc/api/animation_api.rst
@@ -32,7 +32,8 @@ to.  If you do not hold a reference to the `Animation` object, it (and
 hence the timers) will be garbage collected which will stop the
 animation.
 
-To save an animation to disk use `Animation.save` or `Animation.to_html5_video`
+To save an animation use `Animation.save`, `Animation.to_html5_video`,
+or `Animation.to_jshtml`.
 
 See :ref:`ani_writer_classes` below for details about what movie formats are
 supported.

diff --git a/doc/api/backend_agg_api.rst b/doc/api/backend_agg_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_agg`
-======================================
+:mod:`.backend_agg`
+===================
 
 .. automodule:: matplotlib.backends.backend_agg
    :members:

diff --git a/doc/api/backend_cairo_api.rst b/doc/api/backend_cairo_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_cairo`
-========================================
+:mod:`.backend_cairo`
+=====================
 
 .. automodule:: matplotlib.backends.backend_cairo
    :members:

diff --git a/doc/api/backend_gtk3_api.rst b/doc/api/backend_gtk3_api.rst
@@ -1,16 +1,11 @@
+:mod:`.backend_gtk3agg`, :mod:`.backend_gtk3cairo`
+==================================================
+
 **NOTE** These backends are not documented here, to avoid adding a dependency
 to building the docs.
 
 .. redirect-from:: /api/backend_gtk3agg_api
 .. redirect-from:: /api/backend_gtk3cairo_api
 
-
-:mod:`matplotlib.backends.backend_gtk3agg`
-==========================================
-
 .. module:: matplotlib.backends.backend_gtk3agg
-
-:mod:`matplotlib.backends.backend_gtk3cairo`
-============================================
-
 .. module:: matplotlib.backends.backend_gtk3cairo
diff --git a/doc/api/backend_gtk4_api.rst b/doc/api/backend_gtk4_api.rst
@@ -0,0 +1,11 @@
+:mod:`.backend_gtk4agg`, :mod:`.backend_gtk4cairo`
+==================================================
+
+**NOTE** These backends are not documented here, to avoid adding a dependency
+to building the docs.
+
+.. redirect-from:: /api/backend_gtk4agg_api
+.. redirect-from:: /api/backend_gtk4cairo_api
+
+.. module:: matplotlib.backends.backend_gtk4agg
+.. module:: matplotlib.backends.backend_gtk4cairo
diff --git a/doc/api/backend_mixed_api.rst b/doc/api/backend_mixed_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_mixed`
-========================================
+:mod:`.backend_mixed`
+=====================
 
 .. automodule:: matplotlib.backends.backend_mixed
    :members:

diff --git a/doc/api/backend_nbagg_api.rst b/doc/api/backend_nbagg_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_nbagg`
-========================================
+:mod:`.backend_nbagg`
+=====================
 
 .. automodule:: matplotlib.backends.backend_nbagg
    :members:

diff --git a/doc/api/backend_pdf_api.rst b/doc/api/backend_pdf_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_pdf`
-======================================
+:mod:`.backend_pdf`
+===================
 
 .. automodule:: matplotlib.backends.backend_pdf
    :members:

diff --git a/doc/api/backend_pgf_api.rst b/doc/api/backend_pgf_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_pgf`
-======================================
+:mod:`.backend_pgf`
+===================
 
 .. automodule:: matplotlib.backends.backend_pgf
    :members:

diff --git a/doc/api/backend_ps_api.rst b/doc/api/backend_ps_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_ps`
-=====================================
+:mod:`.backend_ps`
+==================
 
 .. automodule:: matplotlib.backends.backend_ps
    :members:

diff --git a/doc/api/backend_qt_api.rst b/doc/api/backend_qt_api.rst
@@ -1,3 +1,6 @@
+:mod:`.backend_qtagg`, :mod:`.backend_qtcairo`
+==============================================
+
 **NOTE** These backends are not documented here, to avoid adding a dependency
 to building the docs.
 
@@ -6,12 +9,7 @@ to building the docs.
 .. redirect-from:: /api/backend_qt5agg_api
 .. redirect-from:: /api/backend_qt5cairo_api
 
-:mod:`matplotlib.backends.backend_qt5agg`
-=========================================
-
+.. module:: matplotlib.backends.backend_qtagg
+.. module:: matplotlib.backends.backend_qtcairo
 .. module:: matplotlib.backends.backend_qt5agg
-
-:mod:`matplotlib.backends.backend_qt5cairo`
-===========================================
-
 .. module:: matplotlib.backends.backend_qt5cairo
diff --git a/doc/api/backend_svg_api.rst b/doc/api/backend_svg_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_svg`
-======================================
+:mod:`.backend_svg`
+===================
 
 .. automodule:: matplotlib.backends.backend_svg
    :members:

diff --git a/doc/api/backend_template_api.rst b/doc/api/backend_template_api.rst
@@ -1,6 +1,5 @@
-
-:mod:`matplotlib.backends.backend_template`
-===========================================
+:mod:`.backend_template`
+========================
 
 .. automodule:: matplotlib.backends.backend_template
    :members:

diff --git a/doc/api/backend_tk_api.rst b/doc/api/backend_tk_api.rst
@@ -1,15 +1,11 @@
-
-:mod:`matplotlib.backends.backend_tkagg`
-========================================
+:mod:`.backend_tkagg`, :mod:`.backend_tkcairo`
+==============================================
 
 .. automodule:: matplotlib.backends.backend_tkagg
    :members:
    :undoc-members:
    :show-inheritance:
 
-:mod:`matplotlib.backends.backend_tkcairo`
-==========================================
-
 .. automodule:: matplotlib.backends.backend_tkcairo
    :members:
    :undoc-members: