matplotlib.axes.Axes.scatter #

轴。scatter ( x , y , s = None , c = None , marker = None , cmap = None , norm = None , vmin = None , vmax = None , alpha = None , linewidths = None , * , edgecolors = None , plotnonfinite =假的，data = None , ** kwargs ) [来源] #

具有不同标记大小和/或颜色的y与x的散点图。

参数：

x, y浮点数或类似数组，形状 (n, )

数据位置。

s float 或类似数组，形状 (n, )，可选

以点为单位的标记大小**2。默认为。rcParams['lines.markersize'] ** 2

c类数组或颜色或颜色列表，可选

标记颜色。可能的值：

要使用cmap和norm映射到颜色的 n 个数字的标量或序列。
一个二维数组，其中的行是 RGB 或 RGBA。
长度为 n 的颜色序列。
单一颜色格式字符串。

请注意，c不应是单个数字 RGB 或 RGBA 序列，因为它与要进行颜色映射的值数组无法区分。如果要为所有点指定相同的 RGB 或 RGBA 值，请使用具有单行的二维数组。否则，在大小与x 和y匹配的情况下，值匹配将具有优先权。

如果您希望为所有点指定单一颜色，请首选color关键字参数。

默认为None. 在这种情况下，标记颜色由color、facecolor或facecolors的值确定。如果未指定或None，则标记颜色由Axes当前“形状和填充”颜色循环的下一个颜色确定。此循环默认为rcParams["axes.prop_cycle"]（默认值：）。cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])

标记MarkerStyle，默认值：（rcParams["scatter.marker"]默认值'o'：）

标记样式。标记可以是类的一个实例，也可以是特定标记的文本速记。有关标记样式的更多信息，请参阅matplotlib.markers。

cmap str 或Colormap，默认值：（rcParams["image.cmap"]默认值'viridis'：）

用于将标量数据映射到颜色的颜色图实例或注册的颜色图名称。

如果c为 RGB(A)，则忽略此参数。

范数str 或Normalize, 可选

在使用cmap映射到颜色之前，用于将标量数据缩放到 [0, 1] 范围的标准化方法。默认情况下，使用线性缩放，将最小值映射到 0，将最大值映射到 1。

如果给出，这可以是以下之一：

一个实例Normalize或其子类之一（请参阅Colormap Normalization）。
刻度名称，即“linear”、“log”、“symlog”、“logit”等之一。有关可用刻度的列表，请调用matplotlib.scale.get_scale_names()。Normalize在这种情况下，会动态生成并实例化一个合适的子类。

如果c为 RGB(A)，则忽略此参数。

vmin, vmax浮点数，可选

当使用标量数据且没有明确的norm时，vmin和vmax定义颜色图覆盖的数据范围。默认情况下，颜色图覆盖所提供数据的完整值范围。给定范数实例时使用vmin / vmax是错误的（但可以接受将范数名称与vmin / vmax一起使用）。str

如果c为 RGB(A)，则忽略此参数。

alpha浮点数，默认值：无

Alpha 混合值，介于 0（透明）和 1（不透明）之间。

线宽浮动或类似数组，默认：（rcParams["lines.linewidth"]默认1.5：）

标记边缘的线宽。注意：默认的边缘颜色 是“面”。您可能也想更改此设置。

edgecolors {'face', 'none', None } 或颜色或颜色序列，默认值：（rcParams["scatter.edgecolors"]默认值'face'：）

标记的边缘颜色。可能的值：

'face'：边缘颜色将始终与面颜色相同。
'none'：不绘制补丁边界。
颜色或颜色序列。

对于未填充的标记，edgecolors被忽略。取而代之的是，颜色是像使用 'face' 确定的，即从c、colors或 facecolors 确定。

plotnonfinite bool，默认值：False

是否用非有限c绘制点（即inf，-inf 或nan）。如果True这些点是使用错误的颜色图颜色绘制的（请参阅参考资料Colormap.set_bad）。

返回：

PathCollection

其他参数：

数据可索引对象，可选

如果给定，以下参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）：

x , y , s ,线宽, edgecolors , c , facecolor , facecolors , color

**kwargsCollection属性

也可以看看

plot: 当标记的大小和颜色相同时绘制散点图。

笔记

对于标记大小或颜色不变的散点图，该plot函数会更快。
x、y、s和c中的任何一个或全部都可以是掩码数组，在这种情况下，所有掩码将被组合，并且只会绘制未掩码的点。
从根本上说， scatter 适用于一维数组；x、y、s和c 可以作为 ND 数组输入，但在 scatter 内它们将被展平。例外是c，只有当它的大小与x和y的大小匹配时才会被展平。