matplotlib.axes.Axes.stem

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

Параметры

locsмассив-подобный, по умолчанию: (0, 1, ..., len(heads) - 1)

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

headsмассив-подобный

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

linefmtстрока, необязательно

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

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

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

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

markerfmtстрока, необязательно

Строка, определяющая цвет и/или форму маркеров в головах стеблей. По умолчанию: 'C0o', т.е. заполненные круги с первым цветом цикла цветов.

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

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

orientationстрока, по умолчанию: 'vertical'

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

bottomвещественное число, по умолчанию: 0

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

labelстрока, по умолчанию: None

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

use_line_collectionлогическое значение, по умолчанию: True

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

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

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

Возвращает

StemContainer

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

Примечания

См. также

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

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