matplotlib
diff --git a/‎lib/matplotlib/axes/_axes.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.py
+6-4Lines changed: 6 additions & 4 deletions b/‎lib/matplotlib/axes/_axes.py
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.py
+6-4Lines changed: 6 additions & 4 deletions
@@ -5833,11 +5833,13 @@ def imshow(self, X, cmap=None, norm=None, *, aspect=None,
             resize filter is controlled by the parameter *filternorm*.
 
         interpolation_stage : {'antialiased', 'data', 'rgba'}, default: 'antialiased'
-            If 'data', interpolation is carried out on the data provided by the user.
+            If 'data', interpolation is carried out on the data provided by the user,
+            useful if interpolating between pixels during upsampling.
             If 'rgba', the interpolation is carried out in RGBA-space after the
-            color-mapping has been applied (visual interpolation).  If 'antialiased',
-            then 'rgba' is used if downsampling, or upsampling at a rate less than 3.
-            If upsampling at a higher rate, then 'data' is used.
+            color-mapping has been applied, useful if downsampling and combining
+            pixels visually. The default 'antialiased' is appropriate for most
+            applications where 'rgba' is used when downsampling, or upsampling at a
+            rate less than 3, and 'data' is used when upsampling at a higher rate.
             See :doc:`/gallery/images_contours_and_fields/image_antialiasing` for
             a discussion of image antialiasing.