Обзор 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.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_layout
• matplotlib.transforms
• matplotlib.tri
• matplotlib.type1font
• matplotlib.units
• matplotlib.widgets

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

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

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