matplotlib.pyplot.ecdf

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

Вычисляет и строит эмпирическую функцию распределения x.

Добавлена в версии 3.8.

Параметры:

xодномерный массив-подобный объект

Входные данные. Бесконечные значения сохраняются (и перемещают соответствующий конец ecdf из 0/1), но значения NaN и значения с маской являются ошибками.

weightsодномерный массив-подобный объект или None, по умолчанию: None

Веса элементов; должен иметь такую же форму, как и x. Веса, соответствующие значениям NaN, отбрасываются, а оставшиеся веса нормируются так, чтобы их сумма была равна 1. Если не указано, все элементы имеют одинаковый вес.

complementarybool, по умолчанию: False

Указывает, нужно ли построить функцию кумулятивного распределения, которая увеличивается от 0 до 1 (по умолчанию), или дополнительную функцию кумулятивного распределения, которая уменьшается от 1 до 0.

orientation{"вертикальный", "горизонтальный"}, по умолчанию: "вертикальный"

Указывает, по какой оси отображаются элементы — по оси абсцисс ("вертикальный", по умолчанию) или по оси ординат ("горизонтальный"). Этот параметр принимает те же значения, что и в hist.

compressbool, по умолчанию: False

Указывает, нужно ли объединять несколько элементов с одинаковыми значениями (с суммарным весом) перед построением графика. Это полезно в основном, если x содержит много одинаковых точек данных, чтобы уменьшить сложность рендеринга графика. Если x не содержит дублирующих точек, это не влияет, просто затрачивает время и память.

Возвращаемые значения:

Line2D

Другие параметры:

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение):

x, weights

**kwargs

Ключевые аргументы управляют свойствами Line2D:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	скаляр или None
animated	bool
antialiased или aa	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
color или c	цвет
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
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gapcolor	цвет или None
gid	строка
in_layout	bool
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
linewidth или lw	число с плавающей точкой
marker	строка стиля маркера, Path или MarkerStyle
markeredgecolor или mec	цвет
markeredgewidth или mew	число с плавающей точкой
markerfacecolor или mfc	цвет
markerfacecoloralt или mfcalt	цвет
markersize или ms	число с плавающей точкой
markevery	None или int или (int, int) или срез или список[int] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список[bool]
mouseover	bool
path_effects	список AbstractPathEffect
picker	число с плавающей точкой или вызываемая функция [[Artist, Event], кортеж[bool, dict]]
pickradius	число с плавающей точкой
rasterized	bool
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
solid_capstyle	CapStyle или {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle или {'miter', 'round', 'bevel'}

transform	неизвестно
url	строка
visible	логическое значение
xdata	одномерный массив
ydata	одномерный массив
zorder	число с плавающей точкой

Примечания

Примечание

Это обертка pyplot для axes.Axes.ecdf.

График ecdf можно рассматривать как кумулятивную гистограмму с одним интервалом на каждое значение данных; то есть он отображает весь набор данных без произвольного разделения на интервалы.

Если в x содержатся значения NaN или замаскированные элементы, либо предварительно удалите их из массива (если они не должны учитываться), либо замените их на -inf или +inf (если их нужно отсортировать в начале или конце массива).

Примеры использования matplotlib.pyplot.ecdf

Построение кумулятивных распределений

Построение кумулятивных распределений