diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 46a7c68f062e..fd8dc309a61c 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -41,12 +41,12 @@ jobs:
SDIST_NAME: ${{ steps.sdist.outputs.SDIST_NAME }}
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
fetch-depth: 0
persist-credentials: false
- - uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+ - uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
name: Install Python
with:
python-version: '3.11'
@@ -72,7 +72,7 @@ jobs:
run: twine check dist/*
- name: Upload sdist result
- uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
+ uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
with:
name: cibw-sdist
path: dist/*.tar.gz
@@ -137,13 +137,13 @@ jobs:
steps:
- name: Download sdist
- uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
+ uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
with:
name: cibw-sdist
path: dist/
- name: Build wheels for CPython 3.14
- uses: pypa/cibuildwheel@9c00cb4f6b517705a3794b22395aedc36257242c # v3.2.1
+ uses: pypa/cibuildwheel@298ed2fb2c105540f5ed055e8a6ad78d82dd3a7e # v3.3.1
with:
package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
env:
@@ -153,7 +153,7 @@ jobs:
CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
- name: Build wheels for CPython 3.13
- uses: pypa/cibuildwheel@9c00cb4f6b517705a3794b22395aedc36257242c # v3.2.1
+ uses: pypa/cibuildwheel@298ed2fb2c105540f5ed055e8a6ad78d82dd3a7e # v3.3.1
with:
package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
env:
@@ -162,7 +162,7 @@ jobs:
CIBW_ARCHS: ${{ matrix.cibw_archs }}
- name: Build wheels for CPython 3.12
- uses: pypa/cibuildwheel@9c00cb4f6b517705a3794b22395aedc36257242c # v3.2.1
+ uses: pypa/cibuildwheel@298ed2fb2c105540f5ed055e8a6ad78d82dd3a7e # v3.3.1
with:
package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
env:
@@ -170,7 +170,7 @@ jobs:
CIBW_ARCHS: ${{ matrix.cibw_archs }}
- name: Build wheels for CPython 3.11
- uses: pypa/cibuildwheel@9c00cb4f6b517705a3794b22395aedc36257242c # v3.2.1
+ uses: pypa/cibuildwheel@298ed2fb2c105540f5ed055e8a6ad78d82dd3a7e # v3.3.1
with:
package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
env:
@@ -178,7 +178,7 @@ jobs:
CIBW_ARCHS: ${{ matrix.cibw_archs }}
- name: Build wheels for PyPy
- uses: pypa/cibuildwheel@9c00cb4f6b517705a3794b22395aedc36257242c # v3.2.1
+ uses: pypa/cibuildwheel@298ed2fb2c105540f5ed055e8a6ad78d82dd3a7e # v3.3.1
with:
package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
env:
@@ -187,7 +187,7 @@ jobs:
CIBW_ENABLE: pypy
if: matrix.cibw_archs != 'aarch64' && matrix.os != 'windows-latest' && matrix.os != 'windows-11-arm'
- - uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
+ - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
with:
name: cibw-wheels-${{ runner.os }}-${{ matrix.cibw_archs }}
path: ./wheelhouse/*.whl
diff --git a/.github/workflows/circleci.yml b/.github/workflows/circleci.yml
index ab410b194754..05a30eb032cb 100644
--- a/.github/workflows/circleci.yml
+++ b/.github/workflows/circleci.yml
@@ -28,7 +28,7 @@ jobs:
runs-on: ubuntu-latest
name: Post warnings/errors as review
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
persist-credentials: false
@@ -41,7 +41,7 @@ jobs:
- name: Set up reviewdog
if: "${{ steps.fetch-artifacts.outputs.count != 0 }}"
- uses: reviewdog/action-setup@d8edfce3dd5e1ec6978745e801f9c50b5ef80252 # v1.4.0
+ uses: reviewdog/action-setup@d8a7baabd7f3e8544ee4dbde3ee41d0011c3a93f # v1.5.0
with:
reviewdog_version: latest
diff --git a/.github/workflows/clean_pr.yml b/.github/workflows/clean_pr.yml
index fdfc446af15b..5107bb92fa1c 100644
--- a/.github/workflows/clean_pr.yml
+++ b/.github/workflows/clean_pr.yml
@@ -10,7 +10,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
fetch-depth: '0'
persist-credentials: false
diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 72d84e46e077..2aa1ce9f911d 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -27,12 +27,12 @@ jobs:
steps:
- name: Checkout repository
- uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
persist-credentials: false
- name: Initialize CodeQL
- uses: github/codeql-action/init@4e94bd11f71e507f7f87df81788dff88d1dacbfb # v4.31.0
+ uses: github/codeql-action/init@5d4e8d1aca955e8d8589aabd499c5cae939e33c7 # v4.31.9
with:
languages: ${{ matrix.language }}
@@ -43,4 +43,4 @@ jobs:
pip install --user -v .
- name: Perform CodeQL Analysis
- uses: github/codeql-action/analyze@4e94bd11f71e507f7f87df81788dff88d1dacbfb # v4.31.0
+ uses: github/codeql-action/analyze@5d4e8d1aca955e8d8589aabd499c5cae939e33c7 # v4.31.9
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index ba1fd6f57790..ae80020e08b7 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -79,7 +79,7 @@ jobs:
- name: Fix line endings
run: git config --global core.autocrlf input
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
fetch-depth: 0
persist-credentials: false
@@ -140,21 +140,21 @@ jobs:
# FreeType build fails with bash, succeeds with dash
- name: Cache pip
- uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+ uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5.0.1
with:
path: C:\cygwin\home\runneradmin\.cache\pip
key: Cygwin-py3.${{ matrix.python-minor-version }}-pip-${{ hashFiles('requirements/*/*.txt') }}
restore-keys: ${{ matrix.os }}-py3.${{ matrix.python-minor-version }}-pip-
- name: Cache ccache
- uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+ uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5.0.1
with:
path: C:\cygwin\home\runneradmin\.ccache
key: Cygwin-py3.${{ matrix.python-minor-version }}-ccache-${{ hashFiles('src/*') }}
restore-keys: Cygwin-py3.${{ matrix.python-minor-version }}-ccache-
- name: Cache Matplotlib
- uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+ uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5.0.1
with:
path: |
C:\cygwin\home\runneradmin\.cache\matplotlib
diff --git a/.github/workflows/linting.yml b/.github/workflows/linting.yml
index f1c6d21019e3..bcc7d406043a 100644
--- a/.github/workflows/linting.yml
+++ b/.github/workflows/linting.yml
@@ -10,11 +10,11 @@ jobs:
name: precommit
runs-on: ubuntu-latest
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
fetch-depth: 0
persist-credentials: false
- - uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+ - uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
with:
python-version: "3.x"
- uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1
@@ -27,12 +27,12 @@ jobs:
permissions:
checks: write
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
persist-credentials: false
- name: Set up Python 3
- uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+ uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
with:
python-version: '3.11'
@@ -40,7 +40,7 @@ jobs:
run: pip3 install ruff
- name: Set up reviewdog
- uses: reviewdog/action-setup@d8edfce3dd5e1ec6978745e801f9c50b5ef80252 # v1.4.0
+ uses: reviewdog/action-setup@d8a7baabd7f3e8544ee4dbde3ee41d0011c3a93f # v1.5.0
- name: Run ruff
env:
@@ -56,12 +56,12 @@ jobs:
permissions:
checks: write
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
persist-credentials: false
- name: Set up Python 3
- uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+ uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
with:
python-version: '3.11'
@@ -69,7 +69,7 @@ jobs:
run: pip3 install -r requirements/testing/mypy.txt -r requirements/testing/all.txt
- name: Set up reviewdog
- uses: reviewdog/action-setup@d8edfce3dd5e1ec6978745e801f9c50b5ef80252 # v1.4.0
+ uses: reviewdog/action-setup@d8a7baabd7f3e8544ee4dbde3ee41d0011c3a93f # v1.5.0
- name: Run mypy
env:
@@ -87,7 +87,7 @@ jobs:
permissions:
checks: write
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
persist-credentials: false
diff --git a/.github/workflows/mypy-stubtest.yml b/.github/workflows/mypy-stubtest.yml
index 3815efd08954..dad980b4fae9 100644
--- a/.github/workflows/mypy-stubtest.yml
+++ b/.github/workflows/mypy-stubtest.yml
@@ -12,17 +12,17 @@ jobs:
permissions:
checks: write
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
persist-credentials: false
- name: Set up Python 3
- uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+ uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
with:
python-version: '3.11'
- name: Set up reviewdog
- uses: reviewdog/action-setup@d8edfce3dd5e1ec6978745e801f9c50b5ef80252 # v1.4.0
+ uses: reviewdog/action-setup@d8a7baabd7f3e8544ee4dbde3ee41d0011c3a93f # v1.5.0
- name: Install tox
run: python -m pip install tox
diff --git a/.github/workflows/nightlies.yml b/.github/workflows/nightlies.yml
index 393ce2e73472..e8ff8ad7acbc 100644
--- a/.github/workflows/nightlies.yml
+++ b/.github/workflows/nightlies.yml
@@ -59,7 +59,7 @@ jobs:
ls -l dist/
- name: Upload wheels to Anaconda Cloud as nightlies
- uses: scientific-python/upload-nightly-action@b36e8c0c10dbcfd2e05bf95f17ef8c14fd708dbf # 0.6.2
+ uses: scientific-python/upload-nightly-action@5748273c71e2d8d3a61f3a11a16421c8954f9ecf # 0.6.3
with:
artifacts_path: dist
anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
diff --git a/.github/workflows/stale-tidy.yml b/.github/workflows/stale-tidy.yml
index 85c8fec38e63..1d0d42ce761b 100644
--- a/.github/workflows/stale-tidy.yml
+++ b/.github/workflows/stale-tidy.yml
@@ -9,7 +9,7 @@ jobs:
if: github.repository == 'matplotlib/matplotlib'
runs-on: ubuntu-latest
steps:
- - uses: actions/stale@5f858e3efba33a5ca4407a664cc011ad407f2008 # v10.1.0
+ - uses: actions/stale@997185467fa4f803885201cee163a9f38240193d # v10.1.1
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}
operations-per-run: 300
@@ -20,5 +20,5 @@ jobs:
close-issue-label: "status: closed as inactive"
days-before-issue-close: 30
ascending: true
- exempt-issue-labels: "keep"
+ exempt-issue-labels: "keep,status: confirmed bug"
exempt-pr-labels: "keep,status: orphaned PR"
diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index bbc58eca4fb0..a61a0b2e92c8 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -2,14 +2,14 @@
name: 'Label inactive PRs'
on:
schedule:
- - cron: '30 1 * * 1,3,5'
+ - cron: '30 1 * * 1'
jobs:
stale:
if: github.repository == 'matplotlib/matplotlib'
runs-on: ubuntu-latest
steps:
- - uses: actions/stale@5f858e3efba33a5ca4407a664cc011ad407f2008 # v10.1.0
+ - uses: actions/stale@997185467fa4f803885201cee163a9f38240193d # v10.1.1
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}
operations-per-run: 20
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 048f11be14d2..28e2fcacb4ae 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -73,6 +73,8 @@ jobs:
pygobject-ver: '<3.52.0'
- os: ubuntu-24.04
python-version: '3.12'
+ - os: ubuntu-24.04
+ python-version: '3.14'
- os: ubuntu-24.04-arm
python-version: '3.12'
- os: macos-14 # This runner is on M1 (arm64) chips.
@@ -87,15 +89,19 @@ jobs:
python-version: '3.13'
# https://github.com/matplotlib/matplotlib/issues/29732
pygobject-ver: '<3.52.0'
+ - os: macos-15 # This runner is on M1 (arm64) chips.
+ python-version: '3.14'
+ # https://github.com/matplotlib/matplotlib/issues/29732
+ pygobject-ver: '<3.52.0'
steps:
- - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+ - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
with:
fetch-depth: 0
persist-credentials: false
- name: Set up Python ${{ matrix.python-version }}
- uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+ uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
with:
python-version: ${{ matrix.python-version }}
allow-prereleases: true
@@ -178,7 +184,7 @@ jobs:
esac
- name: Cache pip
- uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+ uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5.0.1
if: startsWith(runner.os, 'Linux')
with:
path: ~/.cache/pip
@@ -186,7 +192,7 @@ jobs:
restore-keys: |
${{ matrix.os }}-py${{ matrix.python-version }}-pip-
- name: Cache pip
- uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+ uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5.0.1
if: startsWith(runner.os, 'macOS')
with:
path: ~/Library/Caches/pip
@@ -194,7 +200,7 @@ jobs:
restore-keys: |
${{ matrix.os }}-py${{ matrix.python-version }}-pip-
- name: Cache ccache
- uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+ uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5.0.1
with:
path: |
~/.ccache
@@ -202,7 +208,7 @@ jobs:
restore-keys: |
${{ matrix.os }}-py${{ matrix.python-version }}-ccache-
- name: Cache Matplotlib
- uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+ uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5.0.1
with:
path: |
~/.cache/matplotlib
@@ -264,8 +270,8 @@ jobs:
# Even though PySide2 wheels can be installed on Python 3.12+, they are broken and since PySide2 is
# deprecated, they are unlikely to be fixed. For the same deprecation reason, there are no wheels
# on M1 macOS, so don't bother there either.
- if [[ "${{ matrix.os }}" != 'macos-14'
- && "${{ matrix.python-version }}" != '3.12' && "${{ matrix.python-version }}" != '3.13' ]]; then
+ if [[ "${{ matrix.os }}" != 'macos-14' && "${{ matrix.python-version }}" == '3.11'
+ ]]; then
python -mpip install --upgrade pyside2 &&
python -c 'import PySide2.QtCore' &&
echo 'PySide2 is available' ||
@@ -389,12 +395,12 @@ jobs:
fi
- name: Upload code coverage
if: ${{ !cancelled() && github.event_name != 'schedule' }}
- uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5.5.1
+ uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5.5.2
with:
name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"
token: ${{ secrets.CODECOV_TOKEN }}
- - uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
+ - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
if: failure()
with:
name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }} result images"
diff --git a/.gitignore b/.gitignore
index 9389a1612b14..0460152a792f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -104,6 +104,10 @@ __conda_version__.txt
lib/png.lib
lib/z.lib
+# uv files #
+############
+uv.lock
+
# Environments #
################
.env
diff --git a/doc/_static/switcher.json b/doc/_static/switcher.json
index 3912afd8a17d..36e743db21b8 100644
--- a/doc/_static/switcher.json
+++ b/doc/_static/switcher.json
@@ -1,7 +1,7 @@
[
{
"name": "3.10 (stable)",
- "version": "3.10.7",
+ "version": "3.10.8",
"url": "https://matplotlib.org/stable/",
"preferred": true
},
diff --git a/doc/api/artist_api.rst b/doc/api/artist_api.rst
index 0ca3fb364c41..f256d2b7164e 100644
--- a/doc/api/artist_api.rst
+++ b/doc/api/artist_api.rst
@@ -122,6 +122,7 @@ Figure and Axes
Artist.set_figure
Artist.get_figure
+ Artist.figure
Children
--------
diff --git a/doc/api/axes_api.rst b/doc/api/axes_api.rst
index f5af8744a2bc..1868794dd921 100644
--- a/doc/api/axes_api.rst
+++ b/doc/api/axes_api.rst
@@ -628,6 +628,8 @@ Other
Axes.get_transformed_clip_path_and_affine
Axes.has_data
Axes.set
+ Axes.get_figure
+ Axes.figure
Axes.remove
.. autoclass:: matplotlib.axes.Axes.ArtistList
diff --git a/doc/api/matplotlib_configuration_api.rst b/doc/api/matplotlib_configuration_api.rst
index d5dc60c80613..b2fafc08e5fc 100644
--- a/doc/api/matplotlib_configuration_api.rst
+++ b/doc/api/matplotlib_configuration_api.rst
@@ -24,8 +24,24 @@ Default values and styling
==========================
.. py:data:: rcParams
+ :type: RcParams
+
+ The global configuration settings for Matplotlib.
+
+ This is a dictionary-like variable that stores the current configuration
+ settings. Many of the values control styling, but others control
+ various aspects of Matplotlib's behavior.
+
+ See :doc:`/users/explain/configuration` for a full list of config
+ parameters.
+
+ See :ref:`customizing` for usage information.
+
+ Notes
+ -----
+ This object is also available as ``plt.rcParams`` via the
+ `matplotlib.pyplot` module (which by convention is imported as ``plt``).
- An instance of `RcParams` for handling default Matplotlib values.
.. autoclass:: RcParams
:no-members:
diff --git a/doc/api/next_api_changes/behavior/28437-CH.rst b/doc/api/next_api_changes/behavior/28437-CH.rst
index 6121dfec8163..bb303bbe9d3b 100644
--- a/doc/api/next_api_changes/behavior/28437-CH.rst
+++ b/doc/api/next_api_changes/behavior/28437-CH.rst
@@ -2,7 +2,7 @@
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
When passing and array to ``imshow(..., alpha=...)``, the parameter was silently ignored
-if the image data was a RGB or RBGA image or if :rc:`interpolation_state`
+if the image data was an RGB or RBGA image or if :rc:`image.interpolation_stage`
resolved to "rbga".
This is now fixed, and the alpha array overwrites any previous transparency information.
diff --git a/doc/api/next_api_changes/behavior/30824-AYS.rst b/doc/api/next_api_changes/behavior/30824-AYS.rst
new file mode 100644
index 000000000000..a190bd537126
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/30824-AYS.rst
@@ -0,0 +1,6 @@
+Bivariate colormaps now fully span the intended range of colors
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Bivariate colormaps generated by ``SegmentedBivarColormap`` (e.g., ``BiOrangeBlue``)
+from a set of input colors now fully span that range of colors. There had been a bug
+with the numerical interpolation such that the colormap did not actually include the
+first or last colors.
diff --git a/doc/api/next_api_changes/deprecations/30889-TH.rst b/doc/api/next_api_changes/deprecations/30889-TH.rst
new file mode 100644
index 000000000000..d221ae30d4fb
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/30889-TH.rst
@@ -0,0 +1,10 @@
+Transforms helper functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following functions in the `.transforms` module are deprecated,
+because they are considerer internal functionality and should not be used
+by end users:
+
+- ``matplotlib.transforms.nonsingular``
+- ``matplotlib.transforms.interval_contains``
+- ``matplotlib.transforms.interval_contains_open``
diff --git a/doc/api/prev_api_changes/api_changes_3.10.1.rst b/doc/api/prev_api_changes/api_changes_3.10.1.rst
index 26d43ddf8b17..71a2f71efc94 100644
--- a/doc/api/prev_api_changes/api_changes_3.10.1.rst
+++ b/doc/api/prev_api_changes/api_changes_3.10.1.rst
@@ -8,7 +8,7 @@ Behaviour
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
When passing and array to ``imshow(..., alpha=...)``, the parameter was silently ignored
-if the image data was a RGB or RBGA image or if :rc:`interpolation_state`
+if the image data was an RGB or RBGA image or if :rc:`image.interpolation_stage`
resolved to "rbga".
This is now fixed, and the alpha array overwrites any previous transparency information.
diff --git a/doc/api/widgets_api.rst b/doc/api/widgets_api.rst
index 014361e70377..739b0f8931e0 100644
--- a/doc/api/widgets_api.rst
+++ b/doc/api/widgets_api.rst
@@ -2,11 +2,53 @@
``matplotlib.widgets``
**********************
-.. inheritance-diagram:: matplotlib.widgets
+.. currentmodule:: matplotlib.widgets
+
+.. automodule:: matplotlib.widgets
+ :no-members:
+ :no-undoc-members:
+
+
+Widget classes
+==============
+
+.. inheritance-diagram:: matplotlib.widgets.Widget
:parts: 1
+ :private-bases:
+ :include-subclasses:
+.. autosummary::
+ :toctree: _as_gen
+ :template: autosummary.rst
+ :nosignatures:
-.. automodule:: matplotlib.widgets
- :members:
- :undoc-members:
- :show-inheritance:
+ Widget
+ AxesWidget
+ Cursor
+ MultiCursor
+ Button
+ CheckButtons
+ RadioButtons
+ SliderBase
+ Slider
+ RangeSlider
+ TextBox
+ _SelectorWidget
+ RectangleSelector
+ EllipseSelector
+ Lasso
+ LassoSelector
+ PolygonSelector
+ SpanSelector
+ SubplotTool
+
+Helper classes
+==============
+
+.. autosummary::
+ :toctree: _as_gen
+ :nosignatures:
+
+ LockDraw
+ ToolHandles
+ ToolLineHandles
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 3667d6e20a5d..bd4fe8e64c52 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -337,7 +337,7 @@ Start a pull request
The preferred way to contribute to Matplotlib is to fork the `main
repository `__ on GitHub,
-then submit a "pull request" (PR). To work on a a pull request:
+then submit a "pull request" (PR). To work on a pull request:
#. **First** set up a development environment, either by cloning a copy of the
Matplotlib repository to your own computer or by using Github codespaces, by
diff --git a/doc/devel/license.rst b/doc/devel/license.rst
index 7596f2f92348..ebdfd494f832 100644
--- a/doc/devel/license.rst
+++ b/doc/devel/license.rst
@@ -10,7 +10,7 @@ another project make sure it has a PSF, BSD, MIT or compatible license
licenses). If it doesn't, you may consider contacting the author and
asking them to relicense it. GPL and LGPL code are not acceptable in
the main code base, though we are considering an alternative way of
-distributing L/GPL code through an separate channel, possibly a
+distributing L/GPL code through a separate channel, possibly a
toolkit. If you include code, make sure you include a copy of that
code's license in the license directory if the code's license requires
you to distribute the license with it. Non-BSD compatible licenses
diff --git a/doc/install/dependencies.rst b/doc/install/dependencies.rst
index 11317669817f..d0567900ea4c 100644
--- a/doc/install/dependencies.rst
+++ b/doc/install/dependencies.rst
@@ -31,6 +31,16 @@ reference.
* `Pillow `_ (>= 9.0)
* `pyparsing `_ (>= 3)
+.. note::
+
+ With **conda packages**, this set of minimal dependencies is realized in
+ the ``matplotlib-base`` conda package. Other packages in the conda
+ ecosystem that depend on Matplotlib should depend on ``matplotlib-base``.
+
+ The ``matplotlib`` conda package additionally comes with ``pyside6``
+ to have a working GUI backend out of the box for end users. This should
+ primarily be used to define end-user environments. See also the
+ `conda forge documentation `__.
.. _optional_dependencies:
diff --git a/doc/missing-references.json b/doc/missing-references.json
index 1a3693c990e5..d27d2fa067ce 100644
--- a/doc/missing-references.json
+++ b/doc/missing-references.json
@@ -4,7 +4,7 @@
":1"
],
"matplotlib.axes._base._AxesBase": [
- "doc/api/artist_api.rst:202"
+ "doc/api/artist_api.rst:203"
],
"matplotlib.backend_bases._Backend": [
"lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.ShowBase:1"
@@ -18,7 +18,7 @@
"lib/matplotlib/backends/backend_tkcairo.py:docstring of matplotlib.backends.backend_tkcairo.FigureCanvasTkCairo:1"
],
"matplotlib.image._ImageBase": [
- "doc/api/artist_api.rst:202",
+ "doc/api/artist_api.rst:203",
"lib/matplotlib/image.py:docstring of matplotlib.image.AxesImage:1",
"lib/matplotlib/image.py:docstring of matplotlib.image.BboxImage:1",
"lib/matplotlib/image.py:docstring of matplotlib.image.FigureImage:1"
@@ -67,7 +67,7 @@
"lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform:1"
],
"matplotlib.text._AnnotationBase": [
- "doc/api/artist_api.rst:202",
+ "doc/api/artist_api.rst:203",
"lib/matplotlib/offsetbox.py:docstring of matplotlib.offsetbox.AnnotationBbox:1",
"lib/matplotlib/text.py:docstring of matplotlib.text.Annotation:1"
],
diff --git a/doc/release/github_stats.rst b/doc/release/github_stats.rst
index 99ea3fa9c167..cd9e71ff9376 100644
--- a/doc/release/github_stats.rst
+++ b/doc/release/github_stats.rst
@@ -2,20 +2,19 @@
.. _github-stats:
-GitHub statistics for 3.10.7 (Oct 08, 2025)
+GitHub statistics for 3.10.8 (Nov 12, 2025)
===========================================
-GitHub statistics for 2024/12/14 (tag: v3.10.0) - 2025/10/08
+GitHub statistics for 2024/12/14 (tag: v3.10.0) - 2025/11/12
These lists are automatically generated, and may be incomplete or contain duplicates.
We closed 4 issues and merged 16 pull requests.
-The full list can be seen `on GitHub `__
+The full list can be seen `on GitHub `__
-The following 32 authors contributed 422 commits.
+The following 35 authors contributed 445 commits.
* Aasma Gupta
-* AASMA GUPTA
* Antony Lee
* Christine P. Chai
* David Stansby
@@ -24,6 +23,7 @@ The following 32 authors contributed 422 commits.
* G.D. McBain
* Greg Lucas
* hannah
+* heinrich5991
* hu-xiaonan
* Ian Thomas
* Inês Cachola
@@ -31,19 +31,22 @@ The following 32 authors contributed 422 commits.
* Jouni K. Seppänen
* Khushi_29
* Kyle Sunden
+* Lucas Gruwez
* Lumberbot (aka Jack)
* N R Navaneet
* Nathan G. Wiseman
+* Nathan Goldbaum
+* Nick Coish
* Oscar Gustafsson
* Praful Gulani
* Qian Zhang
+* Rafael Katri
* Raphael Erik Hviding
* Roman
* Ruth Comer
* saikarna913
* Scott Shambaugh
* Thomas A Caswell
-* Tim Heap
* Tim Hoffmann
* Trygve Magnus Ræder
@@ -51,29 +54,29 @@ GitHub issues and pull requests:
Pull Requests (16):
-* :ghpull:`30628`: Backport PR #30626 on branch v3.10.x (MNT: Fix new F401 unused imports warnings)
-* :ghpull:`30626`: MNT: Fix new F401 unused imports warnings
-* :ghpull:`30589`: Backport PR #29745: Use PEP8 style method and function names from
-* :ghpull:`30614`: Backport PR #30612 on branch v3.10.x (MNT: update black pin)
-* :ghpull:`30612`: MNT: update black pin
-* :ghpull:`30572`: Backport PR #30571 on branch v3.10.x (CI: remove macos13)
-* :ghpull:`30571`: CI: remove macos13
-* :ghpull:`30570`: Backport PR #30558 on branch v3.10.x (Fix stubtest with mypy 18)
-* :ghpull:`30558`: Fix stubtest with mypy 18
-* :ghpull:`30540`: Backport PR #30539 on branch v3.10.x (Fix scale_unit/scale_units typo in quiver docs)
-* :ghpull:`30539`: Fix scale_unit/scale_units typo in quiver docs
-* :ghpull:`30518`: Backport PR #30497 on branch v3.10.x (TST: Use a temporary directory for test_save_figure_return)
-* :ghpull:`30497`: TST: Use a temporary directory for test_save_figure_return
-* :ghpull:`30506`: Backport PR #30490 on branch v3.10.x (Fix SVG rendering error in def update_background)
-* :ghpull:`30490`: Fix SVG rendering error in def update_background
-* :ghpull:`30494`: Backport PR #30492 on branch v3.10.x (DOC: pytz link should be from PyPI)
+* :ghpull:`30717`: Backport PR #30714 on branch v3.10.x (FIX: Gracefully handle numpy arrays as input to check_in_list())
+* :ghpull:`30714`: FIX: Gracefully handle numpy arrays as input to check_in_list()
+* :ghpull:`30560`: Consistent zoom boxes
+* :ghpull:`30711`: Backport PR #30697 on branch v3.10.x (BUG: raise when creating a MacOS FigureManager outside the main thread)
+* :ghpull:`30697`: BUG: raise when creating a MacOS FigureManager outside the main thread
+* :ghpull:`30656`: Backport PR #29810 on branch v3.10.x (Declare free-threaded support in MacOS backend extension)
+* :ghpull:`30702`: Backport PR #30624 on branch v3.10.x (TST: Increase tolerances for Ghostscript 10.06)
+* :ghpull:`30700`: Backport PR #30698 on branch v3.10.x (BLD: update trove metadata to support py3.14)
+* :ghpull:`30624`: TST: Increase tolerances for Ghostscript 10.06
+* :ghpull:`30698`: BLD: update trove metadata to support py3.14
+* :ghpull:`30688`: Backport PR #30687 on branch v3.10.x (DOC: Fix pip link)
+* :ghpull:`30675`: Backport PR #30657 on branch v3.10.x (Fix AttributeError: module 'gi' has no attribute 'require_version')
+* :ghpull:`30674`: Backport PR #30672 on branch v3.10.x (Use pathlib.Path instead of matplotlib.path.Path in text.pyi)
+* :ghpull:`30672`: Use pathlib.Path instead of matplotlib.path.Path in text.pyi
+* :ghpull:`30657`: Fix ``AttributeError: module 'gi' has no attribute 'require_version'``
+* :ghpull:`29810`: Declare free-threaded support in MacOS backend extension
Issues (4):
-* :ghissue:`30611`: [MNT]: black version
-* :ghissue:`30551`: [Bug]: Mypy stubtest failure on disjoint_base
-* :ghissue:`30493`: [Bug]: test_save_figure_return seems flaky
-* :ghissue:`30485`: [Bug]: figures with SpanSelector(..., useblit=True) can't be saved to SVG or PDF
+* :ghissue:`30706`: [Bug]: Axes.grouped_bar() with non-string orientation (e.g., NumPy array) raises ambiguous truth-value error instead of clean ValueError
+* :ghissue:`30666`: [Bug]: calling pyplot.gca() outside the main thread crashes the interpreter with the MacOS backend
+* :ghissue:`30669`: [Bug]: Type hint for fontproperties keyword in text.pyi is wrong
+* :ghissue:`30654`: [Bug]: error plotting: AttributeError: module 'gi' has no attribute 'require_version'
Previous GitHub statistics
diff --git a/doc/release/next_whats_new/README.rst b/doc/release/next_whats_new/README.rst
index a680f5120f52..1a7039a4a5db 100644
--- a/doc/release/next_whats_new/README.rst
+++ b/doc/release/next_whats_new/README.rst
@@ -34,7 +34,7 @@ Include contents of the form::
details should be left out when they do not impact usage, for example
implementation details.
- The description may include a a short instructive example, if it helps to
+ The description may include a short instructive example, if it helps to
understand the feature.
Please avoid using references in section titles, as it causes links to be
diff --git a/doc/release/next_whats_new/hist_color.rst b/doc/release/next_whats_new/hist_color.rst
new file mode 100644
index 000000000000..2d6a4adb3464
--- /dev/null
+++ b/doc/release/next_whats_new/hist_color.rst
@@ -0,0 +1,5 @@
+``hist()`` supports a single color for multiple datasets
+--------------------------------------------------------
+
+It is now possible to pass a single *color* value to `~.Axes.hist()`. This
+value is applied to all datasets.
diff --git a/doc/release/prev_whats_new/github_stats_3.10.7.rst b/doc/release/prev_whats_new/github_stats_3.10.7.rst
new file mode 100644
index 000000000000..8c12e4050219
--- /dev/null
+++ b/doc/release/prev_whats_new/github_stats_3.10.7.rst
@@ -0,0 +1,74 @@
+.. _github-stats_3-10-7:
+
+GitHub statistics for 3.10.7 (Oct 08, 2025)
+===========================================
+
+GitHub statistics for 2024/12/14 (tag: v3.10.0) - 2025/10/08
+
+These lists are automatically generated, and may be incomplete or contain duplicates.
+
+We closed 4 issues and merged 16 pull requests.
+The full list can be seen `on GitHub `__
+
+The following 32 authors contributed 422 commits.
+
+* Aasma Gupta
+* AASMA GUPTA
+* Antony Lee
+* Christine P. Chai
+* David Stansby
+* dependabot[bot]
+* Elliott Sales de Andrade
+* G.D. McBain
+* Greg Lucas
+* hannah
+* hu-xiaonan
+* Ian Thomas
+* Inês Cachola
+* Jody Klymak
+* Jouni K. Seppänen
+* Khushi_29
+* Kyle Sunden
+* Lumberbot (aka Jack)
+* N R Navaneet
+* Nathan G. Wiseman
+* Oscar Gustafsson
+* Praful Gulani
+* Qian Zhang
+* Raphael Erik Hviding
+* Roman
+* Ruth Comer
+* saikarna913
+* Scott Shambaugh
+* Thomas A Caswell
+* Tim Heap
+* Tim Hoffmann
+* Trygve Magnus Ræder
+
+GitHub issues and pull requests:
+
+Pull Requests (16):
+
+* :ghpull:`30628`: Backport PR #30626 on branch v3.10.x (MNT: Fix new F401 unused imports warnings)
+* :ghpull:`30626`: MNT: Fix new F401 unused imports warnings
+* :ghpull:`30589`: Backport PR #29745: Use PEP8 style method and function names from
+* :ghpull:`30614`: Backport PR #30612 on branch v3.10.x (MNT: update black pin)
+* :ghpull:`30612`: MNT: update black pin
+* :ghpull:`30572`: Backport PR #30571 on branch v3.10.x (CI: remove macos13)
+* :ghpull:`30571`: CI: remove macos13
+* :ghpull:`30570`: Backport PR #30558 on branch v3.10.x (Fix stubtest with mypy 18)
+* :ghpull:`30558`: Fix stubtest with mypy 18
+* :ghpull:`30540`: Backport PR #30539 on branch v3.10.x (Fix scale_unit/scale_units typo in quiver docs)
+* :ghpull:`30539`: Fix scale_unit/scale_units typo in quiver docs
+* :ghpull:`30518`: Backport PR #30497 on branch v3.10.x (TST: Use a temporary directory for test_save_figure_return)
+* :ghpull:`30497`: TST: Use a temporary directory for test_save_figure_return
+* :ghpull:`30506`: Backport PR #30490 on branch v3.10.x (Fix SVG rendering error in def update_background)
+* :ghpull:`30490`: Fix SVG rendering error in def update_background
+* :ghpull:`30494`: Backport PR #30492 on branch v3.10.x (DOC: pytz link should be from PyPI)
+
+Issues (4):
+
+* :ghissue:`30611`: [MNT]: black version
+* :ghissue:`30551`: [Bug]: Mypy stubtest failure on disjoint_base
+* :ghissue:`30493`: [Bug]: test_save_figure_return seems flaky
+* :ghissue:`30485`: [Bug]: figures with SpanSelector(..., useblit=True) can't be saved to SVG or PDF
diff --git a/doc/release/prev_whats_new/whats_new_0.98.4.rst b/doc/release/prev_whats_new/whats_new_0.98.4.rst
index fb08b8355971..8091c1277a5d 100644
--- a/doc/release/prev_whats_new/whats_new_0.98.4.rst
+++ b/doc/release/prev_whats_new/whats_new_0.98.4.rst
@@ -138,7 +138,7 @@ psd amplitude scaling
Ryan May did a lot of work to rationalize the amplitude scaling of
:func:`~matplotlib.pyplot.psd` and friends. See
-:doc:`/gallery/lines_bars_and_markers/psd_demo`.
+:doc:`/gallery/statistics/psd_demo`.
The changes should increase MATLAB
compatibility and increase scaling options.
diff --git a/doc/release/release_notes.rst b/doc/release/release_notes.rst
index b8bd756ce69b..8ea4ad3d4f57 100644
--- a/doc/release/release_notes.rst
+++ b/doc/release/release_notes.rst
@@ -23,6 +23,7 @@ Version 3.10
../api/prev_api_changes/api_changes_3.10.1.rst
../api/prev_api_changes/api_changes_3.10.0.rst
github_stats.rst
+ prev_whats_new/github_stats_3.10.7.rst
prev_whats_new/github_stats_3.10.6.rst
prev_whats_new/github_stats_3.10.5.rst
prev_whats_new/github_stats_3.10.3.rst
diff --git a/doc/users/_rcparams_generated.rst b/doc/users/_rcparams_generated.rst
new file mode 100644
index 000000000000..19f972771ea9
--- /dev/null
+++ b/doc/users/_rcparams_generated.rst
@@ -0,0 +1,1674 @@
+..
+ autogenerated rcParams documentation. Update via
+ > python -c "from matplotlib import rcsetup; rcsetup._write_rcParam_rst()"
+
+
+.. _rcparam_webagg_port:
+
+webagg.port: ``8988``
+ The port to use for the web server in the WebAgg backend.
+
+.. _rcparam_webagg_address:
+
+webagg.address: ``'127.0.0.1'``
+ The address on which the WebAgg web server should be reachable.
+
+.. _rcparam_webagg_port_retries:
+
+webagg.port_retries: ``50``
+ If webagg.port is unavailable, a number of other random ports will be tried until one that is available is found.
+
+.. _rcparam_webagg_open_in_browser:
+
+webagg.open_in_browser: ``True``
+ When True, open the web browser to the plot that is shown
+
+.. _rcparam_backend_fallback:
+
+backend_fallback: ``True``
+ If you are running pyplot inside a GUI and your backend choice conflicts, we will automatically try to find a compatible one for you if backend_fallback is True
+
+.. _rcparam_interactive:
+
+interactive: ``False``
+ *no description*
+
+.. _rcparam_figure_hooks:
+
+figure.hooks: ``[]``
+ list of dotted.module.name:dotted.callable.name
+
+.. _rcparam_toolbar:
+
+toolbar: ``'toolbar2'``
+ {None, toolbar2, toolmanager}
+
+.. _rcparam_timezone:
+
+timezone: ``'UTC'``
+ a pytz timezone string, e.g., US/Central or Europe/Paris
+
+.. _rcparam_lines_linewidth:
+
+lines.linewidth: ``1.5``
+ line width in points
+
+.. _rcparam_lines_linestyle:
+
+lines.linestyle: ``'-'``
+ solid line
+
+.. _rcparam_lines_color:
+
+lines.color: ``'C0'``
+ has no affect on plot(); see axes.prop_cycle
+
+.. _rcparam_lines_marker:
+
+lines.marker: ``'None'``
+ the default marker
+
+.. _rcparam_lines_markerfacecolor:
+
+lines.markerfacecolor: ``'auto'``
+ the default marker face color
+
+.. _rcparam_lines_markeredgecolor:
+
+lines.markeredgecolor: ``'auto'``
+ the default marker edge color
+
+.. _rcparam_lines_markeredgewidth:
+
+lines.markeredgewidth: ``1.0``
+ the line width around the marker symbol
+
+.. _rcparam_lines_markersize:
+
+lines.markersize: ``6.0``
+ marker size, in points
+
+.. _rcparam_lines_dash_joinstyle:
+
+lines.dash_joinstyle: ``'round'``
+ {miter, round, bevel}
+
+.. _rcparam_lines_dash_capstyle:
+
+lines.dash_capstyle: ``'butt'``
+ {butt, round, projecting}
+
+.. _rcparam_lines_solid_joinstyle:
+
+lines.solid_joinstyle: ``'round'``
+ {miter, round, bevel}
+
+.. _rcparam_lines_solid_capstyle:
+
+lines.solid_capstyle: ``'projecting'``
+ {butt, round, projecting}
+
+.. _rcparam_lines_antialiased:
+
+lines.antialiased: ``True``
+ render lines in antialiased (no jaggies)
+
+.. _rcparam_lines_dashed_pattern:
+
+lines.dashed_pattern: ``[3.7, 1.6]``
+ The dash pattern for linestyle 'dashed'
+
+.. _rcparam_lines_dashdot_pattern:
+
+lines.dashdot_pattern: ``[6.4, 1.6, 1.0, 1.6]``
+ The dash pattern for linestyle 'dashdot'
+
+.. _rcparam_lines_dotted_pattern:
+
+lines.dotted_pattern: ``[1.0, 1.65]``
+ The dash pattern for linestyle 'dotted'
+
+.. _rcparam_lines_scale_dashes:
+
+lines.scale_dashes: ``True``
+ *no description*
+
+.. _rcparam_markers_fillstyle:
+
+markers.fillstyle: ``'full'``
+ {full, left, right, bottom, top, none}
+
+.. _rcparam_pcolor_shading:
+
+pcolor.shading: ``'auto'``
+ *no description*
+
+.. _rcparam_pcolormesh_snap:
+
+pcolormesh.snap: ``True``
+ Whether to snap the mesh to pixel boundaries. This is provided solely to allow old test images to remain unchanged. Set to False to obtain the previous behavior.
+
+.. _rcparam_patch_linewidth:
+
+patch.linewidth: ``1.0``
+ edge width in points.
+
+.. _rcparam_patch_facecolor:
+
+patch.facecolor: ``'C0'``
+ *no description*
+
+.. _rcparam_patch_edgecolor:
+
+patch.edgecolor: ``'black'``
+ By default, Patches and Collections do not draw edges. This value is only used if facecolor is "none" (an Artist without facecolor and edgecolor would be invisible) or if patch.force_edgecolor is True.
+
+.. _rcparam_patch_force_edgecolor:
+
+patch.force_edgecolor: ``False``
+ By default, Patches and Collections do not draw edges. Set this to True to draw edges with patch.edgedcolor as the default edgecolor. This is mainly relevant for styles.
+
+.. _rcparam_patch_antialiased:
+
+patch.antialiased: ``True``
+ render patches in antialiased (no jaggies)
+
+.. _rcparam_hatch_color:
+
+hatch.color: ``'edge'``
+ *no description*
+
+.. _rcparam_hatch_linewidth:
+
+hatch.linewidth: ``1.0``
+ *no description*
+
+.. _rcparam_boxplot_notch:
+
+boxplot.notch: ``False``
+ *no description*
+
+.. _rcparam_boxplot_vertical:
+
+boxplot.vertical: ``True``
+ *no description*
+
+.. _rcparam_boxplot_whiskers:
+
+boxplot.whiskers: ``1.5``
+ *no description*
+
+.. _rcparam_boxplot_bootstrap:
+
+boxplot.bootstrap: ``None``
+ *no description*
+
+.. _rcparam_boxplot_patchartist:
+
+boxplot.patchartist: ``False``
+ *no description*
+
+.. _rcparam_boxplot_showmeans:
+
+boxplot.showmeans: ``False``
+ *no description*
+
+.. _rcparam_boxplot_showcaps:
+
+boxplot.showcaps: ``True``
+ *no description*
+
+.. _rcparam_boxplot_showbox:
+
+boxplot.showbox: ``True``
+ *no description*
+
+.. _rcparam_boxplot_showfliers:
+
+boxplot.showfliers: ``True``
+ *no description*
+
+.. _rcparam_boxplot_meanline:
+
+boxplot.meanline: ``False``
+ *no description*
+
+.. _rcparam_boxplot_flierprops_color:
+
+boxplot.flierprops.color: ``'black'``
+ *no description*
+
+.. _rcparam_boxplot_flierprops_marker:
+
+boxplot.flierprops.marker: ``'o'``
+ *no description*
+
+.. _rcparam_boxplot_flierprops_markerfacecolor:
+
+boxplot.flierprops.markerfacecolor: ``'none'``
+ *no description*
+
+.. _rcparam_boxplot_flierprops_markeredgecolor:
+
+boxplot.flierprops.markeredgecolor: ``'black'``
+ *no description*
+
+.. _rcparam_boxplot_flierprops_markeredgewidth:
+
+boxplot.flierprops.markeredgewidth: ``1.0``
+ *no description*
+
+.. _rcparam_boxplot_flierprops_markersize:
+
+boxplot.flierprops.markersize: ``6.0``
+ *no description*
+
+.. _rcparam_boxplot_flierprops_linestyle:
+
+boxplot.flierprops.linestyle: ``'none'``
+ *no description*
+
+.. _rcparam_boxplot_flierprops_linewidth:
+
+boxplot.flierprops.linewidth: ``1.0``
+ *no description*
+
+.. _rcparam_boxplot_boxprops_color:
+
+boxplot.boxprops.color: ``'black'``
+ *no description*
+
+.. _rcparam_boxplot_boxprops_linewidth:
+
+boxplot.boxprops.linewidth: ``1.0``
+ *no description*
+
+.. _rcparam_boxplot_boxprops_linestyle:
+
+boxplot.boxprops.linestyle: ``'-'``
+ *no description*
+
+.. _rcparam_boxplot_whiskerprops_color:
+
+boxplot.whiskerprops.color: ``'black'``
+ *no description*
+
+.. _rcparam_boxplot_whiskerprops_linewidth:
+
+boxplot.whiskerprops.linewidth: ``1.0``
+ *no description*
+
+.. _rcparam_boxplot_whiskerprops_linestyle:
+
+boxplot.whiskerprops.linestyle: ``'-'``
+ *no description*
+
+.. _rcparam_boxplot_capprops_color:
+
+boxplot.capprops.color: ``'black'``
+ *no description*
+
+.. _rcparam_boxplot_capprops_linewidth:
+
+boxplot.capprops.linewidth: ``1.0``
+ *no description*
+
+.. _rcparam_boxplot_capprops_linestyle:
+
+boxplot.capprops.linestyle: ``'-'``
+ *no description*
+
+.. _rcparam_boxplot_medianprops_color:
+
+boxplot.medianprops.color: ``'C1'``
+ *no description*
+
+.. _rcparam_boxplot_medianprops_linewidth:
+
+boxplot.medianprops.linewidth: ``1.0``
+ *no description*
+
+.. _rcparam_boxplot_medianprops_linestyle:
+
+boxplot.medianprops.linestyle: ``'-'``
+ *no description*
+
+.. _rcparam_boxplot_meanprops_color:
+
+boxplot.meanprops.color: ``'C2'``
+ *no description*
+
+.. _rcparam_boxplot_meanprops_marker:
+
+boxplot.meanprops.marker: ``'^'``
+ *no description*
+
+.. _rcparam_boxplot_meanprops_markerfacecolor:
+
+boxplot.meanprops.markerfacecolor: ``'C2'``
+ *no description*
+
+.. _rcparam_boxplot_meanprops_markeredgecolor:
+
+boxplot.meanprops.markeredgecolor: ``'C2'``
+ *no description*
+
+.. _rcparam_boxplot_meanprops_markersize:
+
+boxplot.meanprops.markersize: ``6.0``
+ *no description*
+
+.. _rcparam_boxplot_meanprops_linestyle:
+
+boxplot.meanprops.linestyle: ``'--'``
+ *no description*
+
+.. _rcparam_boxplot_meanprops_linewidth:
+
+boxplot.meanprops.linewidth: ``1.0``
+ *no description*
+
+.. _rcparam_font_family:
+
+font.family: ``['sans-serif']``
+ *no description*
+
+.. _rcparam_font_style:
+
+font.style: ``'normal'``
+ *no description*
+
+.. _rcparam_font_variant:
+
+font.variant: ``'normal'``
+ *no description*
+
+.. _rcparam_font_weight:
+
+font.weight: ``'normal'``
+ *no description*
+
+.. _rcparam_font_stretch:
+
+font.stretch: ``'normal'``
+ *no description*
+
+.. _rcparam_font_size:
+
+font.size: ``10.0``
+ *no description*
+
+.. _rcparam_font_serif:
+
+font.serif: ``['DejaVu Serif', 'Bitstream Vera Serif', 'Computer Modern Roman', 'New Century Schoolbook', 'Century Schoolbook L', 'Utopia', 'ITC Bookman', 'Bookman', 'Nimbus Roman No9 L', 'Times New Roman', 'Times', 'Palatino', 'Charter', 'serif']``
+ *no description*
+
+.. _rcparam_font_sans-serif:
+
+font.sans-serif: ``['DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', 'sans-serif']``
+ *no description*
+
+.. _rcparam_font_cursive:
+
+font.cursive: ``['Apple Chancery', 'Textile', 'Zapf Chancery', 'Sand', 'Script MT', 'Felipa', 'Comic Neue', 'Comic Sans MS', 'cursive']``
+ *no description*
+
+.. _rcparam_font_fantasy:
+
+font.fantasy: ``['Chicago', 'Charcoal', 'Impact', 'Western', 'xkcd script', 'fantasy']``
+ *no description*
+
+.. _rcparam_font_monospace:
+
+font.monospace: ``['DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Computer Modern Typewriter', 'Andale Mono', 'Nimbus Mono L', 'Courier New', 'Courier', 'Fixed', 'Terminal', 'monospace']``
+ *no description*
+
+.. _rcparam_font_enable_last_resort:
+
+font.enable_last_resort: ``True``
+ If True, then Unicode Consortium's Last Resort font will be appended to all font selections. This ensures that there will always be a glyph displayed.
+
+.. _rcparam_text_color:
+
+text.color: ``'black'``
+ *no description*
+
+.. _rcparam_text_hinting:
+
+text.hinting: ``'force_autohint'``
+ FreeType hinting flag ("foo" corresponds to FT_LOAD_FOO); may be one of the following (Proprietary Matplotlib-specific synonyms are given in parentheses, but their use is discouraged): - default: Use the font's native hinter if possible, else FreeType's auto-hinter. ("either" is a synonym).- no_autohint: Use the font's native hinter if possible, else don't hint. ("native" is a synonym.)- force_autohint: Use FreeType's auto-hinter. ("auto" is a synonym.)- no_hinting: Disable hinting. ("none" is a synonym.)
+
+.. _rcparam_text_hinting_factor:
+
+text.hinting_factor: ``8``
+ Specifies the amount of softness for hinting in the horizontal direction. A value of 1 will hint to full pixels. A value of 2 will hint to half pixels etc.
+
+.. _rcparam_text_kerning_factor:
+
+text.kerning_factor: ``0``
+ Specifies the scaling factor for kerning values. This is provided solely to allow old test images to remain unchanged. Set to 6 to obtain previous behavior. Values other than 0 or 6 have no defined meaning.
+
+.. _rcparam_text_antialiased:
+
+text.antialiased: ``True``
+ If True (default), the text will be antialiased. This only affects raster outputs.
+
+.. _rcparam_text_parse_math:
+
+text.parse_math: ``True``
+ Use mathtext if there is an even number of unescaped dollar signs.
+
+.. _rcparam_text_usetex:
+
+text.usetex: ``False``
+ use latex for all text handling. The following fonts are supported through the usual rc parameter settings: new century schoolbook, bookman, times, palatino, zapf chancery, charter, serif, sans-serif, helvetica, avant garde, courier, monospace, computer modern roman, computer modern sans serif, computer modern typewriter
+
+.. _rcparam_text_latex_preamble:
+
+text.latex.preamble: ``''``
+ IMPROPER USE OF THIS FEATURE WILL LEAD TO LATEX FAILURES AND IS THEREFORE UNSUPPORTED. PLEASE DO NOT ASK FOR HELP IF THIS FEATURE DOES NOT DO WHAT YOU EXPECT IT TO. text.latex.preamble is a single line of LaTeX code that will be passed on to the LaTeX system. It may contain any code that is valid for the LaTeX "preamble", i.e. between the "\documentclass" and "\begin{document}" statements. Note that it has to be put on a single line, which may become quite long. The following packages are always loaded with usetex, so beware of package collisions: color, fix-cm, geometry, graphicx, textcomp. PostScript (PSNFSS) font packages may also be loaded, depending on your font settings.
+
+.. _rcparam_mathtext_fontset:
+
+mathtext.fontset: ``'dejavusans'``
+ Should be 'dejavusans' (default), 'dejavuserif', 'cm' (Computer Modern), 'stix', 'stixsans' or 'custom'
+
+.. _rcparam_mathtext_bf:
+
+mathtext.bf: ``'sans:bold'``
+ *no description*
+
+.. _rcparam_mathtext_bfit:
+
+mathtext.bfit: ``'sans:italic:bold'``
+ *no description*
+
+.. _rcparam_mathtext_cal:
+
+mathtext.cal: ``'cursive'``
+ *no description*
+
+.. _rcparam_mathtext_it:
+
+mathtext.it: ``'sans:italic'``
+ *no description*
+
+.. _rcparam_mathtext_rm:
+
+mathtext.rm: ``'sans'``
+ *no description*
+
+.. _rcparam_mathtext_sf:
+
+mathtext.sf: ``'sans'``
+ *no description*
+
+.. _rcparam_mathtext_tt:
+
+mathtext.tt: ``'monospace'``
+ *no description*
+
+.. _rcparam_mathtext_fallback:
+
+mathtext.fallback: ``'cm'``
+ Select fallback font from ['cm' (Computer Modern), 'stix', 'stixsans'] when a symbol cannot be found in one of the custom math fonts. Select 'None' to not perform fallback and replace the missing character by a dummy symbol.
+
+.. _rcparam_mathtext_default:
+
+mathtext.default: ``'it'``
+ The default font to use for math. Can be any of the LaTeX font names, including the special name "regular" for the same font used in regular text.
+
+.. _rcparam_axes_facecolor:
+
+axes.facecolor: ``'white'``
+ axes background color
+
+.. _rcparam_axes_edgecolor:
+
+axes.edgecolor: ``'black'``
+ axes edge color
+
+.. _rcparam_axes_linewidth:
+
+axes.linewidth: ``0.8``
+ edge line width
+
+.. _rcparam_axes_grid:
+
+axes.grid: ``False``
+ display grid or not
+
+.. _rcparam_axes_grid_axis:
+
+axes.grid.axis: ``'both'``
+ which axis the grid should apply to
+
+.. _rcparam_axes_grid_which:
+
+axes.grid.which: ``'major'``
+ grid lines at {major, minor, both} ticks
+
+.. _rcparam_axes_titlelocation:
+
+axes.titlelocation: ``'center'``
+ alignment of the title: {left, right, center}
+
+.. _rcparam_axes_titlesize:
+
+axes.titlesize: ``'large'``
+ font size of the axes title
+
+.. _rcparam_axes_titleweight:
+
+axes.titleweight: ``'normal'``
+ font weight of title
+
+.. _rcparam_axes_titlecolor:
+
+axes.titlecolor: ``'auto'``
+ color of the axes title, auto falls back to text.color as default value
+
+.. _rcparam_axes_titley:
+
+axes.titley: ``None``
+ position title (axes relative units). None implies auto
+
+.. _rcparam_axes_titlepad:
+
+axes.titlepad: ``6.0``
+ pad between axes and title in points
+
+.. _rcparam_axes_labelsize:
+
+axes.labelsize: ``'medium'``
+ font size of the x and y labels
+
+.. _rcparam_axes_labelpad:
+
+axes.labelpad: ``4.0``
+ space between label and axis
+
+.. _rcparam_axes_labelweight:
+
+axes.labelweight: ``'normal'``
+ weight of the x and y labels
+
+.. _rcparam_axes_labelcolor:
+
+axes.labelcolor: ``'black'``
+ *no description*
+
+.. _rcparam_axes_axisbelow:
+
+axes.axisbelow: ``'line'``
+ draw axis gridlines and ticks: - below patches (True) - above patches but below lines ('line') - above all (False)
+
+.. _rcparam_axes_formatter_limits:
+
+axes.formatter.limits: ``[-5, 6]``
+ use scientific notation if log10 of the axis range is smaller than the first or larger than the second
+
+.. _rcparam_axes_formatter_use_locale:
+
+axes.formatter.use_locale: ``False``
+ When True, format tick labels according to the user's locale. For example, use ',' as a decimal separator in the fr_FR locale.
+
+.. _rcparam_axes_formatter_use_mathtext:
+
+axes.formatter.use_mathtext: ``False``
+ When True, use mathtext for scientific notation.
+
+.. _rcparam_axes_formatter_min_exponent:
+
+axes.formatter.min_exponent: ``0``
+ minimum exponent to format in scientific notation
+
+.. _rcparam_axes_formatter_useoffset:
+
+axes.formatter.useoffset: ``True``
+ If True, the tick label formatter will default to labeling ticks relative to an offset when the data range is small compared to the minimum absolute value of the data.
+
+.. _rcparam_axes_formatter_offset_threshold:
+
+axes.formatter.offset_threshold: ``4``
+ When useoffset is True, the offset will be used when it can remove at least this number of significant digits from tick labels.
+
+.. _rcparam_axes_spines_left:
+
+axes.spines.left: ``True``
+ display axis spines
+
+.. _rcparam_axes_spines_bottom:
+
+axes.spines.bottom: ``True``
+ *no description*
+
+.. _rcparam_axes_spines_top:
+
+axes.spines.top: ``True``
+ *no description*
+
+.. _rcparam_axes_spines_right:
+
+axes.spines.right: ``True``
+ *no description*
+
+.. _rcparam_axes_unicode_minus:
+
+axes.unicode_minus: ``True``
+ use Unicode for the minus symbol rather than hyphen. See https://en.wikipedia.org/wiki/Plus_and_minus_signs#Character_codes
+
+.. _rcparam_axes_prop_cycle:
+
+axes.prop_cycle: ``cycler('color', [(0.12156862745098039, 0.4666666666666667, 0.7058823529411765), (1.0, 0.4980392156862745, 0.054901960784313725), (0.17254901960784313, 0.6274509803921569, 0.17254901960784313), (0.8392156862745098, 0.15294117647058825, 0.1568627450980392), (0.5803921568627451, 0.403921568627451, 0.7411764705882353), (0.5490196078431373, 0.33725490196078434, 0.29411764705882354), (0.8901960784313725, 0.4666666666666667, 0.7607843137254902), (0.4980392156862745, 0.4980392156862745, 0.4980392156862745), (0.7372549019607844, 0.7411764705882353, 0.13333333333333333), (0.09019607843137255, 0.7450980392156863, 0.8117647058823529)])``
+ *no description*
+
+.. _rcparam_axes_xmargin:
+
+axes.xmargin: ``0.05``
+ x margin. See `~.axes.Axes.margins`
+
+.. _rcparam_axes_ymargin:
+
+axes.ymargin: ``0.05``
+ y margin. See `~.axes.Axes.margins`
+
+.. _rcparam_axes_zmargin:
+
+axes.zmargin: ``0.05``
+ z margin. See `~.axes.Axes.margins`
+
+.. _rcparam_axes_autolimit_mode:
+
+axes.autolimit_mode: ``'data'``
+ If "data", use axes.xmargin and axes.ymargin as is. If "round_numbers", after application of margins, axis limits are further expanded to the nearest "round" number.
+
+.. _rcparam_polaraxes_grid:
+
+polaraxes.grid: ``True``
+ display grid on polar axes
+
+.. _rcparam_axes3d_grid:
+
+axes3d.grid: ``True``
+ display grid on 3D axes
+
+.. _rcparam_axes3d_automargin:
+
+axes3d.automargin: ``False``
+ automatically add margin when manually setting 3D axis limits
+
+.. _rcparam_axes3d_xaxis_panecolor:
+
+axes3d.xaxis.panecolor: ``(0.95, 0.95, 0.95, 0.5)``
+ background pane on 3D axes
+
+.. _rcparam_axes3d_yaxis_panecolor:
+
+axes3d.yaxis.panecolor: ``(0.9, 0.9, 0.9, 0.5)``
+ background pane on 3D axes
+
+.. _rcparam_axes3d_zaxis_panecolor:
+
+axes3d.zaxis.panecolor: ``(0.925, 0.925, 0.925, 0.5)``
+ background pane on 3D axes
+
+.. _rcparam_axes3d_depthshade:
+
+axes3d.depthshade: ``True``
+ depth shade for 3D scatter plots
+
+.. _rcparam_axes3d_depthshade_minalpha:
+
+axes3d.depthshade_minalpha: ``0.3``
+ minimum alpha value for depth shading
+
+.. _rcparam_axes3d_mouserotationstyle:
+
+axes3d.mouserotationstyle: ``'arcball'``
+ {azel, trackball, sphere, arcball} See also https://matplotlib.org/stable/api/toolkits/mplot3d/view_angles.html#rotation-with-mouse
+
+.. _rcparam_axes3d_trackballsize:
+
+axes3d.trackballsize: ``0.667``
+ trackball diameter, in units of the Axes bbox
+
+.. _rcparam_axes3d_trackballborder:
+
+axes3d.trackballborder: ``0.2``
+ trackball border width, in units of the Axes bbox (only for 'sphere' and 'arcball' style)
+
+.. _rcparam_xaxis_labellocation:
+
+xaxis.labellocation: ``'center'``
+ alignment of the xaxis label: {left, right, center}
+
+.. _rcparam_yaxis_labellocation:
+
+yaxis.labellocation: ``'center'``
+ alignment of the yaxis label: {bottom, top, center}
+
+.. _rcparam_date_autoformatter_year:
+
+date.autoformatter.year: ``'%Y'``
+ *no description*
+
+.. _rcparam_date_autoformatter_month:
+
+date.autoformatter.month: ``'%Y-%m'``
+ *no description*
+
+.. _rcparam_date_autoformatter_day:
+
+date.autoformatter.day: ``'%Y-%m-%d'``
+ *no description*
+
+.. _rcparam_date_autoformatter_hour:
+
+date.autoformatter.hour: ``'%m-%d %H'``
+ *no description*
+
+.. _rcparam_date_autoformatter_minute:
+
+date.autoformatter.minute: ``'%d %H:%M'``
+ *no description*
+
+.. _rcparam_date_autoformatter_second:
+
+date.autoformatter.second: ``'%H:%M:%S'``
+ *no description*
+
+.. _rcparam_date_autoformatter_microsecond:
+
+date.autoformatter.microsecond: ``'%M:%S.%f'``
+ *no description*
+
+.. _rcparam_date_epoch:
+
+date.epoch: ``'1970-01-01T00:00:00'``
+ The reference date for Matplotlib's internal date representation. See https://matplotlib.org/stable/gallery/ticks/date_precision_and_epochs.html
+
+.. _rcparam_date_converter:
+
+date.converter: ``'auto'``
+ 'auto', 'concise'
+
+.. _rcparam_date_interval_multiples:
+
+date.interval_multiples: ``True``
+ For auto converter whether to use interval_multiples
+
+.. _rcparam_xtick_top:
+
+xtick.top: ``False``
+ draw ticks on the top side
+
+.. _rcparam_xtick_bottom:
+
+xtick.bottom: ``True``
+ draw ticks on the bottom side
+
+.. _rcparam_xtick_labeltop:
+
+xtick.labeltop: ``False``
+ draw label on the top
+
+.. _rcparam_xtick_labelbottom:
+
+xtick.labelbottom: ``True``
+ draw label on the bottom
+
+.. _rcparam_xtick_major_size:
+
+xtick.major.size: ``3.5``
+ major tick size in points
+
+.. _rcparam_xtick_minor_size:
+
+xtick.minor.size: ``2.0``
+ minor tick size in points
+
+.. _rcparam_xtick_major_width:
+
+xtick.major.width: ``0.8``
+ major tick width in points
+
+.. _rcparam_xtick_minor_width:
+
+xtick.minor.width: ``0.6``
+ minor tick width in points
+
+.. _rcparam_xtick_major_pad:
+
+xtick.major.pad: ``3.5``
+ distance to major tick label in points
+
+.. _rcparam_xtick_minor_pad:
+
+xtick.minor.pad: ``3.4``
+ distance to the minor tick label in points
+
+.. _rcparam_xtick_color:
+
+xtick.color: ``'black'``
+ color of the ticks
+
+.. _rcparam_xtick_labelcolor:
+
+xtick.labelcolor: ``'inherit'``
+ color of the tick labels or inherit from xtick.color
+
+.. _rcparam_xtick_labelsize:
+
+xtick.labelsize: ``'medium'``
+ font size of the tick labels
+
+.. _rcparam_xtick_direction:
+
+xtick.direction: ``'out'``
+ direction: {in, out, inout}
+
+.. _rcparam_xtick_minor_visible:
+
+xtick.minor.visible: ``False``
+ visibility of minor ticks on x-axis
+
+.. _rcparam_xtick_major_top:
+
+xtick.major.top: ``True``
+ draw x axis top major ticks
+
+.. _rcparam_xtick_major_bottom:
+
+xtick.major.bottom: ``True``
+ draw x axis bottom major ticks
+
+.. _rcparam_xtick_minor_top:
+
+xtick.minor.top: ``True``
+ draw x axis top minor ticks
+
+.. _rcparam_xtick_minor_bottom:
+
+xtick.minor.bottom: ``True``
+ draw x axis bottom minor ticks
+
+.. _rcparam_xtick_minor_ndivs:
+
+xtick.minor.ndivs: ``'auto'``
+ number of minor ticks between the major ticks on x-axis
+
+.. _rcparam_xtick_alignment:
+
+xtick.alignment: ``'center'``
+ alignment of xticks
+
+.. _rcparam_ytick_left:
+
+ytick.left: ``True``
+ draw ticks on the left side
+
+.. _rcparam_ytick_right:
+
+ytick.right: ``False``
+ draw ticks on the right side
+
+.. _rcparam_ytick_labelleft:
+
+ytick.labelleft: ``True``
+ draw tick labels on the left side
+
+.. _rcparam_ytick_labelright:
+
+ytick.labelright: ``False``
+ draw tick labels on the right side
+
+.. _rcparam_ytick_major_size:
+
+ytick.major.size: ``3.5``
+ major tick size in points
+
+.. _rcparam_ytick_minor_size:
+
+ytick.minor.size: ``2.0``
+ minor tick size in points
+
+.. _rcparam_ytick_major_width:
+
+ytick.major.width: ``0.8``
+ major tick width in points
+
+.. _rcparam_ytick_minor_width:
+
+ytick.minor.width: ``0.6``
+ minor tick width in points
+
+.. _rcparam_ytick_major_pad:
+
+ytick.major.pad: ``3.5``
+ distance to major tick label in points
+
+.. _rcparam_ytick_minor_pad:
+
+ytick.minor.pad: ``3.4``
+ distance to the minor tick label in points
+
+.. _rcparam_ytick_color:
+
+ytick.color: ``'black'``
+ color of the ticks
+
+.. _rcparam_ytick_labelcolor:
+
+ytick.labelcolor: ``'inherit'``
+ color of the tick labels or inherit from ytick.color
+
+.. _rcparam_ytick_labelsize:
+
+ytick.labelsize: ``'medium'``
+ font size of the tick labels
+
+.. _rcparam_ytick_direction:
+
+ytick.direction: ``'out'``
+ direction: {in, out, inout}
+
+.. _rcparam_ytick_minor_visible:
+
+ytick.minor.visible: ``False``
+ visibility of minor ticks on y-axis
+
+.. _rcparam_ytick_major_left:
+
+ytick.major.left: ``True``
+ draw y axis left major ticks
+
+.. _rcparam_ytick_major_right:
+
+ytick.major.right: ``True``
+ draw y axis right major ticks
+
+.. _rcparam_ytick_minor_left:
+
+ytick.minor.left: ``True``
+ draw y axis left minor ticks
+
+.. _rcparam_ytick_minor_right:
+
+ytick.minor.right: ``True``
+ draw y axis right minor ticks
+
+.. _rcparam_ytick_minor_ndivs:
+
+ytick.minor.ndivs: ``'auto'``
+ number of minor ticks between the major ticks on y-axis
+
+.. _rcparam_ytick_alignment:
+
+ytick.alignment: ``'center_baseline'``
+ alignment of yticks
+
+.. _rcparam_grid_color:
+
+grid.color: ``'#b0b0b0'``
+ b0b0b0" # grid color
+
+.. _rcparam_grid_linestyle:
+
+grid.linestyle: ``'-'``
+ solid
+
+.. _rcparam_grid_linewidth:
+
+grid.linewidth: ``0.8``
+ in points
+
+.. _rcparam_grid_alpha:
+
+grid.alpha: ``1.0``
+ transparency, between 0.0 and 1.0
+
+.. _rcparam_grid_major_color:
+
+grid.major.color: ``None``
+ If None defaults to grid.color
+
+.. _rcparam_grid_major_linestyle:
+
+grid.major.linestyle: ``None``
+ If None defaults to grid.linestyle
+
+.. _rcparam_grid_major_linewidth:
+
+grid.major.linewidth: ``None``
+ If None defaults to grid.linewidth
+
+.. _rcparam_grid_major_alpha:
+
+grid.major.alpha: ``None``
+ If None defaults to grid.alpha
+
+.. _rcparam_grid_minor_color:
+
+grid.minor.color: ``None``
+ If None defaults to grid.color
+
+.. _rcparam_grid_minor_linestyle:
+
+grid.minor.linestyle: ``None``
+ If None defaults to grid.linestyle
+
+.. _rcparam_grid_minor_linewidth:
+
+grid.minor.linewidth: ``None``
+ If None defaults to grid.linewidth
+
+.. _rcparam_grid_minor_alpha:
+
+grid.minor.alpha: ``None``
+ If None defaults to grid.alpha
+
+.. _rcparam_legend_loc:
+
+legend.loc: ``'best'``
+ *no description*
+
+.. _rcparam_legend_frameon:
+
+legend.frameon: ``True``
+ if True, draw the legend on a background patch
+
+.. _rcparam_legend_framealpha:
+
+legend.framealpha: ``0.8``
+ legend patch transparency
+
+.. _rcparam_legend_facecolor:
+
+legend.facecolor: ``'inherit'``
+ inherit from axes.facecolor; or color spec
+
+.. _rcparam_legend_edgecolor:
+
+legend.edgecolor: ``'0.8'``
+ background patch boundary color
+
+.. _rcparam_legend_linewidth:
+
+legend.linewidth: ``None``
+ line width of the legend frame, None means inherit from patch.linewidth
+
+.. _rcparam_legend_fancybox:
+
+legend.fancybox: ``True``
+ if True, use a rounded box for the legend background, else a rectangle
+
+.. _rcparam_legend_shadow:
+
+legend.shadow: ``False``
+ if True, give background a shadow effect
+
+.. _rcparam_legend_numpoints:
+
+legend.numpoints: ``1``
+ the number of marker points in the legend line
+
+.. _rcparam_legend_scatterpoints:
+
+legend.scatterpoints: ``1``
+ number of scatter points
+
+.. _rcparam_legend_markerscale:
+
+legend.markerscale: ``1.0``
+ the relative size of legend markers vs. original
+
+.. _rcparam_legend_fontsize:
+
+legend.fontsize: ``'medium'``
+ *no description*
+
+.. _rcparam_legend_labelcolor:
+
+legend.labelcolor: ``'None'``
+ *no description*
+
+.. _rcparam_legend_title_fontsize:
+
+legend.title_fontsize: ``None``
+ None sets to the same as the default axes.
+
+.. _rcparam_legend_borderpad:
+
+legend.borderpad: ``0.4``
+ border whitespace
+
+.. _rcparam_legend_labelspacing:
+
+legend.labelspacing: ``0.5``
+ the vertical space between the legend entries
+
+.. _rcparam_legend_handlelength:
+
+legend.handlelength: ``2.0``
+ the length of the legend lines
+
+.. _rcparam_legend_handleheight:
+
+legend.handleheight: ``0.7``
+ the height of the legend handle
+
+.. _rcparam_legend_handletextpad:
+
+legend.handletextpad: ``0.8``
+ the space between the legend line and legend text
+
+.. _rcparam_legend_borderaxespad:
+
+legend.borderaxespad: ``0.5``
+ the border between the axes and legend edge
+
+.. _rcparam_legend_columnspacing:
+
+legend.columnspacing: ``2.0``
+ column separation
+
+.. _rcparam_figure_titlesize:
+
+figure.titlesize: ``'large'``
+ size of the figure title (``Figure.suptitle()``)
+
+.. _rcparam_figure_titleweight:
+
+figure.titleweight: ``'normal'``
+ weight of the figure title
+
+.. _rcparam_figure_labelsize:
+
+figure.labelsize: ``'large'``
+ size of the figure label (``Figure.sup[x|y]label()``)
+
+.. _rcparam_figure_labelweight:
+
+figure.labelweight: ``'normal'``
+ weight of the figure label
+
+.. _rcparam_figure_figsize:
+
+figure.figsize: ``[6.4, 4.8]``
+ figure size in inches
+
+.. _rcparam_figure_dpi:
+
+figure.dpi: ``100.0``
+ figure dots per inch
+
+.. _rcparam_figure_facecolor:
+
+figure.facecolor: ``'white'``
+ figure face color
+
+.. _rcparam_figure_edgecolor:
+
+figure.edgecolor: ``'white'``
+ figure edge color
+
+.. _rcparam_figure_frameon:
+
+figure.frameon: ``True``
+ enable figure frame
+
+.. _rcparam_figure_max_open_warning:
+
+figure.max_open_warning: ``20``
+ The maximum number of figures to open through the pyplot interface before emitting a warning. If less than one this feature is disabled.
+
+.. _rcparam_figure_raise_window:
+
+figure.raise_window: ``True``
+ Raise the GUI window to front when show() is called. If set to False, we currently do not take any further actions and whether the window appears on the front may depend on the GUI framework and window manager.
+
+.. _rcparam_figure_subplot_left:
+
+figure.subplot.left: ``0.125``
+ the left side of the subplots of the figure
+
+.. _rcparam_figure_subplot_right:
+
+figure.subplot.right: ``0.9``
+ the right side of the subplots of the figure
+
+.. _rcparam_figure_subplot_bottom:
+
+figure.subplot.bottom: ``0.11``
+ the bottom of the subplots of the figure
+
+.. _rcparam_figure_subplot_top:
+
+figure.subplot.top: ``0.88``
+ the top of the subplots of the figure
+
+.. _rcparam_figure_subplot_wspace:
+
+figure.subplot.wspace: ``0.2``
+ the amount of width reserved for space between subplots, expressed as a fraction of the average axis width
+
+.. _rcparam_figure_subplot_hspace:
+
+figure.subplot.hspace: ``0.2``
+ the amount of height reserved for space between subplots, expressed as a fraction of the average axis height
+
+.. _rcparam_figure_autolayout:
+
+figure.autolayout: ``False``
+ When True, automatically adjust subplot parameters to make the plot fit the figure using `~.Figure.tight_layout`
+
+.. _rcparam_figure_constrained_layout_use:
+
+figure.constrained_layout.use: ``False``
+ When True, automatically make plot elements fit on the figure. (Not compatible with "figure.autolayout", above).
+
+.. _rcparam_figure_constrained_layout_h_pad:
+
+figure.constrained_layout.h_pad: ``0.04167``
+ Padding (in inches) around axes; defaults to 3/72 inches, i.e. 3 points
+
+.. _rcparam_figure_constrained_layout_w_pad:
+
+figure.constrained_layout.w_pad: ``0.04167``
+ Padding (in inches) around axes; defaults to 3/72 inches, i.e. 3 points
+
+.. _rcparam_figure_constrained_layout_hspace:
+
+figure.constrained_layout.hspace: ``0.02``
+ Spacing between subplots, relative to the subplot sizes. Much smaller than for tight_layout (figure.subplot.hspace, figure.subplot.wspace) as constrained_layout already takes surrounding texts (titles, labels, # ticklabels) into account.
+
+.. _rcparam_figure_constrained_layout_wspace:
+
+figure.constrained_layout.wspace: ``0.02``
+ Spacing between subplots, relative to the subplot sizes. Much smaller than for tight_layout (figure.subplot.hspace, figure.subplot.wspace) as constrained_layout already takes surrounding texts (titles, labels, # ticklabels) into account.
+
+.. _rcparam_image_aspect:
+
+image.aspect: ``'equal'``
+ {equal, auto} or a number
+
+.. _rcparam_image_interpolation:
+
+image.interpolation: ``'auto'``
+ see help(imshow) for options
+
+.. _rcparam_image_interpolation_stage:
+
+image.interpolation_stage: ``'auto'``
+ see help(imshow) for options
+
+.. _rcparam_image_cmap:
+
+image.cmap: ``'viridis'``
+ A colormap name (plasma, magma, etc.)
+
+.. _rcparam_image_lut:
+
+image.lut: ``256``
+ the size of the colormap lookup table
+
+.. _rcparam_image_origin:
+
+image.origin: ``'upper'``
+ {lower, upper}
+
+.. _rcparam_image_resample:
+
+image.resample: ``True``
+ *no description*
+
+.. _rcparam_image_composite_image:
+
+image.composite_image: ``True``
+ When True, all the images on a set of axes are combined into a single composite image before saving a figure as a vector graphics file, such as a PDF.
+
+.. _rcparam_contour_negative_linestyle:
+
+contour.negative_linestyle: ``'dashed'``
+ string or on-off ink sequence
+
+.. _rcparam_contour_corner_mask:
+
+contour.corner_mask: ``True``
+ {True, False}
+
+.. _rcparam_contour_linewidth:
+
+contour.linewidth: ``None``
+ {float, None} Size of the contour line widths. If set to None, it falls back to "line.linewidth".
+
+.. _rcparam_contour_algorithm:
+
+contour.algorithm: ``'mpl2014'``
+ {mpl2005, mpl2014, serial, threaded}
+
+.. _rcparam_errorbar_capsize:
+
+errorbar.capsize: ``0.0``
+ length of end cap on error bars in pixels
+
+.. _rcparam_hist_bins:
+
+hist.bins: ``10``
+ The default number of histogram bins or 'auto'.
+
+.. _rcparam_scatter_marker:
+
+scatter.marker: ``'o'``
+ The default marker type for scatter plots.
+
+.. _rcparam_scatter_edgecolors:
+
+scatter.edgecolors: ``'face'``
+ The default edge colors for scatter plots.
+
+.. _rcparam_agg_path_chunksize:
+
+agg.path.chunksize: ``0``
+ 0 to disable; values in the range 10000 to 100000 can improve speed slightly and prevent an Agg rendering failure when plotting very large data sets, especially if they are very gappy. It may cause minor artifacts, though. A value of 20000 is probably a good starting point.
+
+.. _rcparam_path_simplify:
+
+path.simplify: ``True``
+ When True, simplify paths by removing "invisible" points to reduce file size and increase rendering speed
+
+.. _rcparam_path_simplify_threshold:
+
+path.simplify_threshold: ``0.111111111111``
+ The threshold of similarity below which vertices will be removed in the simplification process.
+
+.. _rcparam_path_snap:
+
+path.snap: ``True``
+ When True, rectilinear axis-aligned paths will be snapped to the nearest pixel when certain criteria are met. When False, paths will never be snapped.
+
+.. _rcparam_path_sketch:
+
+path.sketch: ``None``
+ May be None, or a tuple of the form:path.sketch: (scale, length, randomness)- *scale* is the amplitude of the wiggle perpendicular to the line (in pixels).- *length* is the length of the wiggle along the line (in pixels).- *randomness* is the factor by which the length is randomly scaled.
+
+.. _rcparam_path_effects:
+
+path.effects: ``[]``
+ *no description*
+
+.. _rcparam_savefig_dpi:
+
+savefig.dpi: ``'figure'``
+ figure dots per inch or 'figure'
+
+.. _rcparam_savefig_facecolor:
+
+savefig.facecolor: ``'auto'``
+ figure face color when saving
+
+.. _rcparam_savefig_edgecolor:
+
+savefig.edgecolor: ``'auto'``
+ figure edge color when saving
+
+.. _rcparam_savefig_format:
+
+savefig.format: ``'png'``
+ {png, ps, pdf, svg}
+
+.. _rcparam_savefig_bbox:
+
+savefig.bbox: ``None``
+ {tight, standard} 'tight' is incompatible with generating frames for animation
+
+.. _rcparam_savefig_pad_inches:
+
+savefig.pad_inches: ``0.1``
+ padding to be used, when bbox is set to 'tight'
+
+.. _rcparam_savefig_directory:
+
+savefig.directory: ``'~'``
+ default directory in savefig dialog, gets updated after interactive saves, unless set to the empty string (i.e. the current directory); use '.' to start at the current directory but update after interactive saves
+
+.. _rcparam_savefig_transparent:
+
+savefig.transparent: ``False``
+ whether figures are saved with a transparent background by default
+
+.. _rcparam_savefig_orientation:
+
+savefig.orientation: ``'portrait'``
+ orientation of saved figure, for PostScript output only
+
+.. _rcparam_macosx_window_mode:
+
+macosx.window_mode: ``'system'``
+ How to open new figures (system, tab, window) system uses the MacOS system preferences
+
+.. _rcparam_tk_window_focus:
+
+tk.window_focus: ``False``
+ Maintain shell focus for TkAgg
+
+.. _rcparam_ps_papersize:
+
+ps.papersize: ``'letter'``
+ {figure, letter, legal, ledger, A0-A10, B0-B10}
+
+.. _rcparam_ps_useafm:
+
+ps.useafm: ``False``
+ use AFM fonts, results in small files
+
+.. _rcparam_ps_usedistiller:
+
+ps.usedistiller: ``None``
+ {ghostscript, xpdf, None} Experimental: may produce smaller files. xpdf intended for production of publication quality files, but requires ghostscript, xpdf and ps2eps
+
+.. _rcparam_ps_distiller_res:
+
+ps.distiller.res: ``6000``
+ dpi
+
+.. _rcparam_ps_fonttype:
+
+ps.fonttype: ``3``
+ Output Type 3 (Type3) or Type 42 (TrueType)
+
+.. _rcparam_pdf_compression:
+
+pdf.compression: ``6``
+ integer from 0 to 9 0 disables compression (good for debugging)
+
+.. _rcparam_pdf_fonttype:
+
+pdf.fonttype: ``3``
+ Output Type 3 (Type3) or Type 42 (TrueType)
+
+.. _rcparam_pdf_use14corefonts:
+
+pdf.use14corefonts: ``False``
+ *no description*
+
+.. _rcparam_pdf_inheritcolor:
+
+pdf.inheritcolor: ``False``
+ *no description*
+
+.. _rcparam_svg_image_inline:
+
+svg.image_inline: ``True``
+ Write raster image data directly into the SVG file
+
+.. _rcparam_svg_fonttype:
+
+svg.fonttype: ``'path'``
+ How to handle SVG fonts: path: Embed characters as paths -- supported by most SVG renderersnone: Assume fonts are installed on the machine where the SVG will be viewed.
+
+.. _rcparam_svg_hashsalt:
+
+svg.hashsalt: ``None``
+ If not None, use this string as hash salt instead of uuid4
+
+.. _rcparam_svg_id:
+
+svg.id: ``None``
+ If not None, use this string as the value for the `id` attribute in the top