Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 17 additions & 9 deletions lib/matplotlib/axes/_axes.py
Original file line number Diff line number Diff line change
Expand Up @@ -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

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what about for scatterplots where markers are identical in size and color (nitpicky as all out, but I find the plot: to plot construction clunky)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This needs backticks to cross-link, doesn't it?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No it doesn't, thought it is currently impossible to check on matplotlib's documentation.

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
--------
Expand Down