@@ -4295,11 +4295,12 @@ def invalid_shape_exception(csize, xsize):
4295
4295
else : # Wrong size; it must not be intended for mapping.
4296
4296
if c .shape in ((3 ,), (4 ,)):
4297
4297
_log .warning (
4298
- "'c' argument looks like a single numeric RGB or "
4298
+ "*c* argument looks like a single numeric RGB or "
4299
4299
"RGBA sequence, which should be avoided as value-"
4300
4300
"mapping will have precedence in case its length "
4301
- "matches with 'x' & 'y'. Please use a 2-D array "
4302
- "with a single row if you really want to specify "
4301
+ "matches with *x* & *y*. Please use the *color* "
4302
+ "keyword-argument or provide a 2-D array "
4303
+ "with a single row if you intend to specify "
4303
4304
"the same RGB or RGBA value for all points." )
4304
4305
valid_shape = False
4305
4306
if not c_is_mapped :
@@ -4346,14 +4347,14 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
4346
4347
The marker size in points**2.
4347
4348
Default is ``rcParams['lines.markersize'] ** 2``.
4348
4349
4349
- c : color or list of colors or array-like , optional
4350
- The marker color . Possible values:
4350
+ c : array-like or list of colors or color , optional
4351
+ The marker colors . Possible values:
4351
4352
4352
- - A single color format string.
4353
- - A sequence of colors of length n.
4354
4353
- A scalar or sequence of n numbers to be mapped to colors using
4355
4354
*cmap* and *norm*.
4356
4355
- A 2-D array in which the rows are RGB or RGBA.
4356
+ - A sequence of colors of length n.
4357
+ - A single color format string.
4357
4358
4358
4359
Note that *c* should not be a single numeric RGB or RGBA sequence
4359
4360
because that is indistinguishable from an array of values to be
@@ -4362,9 +4363,12 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
4362
4363
matching will have precedence in case of a size matching with *x*
4363
4364
and *y*.
4364
4365
4365
- Defaults to ``None``. In that case the marker color is determined
4366
- by the value of ``color``, ``facecolor`` or ``facecolors``. In case
4367
- those are not specified or ``None``, the marker color is determined
4366
+ If you wish to specify a single color for all points
4367
+ prefer the *color* keyword argument.
4368
+
4369
+ Defaults to `None`. In that case the marker color is determined
4370
+ by the value of *color*, *facecolor* or *facecolors*. In case
4371
+ those are not specified or `None`, the marker color is determined
4368
4372
by the next color of the ``Axes``' current "shape and fill" color
4369
4373
cycle. This cycle defaults to :rc:`axes.prop_cycle`.
4370
4374
0 commit comments