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.

Статистика

`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`	Добавление текста к области Axes.
`figtext`	Добавление текста к фигуре.
`table`	Добавление таблицы в `Axes`.
`arrow`	Добавление стрелки к области Axes.
`figlegend`	Размещение легенды на фигуре.
`legend`	Размещение легенды на области Axes.

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

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

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

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

Макет

`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)

Кроме того, есть вспомогательные функции для установки встроенных цветовых карт; например, 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`	Запустить цикл обработки событий GUI на 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.