Spec-Zone.ru › Matplotlib 3.4

matplotlib.axes.Axes.step

Axes.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 также могут быть использованы здесь.

Примечание

Этот метод использует стандартную диаграмму с типом рисования step: значения 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.
Возвращает:
список Line2D

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

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

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

Примечания

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

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

Spec-Zone.ru

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