matplotlib.pyplot.ecdf

matplotlib.pyplot.ecdf(x, weights=None, *, complementary=False, orientation='vertical', compress=False, data=None, **kwargs)

计算并绘制 x 的经验累积分布函数。

在版本 3.8 中添加。

参数:

x一维类数组

输入数据。无穷大的条目会保留（并将 ecdf 的相关末端从 0/1 移动），但 NaN 和掩码值是错误。

weights一维类数组或 None，默认值: None

条目的权重；必须与 x 具有相同的形状。与 NaN 数据点对应的权重将被丢弃，然后剩余的权重将归一化，使其总和为 1。如果未设置，所有条目具有相同的权重。

complementary布尔值，默认值: False

是绘制从 0 增加到 1 的累积分布函数（默认），还是绘制从 1 减少到 0 的互补累积分布函数。

orientation{"vertical"（垂直）, "horizontal"（水平）}，默认值: "vertical"

条目是沿 x 轴（“垂直”，默认）还是 y 轴（“水平”）绘制。此参数采用与 hist 中相同的值。

compress布尔值，默认值: False

是否在绘制前将具有相同值的多个条目组合在一起（并累加权重）。这主要在 x 包含许多相同数据点时有用，以降低绘图的渲染复杂性。如果 x 不包含重复点，则此操作无效，仅会占用一些时间和内存。

返回:

Line2D

其他参数:

data可索引对象，可选

如果给出，以下参数也接受字符串 s，如果 s 是 data 中的一个键，则将其解释为 data[s]

x, weights

**kwargs

关键字参数控制 Line2D 属性

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	浮点数或 None
animated	布尔值
antialiased 或 aa	布尔值
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
color 或 c	color
dash_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
dash_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
dashes	浮点数序列（点中的开/关墨迹）或 (None, None)
data	(2, N) 数组或两个一维数组
drawstyle 或 ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值: 'default'
figure	Figure 或 SubFigure
fillstyle	{'full'（全）, 'left'（左）, 'right'（右）, 'bottom'（底）, 'top'（顶）, 'none'（无）}
gapcolor	颜色 或 None
gid	str
in_layout	布尔值
label	对象
linestyle 或 ls	{'-'（实线）, '--'（虚线）, '-.'（点划线）, ':'（点线）, ''（无）, (偏移量, 开-关序列), ...}
linewidth 或 lw	浮点数
marker	标记样式字符串，Path 或 MarkerStyle
markeredgecolor 或 mec	color
markeredgewidth 或 mew	浮点数
markerfacecolor 或 mfc	color
markerfacecoloralt 或 mfcalt	color
markersize 或 ms	浮点数
markevery	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
mouseover	布尔值
path_effects	AbstractPathEffect 列表
picker	浮点数或 callable[[Artist, Event], tuple[bool, dict]]
pickradius	浮点数
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
solid_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
transform	未知
url	str
visible	布尔值
xdata	一维数组
ydata	一维数组
zorder	浮点数

备注

注意

这是 pyplot 封装器，对应于 axes.Axes.ecdf。

ecdf 图可以看作是每个数据条目一个 bin 的累积直方图；即，它报告整个数据集而无需任意分箱。

如果 x 包含 NaN 或掩码条目，则首先从数组中删除它们（如果它们不应被考虑），或将其替换为 -inf 或 +inf（如果它们应在数组开头或结尾排序）。

使用 matplotlib.pyplot.ecdf 的示例

累积分布

累积分布