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`	Отобразить данные как изображение, т.е. на двумерной регулярной растровой сетке.
`matshow`	Отобразить двумерный массив как матрицу в новом окне фигуры.
`pcolor`	Создать псевдоцветной график с нерегулярной прямоугольной сеткой.
`pcolormesh`	Создать псевдоцветной график с нерегулярной прямоугольной сеткой.
`spy`	Построить рисунок разреженности двумерного массива.
`figimage`	Добавить нересамплированное изображение в фигуру.

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

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

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

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

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

`barbs`	Построить двумерное поле ветровых стрелок.
`quiver`	Построить двумерное поле стрелок.
`quiverkey`	Добавить ключ к графику стрелок.
`streamplot`	Нарисовать линии потока векторного поля.

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

`autoscale`	Автомасштабирование области отображения осей по данным (переключатель).
`axis`	Удобный метод для получения или задания некоторых свойств осей.
`box`	Включение или выключение рамки области Axes.
`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`	Установка заголовка для области Axes.

Макет

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

END_OF_DOCUMENT_MARKER

Картирование цветов

`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`	Запустить цикл событий 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.