matplotlib.axes.Axes.stem

Axes.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, 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 можно указать позиционно, но все остальные форматы должны быть указаны в качестве аргументов ключевых слов.

Parameters:

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

Для вертикальных графиков стебля — позиции по оси x стеблей. Для горизонтальных графиков стебля — позиции по оси y стеблей.

headsarray-like

Для вертикальных графиков стебля — значения по оси y голов стеблей. Для горизонтальных графиков стебля — значения по оси x голов стеблей.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Returns:

StemContainer

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

Примечания

См. также

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

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

График стебля

График стебля

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

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

3D стебель

3D стебель

stem(x, y)

stem(x, y)