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 объектов. Этот параметр может быть устаревшим в будущем.

Возвращает:

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

Примечания

См. также

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

Примечание

Помимо перечисленных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, все остальные аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключения).

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

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

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

3D стебель