matplotlib
diff --git a/‎galleries/examples/images_contours_and_fields/image_nonuniform.py
Copy file name to clipboardExpand all lines: galleries/examples/images_contours_and_fields/image_nonuniform.py
+6-3Lines changed: 6 additions & 3 deletions b/‎galleries/examples/images_contours_and_fields/image_nonuniform.py
Copy file name to clipboardExpand all lines: galleries/examples/images_contours_and_fields/image_nonuniform.py
+6-3Lines changed: 6 additions & 3 deletions
diff --git a/‎lib/matplotlib/image.py
Copy file name to clipboardExpand all lines: lib/matplotlib/image.py
+9-1Lines changed: 9 additions & 1 deletion b/‎lib/matplotlib/image.py
Copy file name to clipboardExpand all lines: lib/matplotlib/image.py
+9-1Lines changed: 9 additions & 1 deletion
@@ -3,9 +3,12 @@
 Image nonuniform
 ================
 
-This illustrates the NonUniformImage class.  It is not
-available via an Axes method, but it is easily added to an
-Axes instance as shown here.
+`.NonUniformImage` is a generalized image with pixels on a rectilinear grid,
+i.e. it allows rows and columns with individual heights / widths.
+
+There is no high-level plotting method on `~.axes.Axes` or `.pyplot` to
+create a NonUniformImage. Instead, you have to instantiate the image
+explicitly add it to the Axes using `.Axes.add_image`.
 """
 
 import matplotlib.pyplot as plt
 
@@ -818,7 +818,7 @@ def get_filterrad(self):
 
 class AxesImage(_ImageBase):
     """
-    An image attached to an Axes.
+    An image with pixels on a regular grid, attached to an Axes.
 
     Parameters
     ----------
@@ -1005,6 +1005,14 @@ def get_cursor_data(self, event):
 
 
 class NonUniformImage(AxesImage):
+    """
+    An image with pixels on a rectilinear grid.
+
+    In contrast to `.AxesImage`, where pixels are on a regular grid,
+    NonUniformImage allows rows and columns with individual heights / widths.
+
+    See also :doc:`/gallery/images_contours_and_fields/image_nonuniform`.
+    """
 
     def __init__(self, ax, *, interpolation='nearest', **kwargs):
         """