Merge pull request matplotlib#7096 from NelleV/7083_doc_scatter_vs_plot

efiring · web-flow · commit 684861b52e2d · 2016-09-19T17:48:22.000-10:00
[MRG] DOC refer to plot in the scatter plot doc
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3893,17 +3893,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
         --------
