matplotlib.figure.SubFigure.subplots

SubFigure.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_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.SubFigure.subplots

Подфигуры фигуры

Подфигуры фигуры

Форматирование меток деления

Форматирование меток деления

Метки делений оси

Метки делений оси