matplotlib.axes.Axes.stem

Axes.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, use_line_collection=<deprecated parameter>, orientation='vertical', data=None)[source]

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

Диаграмма «стебель» рисует линии, перпендикулярные базовой линии в каждой позиции locs от базовой линии до heads, и помещает там маркер. Для вертикальных диаграмм «стебель» (по умолчанию) locs — это позиции x, а heads — значения y. Для горизонтальных диаграмм «стебель» locs — это позиции y, а heads — значения x.

Вызов функции:

stem([locs,] heads, linefmt=None, markerfmt=None, basefmt=None)

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

Параметры:

locsarray-like, по умолчанию: (0, 1, ..., len(heads) - 1)

Для вертикальных диаграмм «стебель», позиции x стеблей. Для горизонтальных диаграмм «стебель», позиции y стеблей.

headsarray-like

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

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

Строка, определяющая цвет и/или стиль линии вертикальных линий:

Символ	Стиль линии
'-'	сплошная линия
'--'	штриховая линия
'-.'	штрих-пунктирная линия
':'	пунктирная линия

По умолчанию: 'C0-', т.е. сплошная линия с первым цветом цикла цветов.

Примечание: Маркеры, заданные через этот параметр (например, 'x'), будут игнорироваться (если не используется use_line_collection=False). Вместо этого маркеры должны быть заданы с помощью markerfmt.

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

Строка, определяющая цвет и/или форму маркеров на головках стеблей. Если маркер не задан, используется маркер 'o', т.е. заполненные круги. Если цвет не задан, используется цвет из linefmt.

basefmtstr, по умолчанию: 'C3-' ('C2-' в классическом режиме)

Строка формата, определяющая свойства базовой линии.

orientation{'vertical', 'horizontal'}, по умолчанию: 'vertical'

Если 'vertical', то будет создана диаграмма со стеблями, ориентированными вертикально, если 'horizontal', стебли будут ориентированы горизонтально.

bottomfloat, по умолчанию: 0

Позиция y/x базовой линии (в зависимости от ориентации).

labelstr, по умолчанию: None

Метка для использования стеблей в легендах.

use_line_collectionbool, по умолчанию: True

Устарело с версии 3.6

Если True, сохраните и отобразите линии стебля в виде LineCollection вместо отдельных линий, что значительно повышает производительность. Если False, используется старое поведение с использованием списка объектов Line2D.

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

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

Возвращает:

StemContainer

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

Примечания

См. также

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

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

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

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

Демонстрация легенды

Демонстрация легенды

3D стебель

3D стебель

stem(x, y)

stem(x, y)