matplotlib.pyplot

matplotlib.pyplot — это интерфейс на основе состояния для matplotlib. Он предоставляет неявный, похожий на MATLAB, способ построения графиков. Он также открывает графики на вашем экране и действует как менеджер графического интерфейса фигур.

pyplot предназначен в основном для интерактивных графиков и простых случаев программно-генерируемых графиков:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
plt.plot(x, y)

Для сложных графиков рекомендуется использовать явный объектно-ориентированный API, хотя pyplot всё равно обычно используется для создания фигуры и часто осей в фигуре. См. pyplot.figure, pyplot.subplots и pyplot.subplot_mosaic для создания фигур, а также API осей для методов построения графиков на оси:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

См. Интерфейсы приложений Matplotlib (API) для объяснения компромиссов между неявными и явными интерфейсами.

Управление фигурой и осями

`axes`	Добавить ось к текущей фигуре и сделать её текущей осью.
`cla`	Очистить текущую ось.
`clf`	Очистить текущую фигуру.
`close`	Закрыть окно фигуры.
`delaxes`	Удалить `Axes` (по умолчанию текущую ось) из её фигуры.
`fignum_exists`	Возвращает, существует ли фигура с заданным идентификатором.
`figure`	Создать новую фигуру или активировать существующую.
`gca`	Получить текущую ось.
`gcf`	Получить текущую фигуру.
`get_figlabels`	Возвращает список существующих меток фигур.
`get_fignums`	Возвращает список существующих номеров фигур.
`sca`	Установить текущую ось на ax и текущую фигуру на родителя ax.
`subplot`	Добавить ось к текущей фигуре или получить существующую ось.
`subplot2grid`	Создать подграфик в определенном месте внутри регулярной сетки.
`subplot_mosaic`	Построить макет осей на основе ASCII-арта или вложенных списков.
`subplots`	Создать фигуру и набор подграфиков.
`twinx`	Создать и вернуть вторую ось, которая разделяет ось x.
`twiny`	Создать и вернуть вторую ось, которая разделяет ось y.

END_OF_DOCUMENT_MARKER

Добавление данных на график

Основные

`plot`	Построение графика y по оси x в виде линий и/или маркеров.
`errorbar`	Построение графика y по оси x в виде линий и/или маркеров с ошибками.
`scatter`	Диаграмма рассеяния y по x.
`plot_date`	[Не рекомендуется] Построение графика с принудительной интерпретацией чисел с плавающей точкой как дат.
`step`	Построение ступенчатого графика.
`loglog`	Построение графика с логарифмической шкалой по обеим осям (x и y).
`semilogx`	Построение графика с логарифмической шкалой по оси x.
`semilogy`	Построение графика с логарифмической шкалой по оси y.
`fill_between`	Заполнение области между двумя кривыми.
`fill_betweenx`	Заполнение области между двумя вертикальными кривыми.
`bar`	Построение столбчатой диаграммы.
`barh`	Построение горизонтальной столбчатой диаграммы.
`bar_label`	Подпись столбчатой диаграммы.
`stem`	Построение графика стебля.
`eventplot`	Построение параллельных линий в заданных позициях.
`pie`	Построение круговой диаграммы.
`stackplot`	Построение графиков с накоплением.
`broken_barh`	Построение горизонтальной последовательности прямоугольников.
`vlines`	Построение вертикальных линий для каждого x от ymin до ymax.
`hlines`	Построение горизонтальных линий для каждого y от xmin до xmax.
`fill`	Построение заполненных многоугольников.
`polar`	Построение полярного графика.

Отрезки

`axhline`	Добавление горизонтальной линии через оси.
`axhspan`	Добавление горизонтального отрезка (прямоугольника) через оси.
`axvline`	Добавление вертикальной линии через оси.
`axvspan`	Добавление вертикального отрезка (прямоугольника) через оси.
`axline`	Добавление прямой линии бесконечной длины.

Спектральный

`acorr`	Построение автокорреляции x.
`angle_spectrum`	Построение спектра фаз.
`cohere`	Построение когерентности между x и y.
`csd`	Построение кросс-спектральной плотности.
`magnitude_spectrum`	Построение спектра амплитуд.
`phase_spectrum`	Построение спектра фаз.
`psd`	Построение спектральной плотности мощности.
`specgram`	Построение спектрограммы.
`xcorr`	Построение взаимной корреляции между x и y.

Статистика

`ecdf`	Вычисление и построение эмпирической функции распределения для x.
`boxplot`	Построение диаграммы размаха.
`violinplot`	Построение скрипичного графика.

Дискретизированные

`hexbin`	Построение 2D-графика гексагональной дискретизации точек x, y.
`hist`	Вычисление и построение гистограммы.
`hist2d`	Построение 2D-гистограммы.
`stairs`	Ступенчатая константная функция в виде линии с ограничивающими границами или заполненного графика.

Контуры

`clabel`	Подпись контурного графика.
`contour`	Построение линий контура.
`contourf`	Построение заполненных контуров.

Двумерные массивы

`imshow`	Отображение данных как изображения, т.е. на 2D регулярной растровой сетке.
`matshow`	Отображение массива как матрицы в новом окне фигуры.
`pcolor`	Создание псевдоцветного графика с нерегулярной прямоугольной сеткой.
`pcolormesh`	Создание псевдоцветного графика с нерегулярной прямоугольной сеткой.
`spy`	Построение структуры разреженности 2D-массива.
`figimage`	Добавление не-ресамплированного изображения в фигуру.

Неструктурированные треугольники

`triplot`	Отрисовка неструктурированной треугольной сетки в виде линий и/или маркеров.
`tripcolor`	Создание псевдоцветного графика неструктурированной треугольной сетки.
`tricontour`	Отрисовка линий контура на неструктурированной треугольной сетке.
`tricontourf`	Отрисовка областей контура на неструктурированной треугольной сетке.

Текст и аннотации

`annotate`	Аннотация точки xy текстом text.
`text`	Добавление текста на ось.
`figtext`	Добавление текста в фигуру.
`table`	Добавление таблицы в `Axes`.
`arrow`	Добавление стрелки на ось.
`figlegend`	Размещение легенды на фигуре.
`legend`	Размещение легенды на оси.

Векторные поля

`barbs`	Построение 2D поля стрелок-барбов.
`quiver`	Построение 2D поля стрелок.
`quiverkey`	Добавление ключа к графику quiver.
`streamplot`	Построение линий потока векторного поля.

Настройка осей

`autoscale`	Автоматическое масштабирование области отображения к данным (переключатель).
`axis`	Удобный метод для получения или установки некоторых свойств осей.
`box`	Включение или выключение рамки осей на текущей оси.
`grid`	Настройка линий сетки.
`locator_params`	Управление поведением основных локеров делений.
`minorticks_off`	Удаление вспомогательных делений с осей.
`minorticks_on`	Отображение вспомогательных делений на осях.
`rgrids`	Получение или установка радиальных линий сетки на текущем полярном графике.
`thetagrids`	Получение или установка линий сетки по углу на текущем полярном графике.
`tick_params`	Изменение внешнего вида делений, меток делений и линий сетки.
`ticklabel_format`	Настройка `ScalarFormatter`, используемой по умолчанию для линейных осей.
`xlabel`	Установить метку для оси X.
`xlim`	Получение или установка пределов по оси X для текущей области.
`xscale`	Установить масштаб оси X.
`xticks`	Получение или установка текущих значений и меток делений оси X.
`ylabel`	Установить метку для оси Y.
`ylim`	Получение или установка пределов по оси Y для текущей области.
`yscale`	Установить масштаб оси Y.
`yticks`	Получение или установка текущих значений и меток делений оси Y.
`suptitle`	Добавление центрированного заголовка к фигуре.
`title`	Установить заголовок для области.

Макет

`margins`	Установить или получить отступы автомасштабирования.
`subplots_adjust`	Настройка параметров макета подграфиков.
`subplot_tool`	Открыть окно инструмента подграфиков для фигуры.
`tight_layout`	Настройка отступов между и вокруг подграфиков.

Отображение цветовых карт

`clim`	Установить пределы цвета текущего изображения.
`colorbar`	Добавить цветовой бар к графику.
`gci`	Получить текущий цветной элемент.
`sci`	Установить текущее изображение.
`get_cmap`	Получить экземпляр цветовой карты, по умолчанию используя значения из rc, если name равно None.
`set_cmap`	Установить цветовую карту по умолчанию и применить ее к текущему изображению, если оно есть.
`imread`	Прочитать изображение из файла в массив.
`imsave`	Сохранить массив как изображение файла с цветовой картой.

Цветовые карты доступны через реестр цветовых карт matplotlib.colormaps. Для удобства этот реестр доступен в pyplot как

matplotlib.pyplot.colormaps[source]

Контейнер для цветовых карт, известных Matplotlib по имени.

Универсальный экземпляр реестра — matplotlib.colormaps. Пользователям не нужно создавать экземпляры ColormapRegistry.

Чтение использует интерфейс типа словаря, сопоставляющий имена с Colormap:

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

Возвращаемые Colormap являются копиями, чтобы их изменение не повлияло на глобальное определение цветовой карты.

Дополнительные цветовые карты могут быть добавлены с помощью ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

Чтобы получить список всех зарегистрированных цветовых карт, можно сделать следующее:

from matplotlib import colormaps
list(colormaps)

Кроме того, существуют сокращенные функции для установки встроенных цветовых карт; например, plt.viridis() эквивалентно plt.set_cmap('viridis').

matplotlib.pyplot.color_sequences[source]

Контейнер для последовательностей цветов, известных Matplotlib по имени.

Универсальный экземпляр реестра — matplotlib.color_sequences. Пользователям не нужно создавать экземпляры ColorSequenceRegistry.

Чтение использует интерфейс типа словаря, сопоставляющий имена спискам цветов:

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

Возвращаемые списки являются копиями, чтобы их изменение не повлияло на глобальное определение последовательности цветов.

Дополнительные последовательности цветов могут быть добавлены с помощью ColorSequenceRegistry.register:

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])

Конфигурация

`rc`	Установить текущие `rcParams`. group — группа rc, например, для `lines.linewidth` группа — `lines`, для `axes.facecolor`, группа — `axes`, и так далее. Группа также может быть списком или кортежем имен групп, например, (xtick, ytick). kwargs — словарь пар имя/значение атрибутов, например::.
`rc_context`	Возвращает контекстный менеджер для временного изменения rcParams.
`rcdefaults`	Восстановить `rcParams` из внутренних стилей по умолчанию Matplotlib.

Вывод

`draw`	Перерисовать текущую фигуру.
`draw_if_interactive`	Перерисовать текущую фигуру, если режим интерактивный.
`ioff`	Отключить интерактивный режим.
`ion`	Включить интерактивный режим.
`install_repl_displayhook`	Подключиться к дисплейному хуку текущей оболочки.
`isinteractive`	Возвращает, обновляются ли графики после каждой команды построения.
`pause`	Запустить цикл событий графического интерфейса пользователя на interval секунд.
`savefig`	Сохранить текущую фигуру.
`show`	Отобразить все открытые фигуры.
`switch_backend`	Установить бэкенд pyplot.
`uninstall_repl_displayhook`	Отключиться от дисплейного хука текущей оболочки.

END_OF_DOCUMENT_MARKER

Другие

`connect`	Привязать функцию func к событию s.
`disconnect`	Отключить обработчик с идентификатором cid.
`findobj`	Найти объекты-артисты.
`get`	Возвратить значение свойства property объекта `Artist` или вывести все свойства.
`getp`	Возвратить значение свойства property объекта `Artist` или вывести все свойства.
`get_current_fig_manager`	Возвратить диспетчер текущего графика.
`ginput`	Блокирующий вызов для взаимодействия с графиком.
`new_figure_manager`	Создать новый экземпляр диспетчера графика.
`set_loglevel`	Настроить уровни ведения журнала Matplotlib.
`setp`	Установить одно или несколько свойств объекта `Artist` или вывести список допустимых значений.
`waitforbuttonpress`	Блокирующий вызов для взаимодействия с графиком.
`xkcd`	Включить режим рисования в стиле комикса xkcd.