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) для объяснения компромиссов между неявным и явным интерфейсами.

Команды построения графиков

`acorr`	Постройте автокорреляцию x.
`angle_spectrum`	Постройте спектр углов.
`annotate`	Добавьте аннотацию к точке xy с текстом text.
`arrow`	Добавьте стрелку на ось.
`autoscale`	Автоматически масштабировать область оси по данным (переключатель).
`axes`	Добавьте ось к текущей фигуре и сделайте её текущей осью.
`axhline`	Добавьте горизонтальную линию через ось.
`axhspan`	Добавьте горизонтальный отрезок (прямоугольник) через ось.
`axis`	Удобный метод для получения или установки некоторых свойств оси.
`axline`	Добавьте бесконечно длинную прямую линию.
`axvline`	Добавьте вертикальную линию через ось.
`axvspan`	Добавьте вертикальный отрезок (прямоугольник) через ось.
`bar`	Создайте столбиковую диаграмму.
`bar_label`	Подпишите столбиковую диаграмму.
`barbs`	Постройте 2D поле стрелок.
`barh`	Создайте горизонтальную столбиковую диаграмму.
`box`	Включить или выключить рамку оси на текущей оси.
`boxplot`	Постройте диаграмму размаха.
`broken_barh`	Постройте горизонтальную последовательность прямоугольников.
`cla`	Очистить текущую ось.
`clabel`	Подпишите контурный график.
`clf`	Очистить текущую фигуру.
`clim`	Установить пределы цветов текущего изображения.
`close`	Закрыть окно фигуры.
`cohere`	Постройте когерентность между x и y.
`colorbar`	Добавьте цветовую шкалу к графику.
`contour`	Постройте линии контура.
`contourf`	Постройте заполненные контуры.
`csd`	Постройте кросс-спектральную плотность.
`delaxes`	Удалить `Axes` (по умолчанию текущая ось) из её фигуры.
`draw`	Перерисовать текущую фигуру.
`draw_if_interactive`	Перерисовать текущую фигуру, если режим интерактивный.
`errorbar`	Построить график y по x с линиями и/или маркерами с присоединёнными погрешностями.
`eventplot`	Построить идентичные параллельные линии в заданных позициях.
`figimage`	Добавить нересамплированное изображение в фигуру.
`figlegend`	Разместить легенду на фигуре.
`fignum_exists`	Возвращает, существует ли фигура с заданным идентификатором.
`figtext`	Добавить текст к фигуре.
`figure`	Создать новую фигуру или активировать существующую.
`fill`	Построить заполненные многоугольники.
`fill_between`	Заполнить область между двумя горизонтальными кривыми.
`fill_betweenx`	Заполнить область между двумя вертикальными кривыми.
`findobj`	Найти объекты художника.
`gca`	Получить текущую ось.
`gcf`	Получить текущую фигуру.
`gci`	Получить текущий цветной элемент.
`get`	Возвращает значение свойства `Artist` или выводит все из них.
`get_cmap`	Получить экземпляр цветовой карты, по умолчанию используя значения rc, если name равно None.

`get_figlabels`	Возвращает список существующих меток фигур.
`get_fignums`	Возвращает список существующих номеров фигур.
`getp`	Возвращает значение свойства `Artist` или печатает все свойства.
`grid`	Настраивает линии сетки.
`hexbin`	Создаёт 2D-диаграмму гексагонального разбиения точек x, y.
`hist`	Вычисляет и строит гистограмму.
`hist2d`	Создаёт 2D-гистограмму.
`hlines`	Строит горизонтальные линии по каждой y от xmin до xmax.
`imread`	Считывает изображение из файла в массив.
`imsave`	Сохраняет массив как файл изображения.
`imshow`	Отображает данные как изображение на 2D-растре.
`install_repl_displayhook`	Подключается к дисплейному обработчику текущей оболочки.
`ioff`	Отключает интерактивный режим.
`ion`	Включает интерактивный режим.
`isinteractive`	Возвращает, обновляются ли графики после каждой команды построения.
`legend`	Размещает легенду на оси.
`locator_params`	Управляет поведением основных разместителей тиков.
`loglog`	Создаёт график с логарифмической шкалой по обеим осям (x и y).
`magnitude_spectrum`	Строит спектр амплитуд.
`margins`	Устанавливает или получает отступы автомасштабирования.
`matshow`	Отображает массив как матрицу в новом окне фигуры.
`minorticks_off`	Удаляет мелкие деления с осей.
`minorticks_on`	Отображает мелкие деления на осях.
`pause`	Выполняет цикл обработки событий GUI в течение interval секунд.
`pcolor`	Создаёт псевдоцветной график с нерегулярной прямоугольной сеткой.
`pcolormesh`	Создаёт псевдоцветной график с нерегулярной прямоугольной сеткой.
`phase_spectrum`	Строит спектр фаз.
`pie`	Строит круговую диаграмму.
`plot`	Строит график y от x в виде линий и/или маркеров.
`plot_date`	[Не рекомендуется] Строит график, принуждая ось рассматривать числа с плавающей точкой как даты.
`polar`	Создаёт полярный график.
`psd`	Строит спектр мощности.
`quiver`	Строит 2D поле стрелок.
`quiverkey`	Добавляет ключ к графику стрелок.
`rc`	Устанавливает текущие `rcParams`. group — группа для rc, например, для `lines.linewidth` группа — `lines`, для `axes.facecolor`, группа — `axes`, и так далее. Группа также может быть списком или кортежем имён групп, например, (xtick, ytick). kwargs — словарь пар имя/значение атрибута, например::.
`rc_context`	Возвращает контекстный менеджер для временного изменения rcParams.
`rcdefaults`	Восстанавливает `rcParams` из внутреннего стиля по умолчанию Matplotlib.
`rgrids`	Получить или установить радиальные линии сетки на текущем полярном графике.
`savefig`	Сохраняет текущую фигуру.
`sca`	Устанавливает текущую ось на ax и текущую фигуру на родителя ax.
`scatter`	Диаграмма рассеяния y от x.
`sci`	Устанавливает текущее изображение.
`semilogx`	Строит график с логарифмической шкалой по оси x.
`semilogy`	Строит график с логарифмической шкалой по оси y.

`set_cmap`	Установить цветовую карту по умолчанию и применить её к текущему изображению, если таковое имеется.
`set_loglevel`	Установить уровень корневого логгера и корневого обработчика логов Matplotlib, создавая обработчик, если он ещё не существует.
`setp`	Установить одну или несколько свойств `Artist` или список допустимых значений.
`show`	Отобразить все открытые фигуры.
`specgram`	Построить спектrogram.
`spy`	Построить схему разреженности двумерного массива.
`stackplot`	Нарисовать график с накопленными областями.
`stairs`	График ступенчатой функции как линия с граничными границами или заполненный график.
`stem`	Создать график stem.
`step`	Создать график step.
`streamplot`	Нарисовать линии потока векторного поля.
`subplot`	Добавить Axes к текущей фигуре или получить существующий Axes.
`subplot2grid`	Создать subplot в заданном месте внутри регулярной сетки.
`subplot_mosaic`	Создать макет Axes на основе ASCII-искусства или вложенных списков.
`subplot_tool`	Открыть окно инструмента subplot для фигуры.
`subplots`	Создать фигуру и набор подграфиков.
`subplots_adjust`	Настроить параметры расположения подграфиков.
`suptitle`	Добавить центральный заголовок ко всей фигуре.
`switch_backend`	Закрыть все открытые фигуры и установить бэкэнд Matplotlib.
`table`	Добавить таблицу в `Axes`.
`text`	Добавить текст в Axes.
`thetagrids`	Получить или установить линии сетки по углу на текущем полярном графике.
`tick_params`	Изменить внешний вид делений, меток делений и линий сетки.
`ticklabel_format`	Настроить `ScalarFormatter`, используемый по умолчанию для линейных Axes.
`tight_layout`	Настроить отступы между и вокруг подграфиков.
`title`	Установить заголовок для Axes.
`tricontour`	Нарисовать линии контура на неструктурированной треугольной сетке.
`tricontourf`	Нарисовать области контура на неструктурированной треугольной сетке.
`tripcolor`	Создать псевдоцветной график неструктурированной треугольной сетки.
`triplot`	Нарисовать неструктурированную треугольную сетку как линии и/или маркеры.
`twinx`	Создать и вернуть второй axes, который совместно использует ось x.
`twiny`	Создать и вернуть второй axes, который совместно использует ось y.
`uninstall_repl_displayhook`	Отключиться от дисплейного хука текущей оболочки.
`violinplot`	Создать график скрипичной диаграммы.
`vlines`	Построить вертикальные линии в каждой точке x от ymin до ymax.
`xcorr`	Построить взаимную корреляцию между x и y.
`xkcd`	Включить режим рисования в стиле комиксов xkcd.
`xlabel`	Установить метку для оси x.
`xlim`	Получить или установить пределы оси x текущего графика.
`xscale`	Установить масштаб оси x.
`xticks`	Получить или установить текущие метки делений и подписи оси x.
`ylabel`	Установить метку для оси y.
`ylim`	Получить или установить пределы оси y текущего графика.
`yscale`	Установить масштаб оси y.

END_OF_DOCUMENT_MARKER

yticks

Получение или установка текущих меток и подписей на оси Y.

Другие команды

`connect`	Связывает функцию func с событием s.
`disconnect`	Отсоединяет обработчик с идентификатором cid.
`get_current_fig_manager`	Возвращает менеджер текущей фигуры.
`ginput`	Блокирующий вызов для взаимодействия с фигурой.
`new_figure_manager`	Создаёт новый экземпляр менеджера фигур.
`waitforbuttonpress`	Блокирующий вызов для взаимодействия с фигурой.

Цветовые карты

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

matplotlib.pyplot.colormaps[source]

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

Экспериментальная версия

Хотя мы ожидаем, что API будет окончательным, мы формально маркируем его как экспериментальный для версии 3.5, потому что хотим сохранить возможность адаптировать API для версии 3.6, если возникнет необходимость.

Универсальный экземпляр реестра — 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'])