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)[исходный код]

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

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

Параметры:

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

Подфигуры

Подфигуры

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

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

Деления оси

Деления оси