Backport PR #20975: Clarify support for 2D coordinate inputs to streamplot.

timhoffm · meeseeksmachine · commit 880ebc55c9a5 · 2021-09-02T20:16:33.000Z
diff --git a/lib/matplotlib/streamplot.py b/lib/matplotlib/streamplot.py
@@ -26,7 +26,9 @@ def streamplot(axes, x, y, u, v, density=1, linewidth=None, color=None,
     Parameters
     ----------
     x, y : 1D/2D arrays
-        Evenly spaced strictly increasing arrays to make a grid.
+        Evenly spaced strictly increasing arrays to make a grid.  If 2D, all
+        rows of *x* must be equal and all columns of *y* must be equal; i.e.,
+        they must be as if generated by ``np.meshgrid(x_1d, y_1d)``.
     u, v : 2D arrays
         *x* and *y*-velocities. The number of rows and columns must match
         the length of *y* and *x*, respectively.
