Spec-Zone.ru › Matplotlib 3.4

matplotlib.pyplot.step

matplotlib.pyplot.step(x, y, *args, where='pre', data=None, **kwargs)[source]

Построение ступенчатой диаграммы.

Подписи функций:

step(x, y, [fmt], *, data=None, where='pre', **kwargs)
step(x, y, [fmt], x2, y2, [fmt2], ..., *, where='pre', **kwargs)

Это просто тонкая обертка вокруг plot, которая изменяет некоторые параметры форматирования. Большинство концепций и параметров функции plot также могут быть использованы здесь.

Примечание

Этот метод использует стандартную диаграмму с типом рисования «ступенька»: значения x являются опорными позициями, а шаги расширяются влево/вправо/в обе стороны в зависимости от параметра where.

Для распространённого случая, когда известны значения и границы шагов, используйте stairs вместо этого.

Параметры:
xarray-like

Последовательность значений x. Предполагается, но не проверяется, что она возрастает равномерно.

yarray-like

Последовательность значений y.

fmtstr, необязательно

Строка формата, например, 'g' для зелёной линии. Смотрите plot для более подробного описания.

Примечание: хотя принимаются полные строки формата, рекомендуется указывать только цвет. Стиль линии в настоящее время игнорируется (используйте ключевой аргумент linestyle вместо него). Маркеры принимаются и выводятся в заданных позициях, однако это редко используемая функция для ступенчатых диаграмм.

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

Объект с маркированными данными. Если задан, укажите имена меток для построения по осям x и y.

where{'pre', 'post', 'mid'}, по умолчанию: 'pre'

Определяет, где должны быть расположены ступени:

  • 'pre': Значение y постоянно продолжается влево от каждой позиции x, т.е. интервал (x[i-1], x[i]] имеет значение y[i].
  • 'post': Значение y постоянно продолжается вправо от каждой позиции x, т.е. интервал [x[i], x[i+1]) имеет значение y[i].
  • 'mid': Ступени находятся посредине между позициями x.
Возвращаемое значение:
list of Line2D

Объекты, представляющие построенные данные.

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

Дополнительные параметры совпадают с параметрами plot.

Примечания

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

Stairs Demo

Демонстрация ступенчатой диаграммы

Step Demo

Демонстрация диаграммы ступенек

© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/_as_gen/matplotlib.pyplot.step.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API