matplotlib.axes.Axes.stem

Axes.stem(self, *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, use_line_collection=False, data=None) [source]

Создать диаграмму «стебель».

Диаграмма «стебель» строит вертикальные линии в каждой точке x от базовой линии до y и размещает там маркер.

Вызов:

stem([x,] y, linefmt=None, markerfmt=None, basefmt=None)

Позиции x необязательны. Форматы могут быть предоставлены как позиционными, так и в качестве ключевых аргументов.

Параметры:

x : array-like, optional Позиции x стеблей. По умолчанию: (0, 1, ..., len(y) - 1). y : array-like Значения y головок стеблей. linefmt : str, optional Строка, определяющая свойства вертикальных линий. Обычно это цвет или цвет и тип линии: Символ Тип линии '-' сплошная линия '--' штриховая линия '-.' штрихпунктирная линия ':' пунктирная линия По умолчанию: 'C0-', т.е. сплошная линия первого цвета цикла цветов. Примечание: хотя технически можно указать форматы, отличные от цвета или цвета и типа линии (например, 'rx' или '-.'), это выходит за рамки предназначения метода и, скорее всего, не приведет к разумному графику. markerfmt : str, optional Строка, определяющая свойства маркеров в головках стеблей. По умолчанию: 'C0o', т.е. заполненные кружки первого цвета цикла цветов. basefmt : str, optional Строка формата, определяющая свойства базовой линии. По умолчанию: 'C3-' ('C2-' в классическом режиме). bottom : float, optional, default: 0 Позиция y базовой линии. label : str, optional, default: None Метка для использования стеблей в легендах. use_line_collection : bool, optional, default: False Если True, сохраните и отобразите линии стеблей как LineCollection вместо отдельных линий. Это значительно повышает производительность и станет вариантом по умолчанию в Matplotlib 3.3. Если False, по умолчанию используется старое поведение с использованием списка объектов Line2D.

Возвращает:

container : StemContainer Контейнер можно рассматривать как кортеж (markerline, stemlines, baseline)

Примечания

См. также

Функцию MATLAB stem, которая послужила вдохновением для этого метода.

Примечание

В дополнение к описанным выше аргументам эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все позиционные и все ключевые аргументы.

Объекты, переданные как data, должны поддерживать доступ к элементам (data[<arg>]) и проверку на членство (<arg> in data).

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

Диаграмма «стебель»

Создание временной шкалы с линиями, датами и текстом