Merge pull request #31470 from QuLogic/no-thumbnail

jklymak · web-flow · commit 65e6ba788264 · 2026-04-08T11:08:30.000-07:00
MNT: Deprecate matplotlib.image.thumbnail
diff --git a/doc/api/next_api_changes/deprecations/31468-ES.rst b/doc/api/next_api_changes/deprecations/31468-ES.rst
@@ -0,0 +1,6 @@
+``image.thumbnail``
+~~~~~~~~~~~~~~~~~~~
+
+... is deprecated without replacement. Use :external:py:`Pillow's thumbnail
+method <PIL.Image.Image.thumbnail>` instead. See also the `Pillow tutorial
+<https://pillow.readthedocs.io/en/stable/handbook/tutorial.html#create-jpeg-thumbnails>`_.
diff --git a/galleries/examples/misc/image_thumbnail_sgskip.py b/galleries/examples/misc/image_thumbnail_sgskip.py
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
@@ -1787,12 +1787,14 @@ def _pil_png_to_float_array(pil_png):
     raise ValueError(f"Unknown PIL rawmode: {rawmode}")
 
 
+@_api.deprecated('3.11', alternative="Pillow's `PIL.Image.Image.thumbnail`")
 def thumbnail(infile, thumbfile, scale=0.1, interpolation='bilinear',
               preview=False):
     """
     Make a thumbnail of image in *infile* with output filename *thumbfile*.
 
-    See :doc:`/gallery/misc/image_thumbnail_sgskip`.
+    See `Pillow for a replacement
+    <https://pillow.readthedocs.io/en/stable/handbook/tutorial.html#create-jpeg-thumbnails>`_.
 
     Parameters
     ----------
