From 99fb60363efd349db62a03cce1e7421288c41758 Mon Sep 17 00:00:00 2001 From: Thomas A Caswell Date: Sun, 21 Aug 2016 19:02:59 -0400 Subject: [PATCH 1/2] DOC: Document `verts` in scatter close #6958 --- lib/matplotlib/axes/_axes.py | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py index 5325f50a4d37..cb6772982bcc 100644 --- a/lib/matplotlib/axes/_axes.py +++ b/lib/matplotlib/axes/_axes.py @@ -3811,8 +3811,7 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None, vmin=None, vmax=None, alpha=None, linewidths=None, verts=None, edgecolors=None, **kwargs): - """ - Make a scatter plot of x vs y, where x and y are sequence like objects + """Make a scatter plot of x vs y, where x and y are sequence like objects of the same length. Parameters @@ -3861,6 +3860,11 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None, linewidths : scalar or array_like, optional, default: None If None, defaults to (lines.linewidth,). + verts : sequence of (x, y), optional + If `marker` is None, these vertices will be used to + construct the marker. The center of the marker is located + at (0,0) and the size is normalized. + edgecolors : color or sequence of color, optional, default: None If None, defaults to 'face' From 7a23966b92ca67aa31d581fef84ad17bf2b1e6ce Mon Sep 17 00:00:00 2001 From: Thomas A Caswell Date: Wed, 19 Oct 2016 11:41:00 -0400 Subject: [PATCH 2/2] DOC: tweak scatter docstring a bit --- lib/matplotlib/axes/_axes.py | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py index cb6772982bcc..a96ffafe0e08 100644 --- a/lib/matplotlib/axes/_axes.py +++ b/lib/matplotlib/axes/_axes.py @@ -3811,8 +3811,10 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None, vmin=None, vmax=None, alpha=None, linewidths=None, verts=None, edgecolors=None, **kwargs): - """Make a scatter plot of x vs y, where x and y are sequence like objects - of the same length. + """ + Make a scatter plot of `x` vs `y` + + Marker size is scaled by `s` and marker color is mapped to `c` Parameters ---------- @@ -3863,7 +3865,8 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None, verts : sequence of (x, y), optional If `marker` is None, these vertices will be used to construct the marker. The center of the marker is located - at (0,0) and the size is normalized. + at (0,0) in normalized units. The overall marker is rescaled + by ``s``. edgecolors : color or sequence of color, optional, default: None If None, defaults to 'face'