Merge pull request #24323 from meeseeksmachine/auto-backport-of-pr-24320-on-v3.6.x

timhoffm · web-flow · commit ea968792dd83 · 2022-11-01T12:58:42.000+01:00
Backport PR #24320 on branch v3.6.x (DOC: add warning note to imsave)
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
@@ -1547,7 +1547,15 @@ def imread(fname, format=None):
 def imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None,
            origin=None, dpi=100, *, metadata=None, pil_kwargs=None):
     """
-    Save an array as an image file.
+    Colormap and save an array as an image file.
+
+    RGB(A) images are passed through.  Single channel images will be
+    colormapped according to *cmap* and *norm*.
+
+    .. note ::
+
+       If you want to save a single channel image as gray scale please use an
+       image I/O library (such as pillow, tifffile, or imageio) directly.
 
     Parameters
     ----------
