Обзор API

• Способы использования
  • API pyplot
  • Объектно-ориентированный API
  • API pylab (не рекомендуется)
• Модули
• Наборы инструментов

См. также Изменения в API.

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

Ниже описаны несколько распространённых подходов к построению графиков с помощью 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, numpy и некоторые дополнительные функции в одном пространстве имён. Его изначальной целью было имитирование работы в стиле MATLAB, импортируя все функции в глобальное пространство имён. В наши дни это считается плохим стилем.

Модули

Matplotlib состоит из следующих подмодулей:

• matplotlib
• matplotlib.afm
• matplotlib.animation
• matplotlib.artist
• matplotlib.axes
• matplotlib.axis
• matplotlib.backend_bases
• matplotlib.backend_managers
• matplotlib.backend_tools
• matplotlib.backends
• matplotlib.blocking_input
• matplotlib.category
• matplotlib.cbook
• matplotlib.cm
• matplotlib.collections
• matplotlib.colorbar
• matplotlib.colors
• matplotlib.container
• matplotlib.contour
• matplotlib.dates
• matplotlib.dviread
• matplotlib.figure
• matplotlib.font_manager
• matplotlib.fontconfig_pattern
• matplotlib.gridspec
• matplotlib.image
• matplotlib.legend
• matplotlib.legend_handler
• matplotlib.lines
• matplotlib.markers
• matplotlib.mathtext
• matplotlib.mlab
• matplotlib.offsetbox
• matplotlib.patches
• matplotlib.path
• matplotlib.patheffects
• matplotlib.pyplot
• matplotlib.projections
• matplotlib.projections.polar
• matplotlib.quiver
• matplotlib.rcsetup
• matplotlib.sankey
• matplotlib.scale
• matplotlib.sphinxext.plot_directive
• matplotlib.spines
• matplotlib.style
• matplotlib.table
• matplotlib.testing
• matplotlib.text
• matplotlib.textpath
• matplotlib.ticker
• matplotlib.tight_layout
• matplotlib.transforms
• matplotlib.tri
• matplotlib.type1font
• matplotlib.units
• matplotlib.widgets

Наборы инструментов

Наборы инструментов — это наборы функций, специфичных для конкретных задач, которые расширяют Matplotlib. Ниже приведены включённые наборы инструментов:

• Наборы инструментов
• API mplot3d
• Набор инструментов Matplotlib axes_grid1
• Набор инструментов Matplotlib axisartist
• Набор инструментов Matplotlib axes_grid