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)[source]

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

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

Параметры:

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_kwсловарь, необязательно

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

gridspec_kwсловарь, необязательно

Словарь со словами-ключевыми параметрами, передаваемыми в конструктор 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

Модель левого желудочка (bullseye)

Выбор прямоугольников и эллипсов

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

matplotlib.figure.Figure.subplots

Примеры

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

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