matplotlib.pyplot.stem

matplotlib.pyplot.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.

Параметры:

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

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

headsмассив-подобный объект

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

use_line_collectionбулево значение, по умолчанию: True

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

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

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

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

Возвращает:

StemContainer

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

Примечания

См. также

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

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

Диаграмма «стержень»

Диаграмма «стержень»