matplotlib.pyplot.scatter #
- matplotlib.pyplot。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
)。
- 返回:
- 其他参数:
- 数据可索引对象,可选
如果给定,以下参数也接受一个字符串
s
,它被解释为data[s]
(除非这引发异常):x , y , s ,线宽, edgecolors , c , facecolor , facecolors , color
- **kwargs
Collection
属性
也可以看看
plot
当标记的大小和颜色相同时绘制散点图。
笔记
对于标记大小或颜色不变的散点图,该
plot
函数会更快。x、y、s和c中的任何一个或全部都可以是掩码数组,在这种情况下,所有掩码将被组合,并且只会绘制未掩码的点。
从根本上说, scatter 适用于一维数组;x、y、s和c 可以作为 ND 数组输入,但在 scatter 内它们将被展平。例外是c,只有当它的大小与x和y的大小匹配时才会被展平。