Обзор 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, numpy.fft, numpy.linalg, numpy.random и некоторые дополнительные функции, все в одном пространстве имён. Первоначальной целью было имитировать способ работы 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.bezier
• matplotlib.blocking_input
• matplotlib.category
• matplotlib.cbook
• matplotlib.cm
• matplotlib.collections
• matplotlib.colorbar
• matplotlib.colors
• matplotlib.container
• matplotlib.contour
• matplotlib.dates
• matplotlib.docstring
• 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.texmanager
• matplotlib.textpath
• matplotlib.ticker
• matplotlib.tight_bbox
• matplotlib.tight_layout
• matplotlib.transforms
• matplotlib.tri
• matplotlib.type1font
• matplotlib.units
• matplotlib.widgets
• matplotlib._api
• matplotlib._enums

Инструментарии

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

• mplot3d API
• Инструментарий Matplotlib axes_grid1
• Инструментарий Matplotlib axisartist
• Инструментарий Matplotlib axes_grid