matplotlib.pyplot.subplot

matplotlib.pyplot.subplot(*args, **kwargs) [source]

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

Оборачивающий метод Figure.add_subplot с различиями в поведении, описанными в разделе примечаний.

Варианты вызова:

subplot(nrows, ncols, index, **kwargs)
subplot(pos, **kwargs)
subplot(**kwargs)
subplot(ax)

Параметры:	`argsint, (int, int, index), or SubplotSpec, default: (1, 1, 1)` Позиция подграфика, описываемая одним из следующих способов: Три целых числа (nrows, ncols, index). Подграфик займёт позицию index* на сетке с nrows строками и ncols столбцами. index начинается с 1 в верхнем левом углу и увеличивается вправо. index также может быть кортежем из двух элементов, определяющим (first, last) индексы подграфика (1-основанные, включая last), например, `fig.add_subplot(3, 1, (1, 2))` создаёт подграфик, занимающий верхние 2/3 фигуры. Трехзначное целое число. Цифры интерпретируются так, как если бы они были заданы по отдельности как три однозначных числа, т.е. `fig.add_subplot(235)` равно `fig.add_subplot(2, 3, 5)`. Обратите внимание, что это можно использовать только если подграфиков не более 9. Объект `SubplotSpec`. `projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional` Тип проекции подграфика (`Axes`). str — имя пользовательской проекции, см. `projections`. По умолчанию None соответствует проекции 'rectilinear'. `polarbool, default: False` Если True, эквивалентно projection='polar'. `sharex, shareyAxes, optional` Поделить ось x или y `axis` с sharex и/или sharey. Ось будет иметь те же пределы, деления и масштаб, что и ось уделяемых осей. `labelstr` Метка возвращаемой оси.
Возвращаемые значения:	`axes.SubplotBase, or another subclass of` `Axes` Ось подграфика. Базовый класс возвращаемой оси зависит от используемой проекции. Это `Axes`, если используется проекция rectilinear, и `projections.polar.PolarAxes`, если используется проекция polar. Возвращаемая ось — подкласс базового класса, предназначенного для подграфиков.
Другие параметры:	*kwargs Этот метод также принимает ключевые параметры для базового класса возвращаемой оси, за исключением аргумента figure*. Ключевые параметры для базового класса rectilinear `Axes` можно найти в следующей таблице, но могут быть и другие ключевые параметры, если используется другая проекция.

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает (m, n, 3) массив float и значение dpi, и возвращает массив (m, n, 3)
`alpha`	float или None
`anchor`	2-кортеж чисел с плавающей точкой или {'C', 'SW', 'S', 'SE', ...}
`animated`	bool
`aspect`	{'auto'} или число
`autoscale_on`	bool
`autoscalex_on`	bool
`autoscaley_on`	bool
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool или 'line'
`box_aspect`	None или число
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`contains`	неизвестно
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	bool
`gid`	строка
`in_layout`	bool
`label`	объект
`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или вызываемый объект
`position`	[left, bottom, width, height] или `Bbox`
`prop_cycle`	неизвестно
`rasterization_zorder`	число с плавающей точкой или None
`rasterized`	bool или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`title`	строка
`transform`	`Transform`
`url`	строка
`visible`	bool
`xbound`	неизвестно
`xlabel`	строка
`xlim`	(нижняя: float, верхняя: float)
`xmargin`	число больше -0.5
`xscale`	{"линейный", "логарифмический", "симлогарифмический", "логит", ...}
`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно
`ylabel`	строка
`ylim`	(нижняя: float, верхняя: float)
`ymargin`	число больше -0.5

`yscale`	{"линейный", "логарифмический", "симлогарифмический", "логит", ...}
`yticklabels`	неизвестно
`yticks`	неизвестно
`zorder`	число с плавающей точкой

См. также

Figure.add_subplot
pyplot.subplots
pyplot.axes
Figure.subplots

Примечания

Создание подграфика приведет к удалению любого существующего подграфика, который перекрывается с ним, за исключением случаев, когда они разделяют границу:

import matplotlib.pyplot as plt
# plot a line, implicitly creating a subplot(111)
plt.plot([1, 2, 3])
# now create a subplot which represents the top plot of a grid
# with 2 rows and 1 column. Since this subplot will overlap the
# first, the plot (and its axes) previously created, will be removed
plt.subplot(211)

Если этого поведения не нужно, используйте метод Figure.add_subplot или функцию pyplot.axes вместо этого.

Если в figure уже есть подграфик с ключом (args, kwargs), то он просто сделает этот подграфик текущим и вернёт его. Это поведение устарело. В то же время, если этого поведения не нужно (т.е. требуется принудительное создание нового подграфика), необходимо использовать уникальный набор args и kwargs. Для этой цели раскрыт атрибут оси label: если требуется добавить в figure два подграфика, которые в остальном идентичны, необходимо обеспечить им уникальные метки.

В редких случаях, add_subplot может быть вызван с одним аргументом — экземпляром оси подграфика, уже созданным в текущем figure, но не в списке осей figure.

Примеры

plt.subplot(221)

# equivalent but more general
ax1=plt.subplot(2, 2, 1)

# add a subplot with no frame
ax2=plt.subplot(222, frameon=False)

# add a polar subplot
plt.subplot(223, projection='polar')

# add a red subplot that shares the x-axis with ax1
plt.subplot(224, sharex=ax1, facecolor='red')

# delete ax2 from the figure
plt.delaxes(ax2)

# add ax2 to the figure again
plt.subplot(ax2)