matplotlib.pyplot

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

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)
plt.show()

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

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)
plt.show()

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

Управление Figure и Axes

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

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

Основные

`plot`	Построить график зависимости y от x в виде линий и/или маркеров.
`errorbar`	Построить график зависимости y от x в виде линий и/или маркеров с планками погрешностей.
`scatter`	Диаграмма рассеяния зависимости y от.
`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`	Добавить горизонтальную линию, проходящую через всю область Axes или её часть.
`axhspan`	Добавить горизонтальный интервал (прямоугольник) в области Axes.
`axvline`	Добавить вертикальную линию, проходящую через всю область Axes или её часть.
`axvspan`	Добавить вертикальный интервал (прямоугольник) в области Axes.
`axline`	Добавить бесконечно длинную прямую.

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

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

Статистика

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

Гистограммы

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

Контурные линии

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

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

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

Неупорядоченные треугольные сетки

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

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

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

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

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

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

`autoscale`	Автоматически масштабировать область просмотра осей по данным (переключатель).
`axis`	Удобный метод для получения или задания некоторых свойств осей.
`box`	Включить или отключить рамку Axes для текущего Axes.
`grid`	Настроить линии сетки.
`locator_params`	Управлять поведением локаторов основных делений.
`minorticks_off`	Удалить малые деления с Axes.
`minorticks_on`	Отобразить малые деления на Axes.
`rgrids`	Получить или задать радиальные линии сетки на текущем полярном графике.
`thetagrids`	Получить или задать линии сетки по углу тета на текущем полярном графике.
`tick_params`	Изменить внешний вид делений, подписей делений и линий сетки.
`ticklabel_format`	Настроить `ScalarFormatter`, используемый по умолчанию для линейных Axes.
`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`	Получить экземпляр цветовой карты; если name равен None, по умолчанию используются значения rc.
`set_cmap`	Задать цветовую карту по умолчанию и применить её к текущему изображению, если оно есть.
`imread`	Считать изображение из файла в массив.
`imsave`	Применить цветовую карту и сохранить массив в файл изображения.

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

matplotlib.pyplot.colormaps[исходный код]

Контейнер цветовых карт, известных 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[исходный код]

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

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

Для чтения используется интерфейс, подобный словарю, который сопоставляет имена со списками цветов:

import matplotlib as mpl
colors = 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`	Отключиться от хука отображения текущей оболочки.

Прочее

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