matplotlib.pyplot.subplots
-
matplotlib.pyplot.subplots(nrows=1, ncols=1, sharex=False, sharey=False, squeeze=True, subplot_kw=None, gridspec_kw=None, **fig_kw) -
Создать фигуру и набор подграфиков
Этот утилитарный обертывающий объект позволяет удобно создавать общие макеты подграфиков, включая объект фигуры, в одном вызове.
Параметры: nrows, ncols : int, необязательно, по умолчанию: 1
Количество строк/столбцов сетки подграфиков.
sharex, sharey : bool или {‘none’, ‘all’, ‘row’, ‘col’}, по умолчанию: False
Управляет совместным использованием свойств среди осей x (
sharex) или y (sharey) :- True или ‘all’: ось x или y будет общей для всех подграфиков.
- False или ‘none’: каждая ось x или y каждого подграфика будет независимой.
- ‘row’: каждая строка подграфиков будет совместно использовать ось x или y.
- ‘col’: каждый столбец подграфиков будет совместно использовать ось x или y.
Когда у подграфиков общая ось x по столбцу, метки делений оси x отображаются только у нижнего подграфика. Аналогично, когда у подграфиков общая ось y по строке, метки делений оси y отображаются только у подграфика первого столбца.
squeeze : bool, необязательно, по умолчанию: True
-
Если True, лишние измерения удаляются из возвращаемого объекта Axes:
- если создан только один подграфик (nrows=ncols=1), возвращается единственный объект Axes в качестве скаляра.
- для Nx1 или 1xN подграфиков, возвращаемый объект — одномерный массив numpy объектов Axes, возвращаются как одномерные массивы numpy.
- для NxM, подграфики с N>1 и M>1 возвращаются как двумерные массивы.
- Если False, сжатие не выполняется: возвращаемый объект Axes всегда является двумерным массивом, содержащим экземпляры Axes, даже если он оказывается 1x1.
subplot_kw : dict, необязательно
Словарь с ключевыми словами, передаваемыми в вызов
add_subplot()для создания каждого подграфика.gridspec_kw : dict, необязательно
Словарь с ключевыми словами, передаваемыми в конструктор
GridSpecдля создания сетки, на которой размещаются подграфики.**fig_kw :
Все дополнительные ключевые аргументы передаются в вызов
figure().Возвращает: fig :
matplotlib.figure.Figureобъектax : Объект Axes или массив объектов Axes.
ax может быть либо одним объектом
matplotlib.axes.Axes, либо массивом объектов Axes, если создано более одного подграфика. Размеры возвращаемого массива можно контролировать с помощью ключевого слова squeeze, см. выше.Примеры
Сначала создадим некоторые тестовые данные:
>>> x = np.linspace(0, 2*np.pi, 400) >>> y = np.sin(x**2)
Создает только фигуру и только один подграфик
>>> fig, ax = plt.subplots() >>> ax.plot(x, y) >>> ax.set_title('Simple plot')Создает два подграфика и сразу распаковывает возвращаемый массив
>>> f, (ax1, ax2) = plt.subplots(1, 2, sharey=True) >>> ax1.plot(x, y) >>> ax1.set_title('Sharing Y axis') >>> ax2.scatter(x, y)Создает четыре полярные оси и обращается к ним через возвращаемый массив
>>> fig, axes = plt.subplots(2, 2, subplot_kw=dict(polar=True)) >>> axes[0, 0].plot(x, y) >>> axes[1, 1].scatter(x, y)
Поделиться осью X со всеми столбцами подграфиков
>>> plt.subplots(2, 2, sharex='col')
Поделиться осью Y со всеми строками подграфиков
>>> plt.subplots(2, 2, sharey='row')
Поделиться осями X и Y со всеми подграфиками
>>> plt.subplots(2, 2, sharex='all', sharey='all')
Обратите внимание, что это то же самое, что и
>>> plt.subplots(2, 2, sharex=True, sharey=True)
Примеры использования matplotlib.pyplot.subplots
END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER 
© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/_as_gen/matplotlib.pyplot.subplots.html
