matplotlib.pyplot.subplots
-
matplotlib.pyplot.subplots(nrows=1, ncols=1, *, sharex=False, sharey=False, squeeze=True, subplot_kw=None, gridspec_kw=None, **fig_kw)[source] -
Создать рисунок и набор подграфиков.
Этот утилитарный обертка позволяет удобно создавать общие макеты подграфиков, включая объект enclosing figure, в одном вызове.
Параметры: -
nrows, ncolsint, default: 1 -
Количество строк/столбцов сетки подграфиков.
-
sharex, shareybool or {'none', 'all', 'row', 'col'}, default: False -
Управляет совместным использованием свойств между осями x (sharex) или y (sharey):
- True или 'all': оси x или y будут совместно использоваться всеми подграфиками.
- False или 'none': каждая ось x или y подграфиков будет независимой.
- 'row': каждая строка подграфиков будет совместно использовать ось x или y.
- 'col': каждый столбец подграфиков будет совместно использовать ось x или y.
Когда подграфики имеют общую ось x по столбцу, метки делений x нижнего подграфика создаются только один раз. Аналогично, когда подграфики имеют общую ось y по строке, метки делений y первого подграфика столбца создаются только один раз. Чтобы в дальнейшем включить метки делений других подграфиков, используйте
tick_params. -
squeezebool, default: True -
- Если True, лишние измерения удаляются из возвращаемого массива
Axes:- если создаётся только один подграфик (nrows=ncols=1), возвращается единственный объект Axes в качестве скаляра.
- для подграфиков Nx1 или 1xM возвращается одномерный массив numpy из объектов Axes.
- для подграфиков NxM, где N>1 и M>1, возвращается двумерный массив.
- Если False, никакого сжатия не происходит: возвращаемый объект Axes всегда является двумерным массивом, содержащим экземпляры Axes, даже если он в итоге окажется 1x1.
- Если True, лишние измерения удаляются из возвращаемого массива
-
subplot_kwdict, optional -
Словарь с ключевыми словами, передаваемыми в вызов
add_subplotдля создания каждого подграфика. -
gridspec_kwdict, optional -
Словарь с ключевыми словами, передаваемыми в конструктор
GridSpecдля создания сетки, на которой размещаются подграфики. - **fig_kw
-
Все дополнительные ключевые слова передаются в вызов
pyplot.figure.
Возвращает: -
figFigure -
axaxes.Axes or array of Axes -
ax может быть либо единственным объектом
Axes, либо массивом объектов Axes, если было создано более одного подграфика. Размеры результирующего массива можно контролировать с помощью ключевого слова squeeze, см. выше.Типичные способы обработки возвращаемого значения:
# using the variable ax for single a Axes fig, ax = plt.subplots() # using the variable axs for multiple Axes fig, axs = plt.subplots(2, 2) # using tuple unpacking for multiple Axes fig, (ax1, ax2) = plt.subplot(1, 2) fig, ((ax1, ax2), (ax3, ax4)) = plt.subplot(2, 2)
Имена
axи множественное числоaxsпредпочтительнееaxes, так как для последнего не ясно, относится ли оно к одному экземпляруAxesили к набору таких экземпляров.
Примеры
# First create some toy data: x = np.linspace(0, 2*np.pi, 400) y = np.sin(x**2) # Create just a figure and only one subplot fig, ax = plt.subplots() ax.plot(x, y) ax.set_title('Simple plot') # Create two subplots and unpack the output array immediately f, (ax1, ax2) = plt.subplots(1, 2, sharey=True) ax1.plot(x, y) ax1.set_title('Sharing Y axis') ax2.scatter(x, y) # Create four polar axes and access them through the returned array fig, axs = plt.subplots(2, 2, subplot_kw=dict(polar=True)) axs[0, 0].plot(x, y) axs[1, 1].scatter(x, y) # Share a X axis with each column of subplots plt.subplots(2, 2, sharex='col') # Share a Y axis with each row of subplots plt.subplots(2, 2, sharey='row') # Share both X and Y axes with all subplots plt.subplots(2, 2, sharex='all', sharey='all') # Note that this is the same as plt.subplots(2, 2, sharex=True, sharey=True) # Create figure number 10 with a single subplot # and clears it if it already exists. fig, ax = plt.subplots(num=10, clear=True) -
Примеры использования matplotlib.pyplot.subplots
END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER 
Перекрестие-курсор
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/matplotlib.pyplot.subplots.html
