matplotlib.axes.Axes.stem

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

Parameters:

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-' в классическом режиме)

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

orientationstr, по умолчанию: 'vertical'

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

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

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

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

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

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

Устарело начиная с 3.6

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

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

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

Returns:

StemContainer

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

Примечания

См. также

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

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

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

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

3D стебель

3D стебель

stem(x, y)

stem(x, y)