diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py index 3d2d52b04474..49a3b529ca0b 100644 --- a/lib/matplotlib/axes/_axes.py +++ b/lib/matplotlib/axes/_axes.py @@ -3889,17 +3889,25 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None, ---------------- kwargs : `~matplotlib.collections.Collection` properties + See Also + -------- + plot : to plot scatter plots when markers are identical in size and + color + Notes - ------ - Any or all of `x`, `y`, `s`, and `c` may be masked arrays, in - which case all masks will be combined and only unmasked points - will be plotted. + ----- + + * The `plot` function will be faster for scatterplots where markers + don't vary in size or color. + + * Any or all of `x`, `y`, `s`, and `c` may be masked arrays, in which + case all masks will be combined and only unmasked points will be + plotted. - Fundamentally, scatter works with 1-D arrays; `x`, `y`, `s`, - and `c` may be input as 2-D arrays, but within scatter - they will be flattened. The exception is `c`, which - will be flattened only if its size matches the size of `x` - and `y`. + Fundamentally, scatter works with 1-D arrays; `x`, `y`, `s`, and `c` + may be input as 2-D arrays, but within scatter they will be + flattened. The exception is `c`, which will be flattened only if its + size matches the size of `x` and `y`. Examples --------