Ссылка на API

При использовании библиотеки, как правило, создаются объекты Figure и Axes, и вызываются их методы для добавления содержимого и изменения внешнего вида.

matplotlib.figure: создание осей, содержимое уровня Figure
matplotlib.axes: большинство методов построения графиков, метки осей Axes, доступ к стилизации осей и т. д.

Пример: Мы создаём объект Figure fig и Axes ax. Затем мы вызываем методы на них, чтобы построить данные, добавить метки осей и заголовок Figure.

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 4, 0.05)
y = np.sin(x*np.pi)

fig, ax = plt.subplots(figsize=(3,2), constrained_layout=True)
ax.plot(x, y)
ax.set_xlabel('t [s]')
ax.set_ylabel('S [V]')
ax.set_title('Sine wave')
fig.set_facecolor('lightsteelblue')

(Исходный код, png, pdf)

Модули

Алфавитный список модулей:

END_OF_DOCUMENT_MARKER

Способы использования

Ниже описаны несколько распространённых подходов к построению графиков с помощью Matplotlib.

API pyplot

matplotlib.pyplot — это набор функций, которые позволяют Matplotlib работать как MATLAB. Каждая функция pyplot вносит изменения в рисунок: например, создаёт рисунок, создаёт область построения на рисунке, строит линии в области построения, оформляет график подписями и т. д.

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

Дополнительные материалы:

Справочник по функции matplotlib.pyplot
Учебник по Pyplot
Примеры использования Pyplot

Объектно-ориентированный API

В основе Matplotlib лежит объектно-ориентированный подход. Мы рекомендуем работать непосредственно с объектами, если вам нужен больший контроль и настройка ваших графиков.

Во многих случаях вы создадите Figure и один или несколько Axes с помощью pyplot.subplots, и после этого будете работать только с этими объектами. Однако также возможно создавать Figure явно (например, при их включении в приложения с графическим интерфейсом).

Дополнительные материалы:

matplotlib.axes.Axes и matplotlib.figure.Figure для обзора

функций построения графиков.
Большинство примеров используют объектно-ориентированный подход

(за исключением раздела pyplot)

API pylab (не рекомендуется)

Предупреждение

Поскольку сильное импортирование в глобальное пространство имён может привести к неожиданному поведению, использование pylab настоятельно не рекомендуется. Используйте matplotlib.pyplot вместо этого.

pylab — модуль, который включает matplotlib.pyplot, numpy, numpy.fft, numpy.linalg, numpy.random и некоторые дополнительные функции, все в одном пространстве имён. Изначально он был предназначен для имитации работы в стиле MATLAB, импортируя все функции в глобальное пространство имён. Сейчас это считается плохим стилем.