matplotlib.pyplot.stem

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

Диаграмма с отметками