ENH: allow pcolor to plot all data

jklymak · jklymak · commit 440d6161bd35 · 2019-12-18T08:44:34.000-08:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -5702,7 +5702,9 @@ def pcolor(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
 
             ``pcolor()`` can be very slow for large arrays. In most
             cases you should use the similar but much faster
-            `~.Axes.pcolormesh` instead. See there for a discussion of the
+            `~.Axes.pcolormesh` instead. See
+            :ref:`Differences between pcolor() and pcolormesh()
+            <differences-pcolor-pcolormesh>` for a discussion of the
             differences.
 
         Parameters
@@ -5769,10 +5771,11 @@ def pcolor(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
             Whether to snap the mesh to pixel boundaries.
 
        dropdata: bool, default: True
-            If True (default), and X and Y are the same size as C in their
+            If True (default), and *X* and *Y* are the same size as C in their
             respective dimensions, drop the last element of C in both
-            dimensions.  If False, interpolate X and Y to their midpoints
-            and extrapolate their endpoints.
+            dimensions.  If False, *X* and *Y* are assumed to the the midpoints
+            of the quadrilaterals, and their edgese are calculated by linear
+            interpolation.
 
         Returns
         -------
@@ -5824,7 +5827,10 @@ def pcolor(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
         ``pcolor()`` displays all columns of *C* if *X* and *Y* are not
         specified, or if *X* and *Y* have one more column than *C*.
         If *X* and *Y* have the same number of columns as *C* then the last
-        column of *C* is dropped. Similarly for the rows.
+        column of *C* is dropped if *dropdata* is True. Similarly for the rows.
+        If *dropdata* is false, then *X* and *Y* are assumed to be at the
+        middle of the quadrilaterals, and the edges of the quadrilaterals are
+        linearly interpolated.
 
         Note: This behavior is different from MATLAB's ``pcolor()``, which
         always discards the last row and column of *C*.
@@ -5938,9 +5944,9 @@ def pcolormesh(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
 
         *X* and *Y* can be used to specify the corners of the quadrilaterals.
 
-        .. note::
+        .. hint::
 
-           `~Axes.pcolormesh` is similar to `~Axes.pcolor`. It's much faster
+           `~Axes.pcolormesh` is similar to `~Axes.pcolor`. It is much faster
            and preferred in most cases. For a detailed discussion on the
            differences see :ref:`Differences between pcolor() and pcolormesh()
            <differences-pcolor-pcolormesh>`.
@@ -6018,10 +6024,11 @@ def pcolormesh(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
             Whether to snap the mesh to pixel boundaries.
 
        dropdata: bool, default: True
-            If True (default), and X and Y are the same size as C in their
+            If True (default), and *X* and *Y* are the same size as C in their
             respective dimensions, drop the last element of C in both
-            dimensions.  If False, interpolate X and Y to their midpoints
-            and extrapolate their endpoints.
+            dimensions.  If False, *X* and *Y* are assumed to the the midpoints
+            of the quadrilaterals, and their edgese are calculated by linear
+            interpolation.
 
         Returns
         -------
