matplotlib.figure.Figure.subplots

Figure.subplots(nrows=1, ncols=1, *, sharex=False, sharey=False, squeeze=True, width_ratios=None, height_ratios=None, subplot_kw=None, gridspec_kw=None)[исходный код]

Добавляет к этой фигуре набор подграфиков.

Эта вспомогательная обёртка позволяет удобно создавать распространённые компоновки подграфиков одним вызовом.

Параметры:

nrows, ncolsint, по умолчанию: 1

Количество строк/столбцов в сетке подграфиков.

sharex, shareybool или {'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 создаются только у подграфика в первом столбце. Чтобы впоследствии включить подписи делений у других подграфиков, используйте tick_params.

Если подграфики используют общую ось с единицами измерения, вызов Axis.set_units обновит единицы измерения каждой оси.

Обратите внимание, что отменить совместное использование осей невозможно.

squeezebool, по умолчанию: True

Если True, из возвращаемого массива Axes удаляются лишние измерения:
- если создан только один подграфик (nrows=ncols=1), единственный объект Axes возвращается как скаляр.
- для подграфиков Nx1 или 1xM возвращается одномерный массив объектов numpy, содержащий объекты Axes.
- для подграфиков NxM, где N>1 и M>1, возвращается двумерный массив.
Если False, сжатие не выполняется: возвращаемый объект Axes всегда представляет собой двумерный массив экземпляров Axes, даже если его размер равен 1x1.

width_ratiosмассивоподобный объект длины ncols, необязательно

Задаёт относительную ширину столбцов. Относительная ширина каждого столбца равна width_ratios[i] / sum(width_ratios). Если значение не задано, все столбцы будут иметь одинаковую ширину. Эквивалентно gridspec_kw={'width_ratios': [...]}.

height_ratiosмассивоподобный объект длины nrows, необязательно

Задаёт относительную высоту строк. Относительная высота каждой строки равна height_ratios[i] / sum(height_ratios). Если значение не задано, все строки будут иметь одинаковую высоту. Эквивалентно gridspec_kw={'height_ratios': [...]}.

subplot_kwdict, необязательно

Словарь с именованными аргументами, передаваемыми в вызов Figure.add_subplot, используемый для создания каждого подграфика.

gridspec_kwdict, необязательно

Словарь с именованными аргументами, передаваемыми конструктору GridSpec, который используется для создания сетки, в которой размещаются подграфики.

Возвращает:

Axes или массив объектов Axes: Один объект Axes или массив объектов Axes, если создано более одного подграфика. Размерности результирующего массива можно задать с помощью ключевого аргумента squeeze, см. выше.

См. также

pyplot.subplots
Figure.add_subplot
pyplot.subplot

Примеры

# First create some toy data:
x = np.linspace(0, 2*np.pi, 400)
y = np.sin(x**2)

# Create a figure
fig = plt.figure()

# Create a subplot
ax = fig.subplots()
ax.plot(x, y)
ax.set_title('Simple plot')

# Create two subplots and unpack the output array immediately
ax1, ax2 = fig.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
axes = fig.subplots(2, 2, subplot_kw=dict(projection='polar'))
axes[0, 0].plot(x, y)
axes[1, 1].scatter(x, y)

# Share an X-axis with each column of subplots
fig.subplots(2, 2, sharex='col')

# Share a Y-axis with each row of subplots
fig.subplots(2, 2, sharey='row')

# Share both X- and Y-axes with all subplots
fig.subplots(2, 2, sharex='all', sharey='all')

# Note that this is the same as
fig.subplots(2, 2, sharex=True, sharey=True)

Примеры использования `matplotlib.figure.Figure.subplots`

Масштаб Asinh

Мишень левого желудочка

Накопленные распределения

Режим поворота текста

Селекторы прямоугольника и эллипса

Сложная и семантическая компоновка фигуры (subplot_mosaic)

matplotlib.figure.Figure.subplots

Примеры

Примеры использования matplotlib.figure.Figure.subplots

Примеры использования `matplotlib.figure.Figure.subplots`