matplotlib.pyplot.subplots

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

Создаёт фигуру и набор подграфиков.

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

Параметры:

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, необязательный

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

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

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

**fig_kw

Все дополнительные именованные аргументы передаются вызову pyplot.figure.

Возвращает:

figFigure

axAxes или массив объектов 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.subplots(1, 2)
fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2)

Предпочтительно использовать имена ax и форму множественного числа axs вместо axes, поскольку в последнем случае неясно, относится ли оно к одному экземпляру Axes или к их коллекции.

matplotlib.pyplot.subplots

Примеры

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

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