matplotlib.pyplot.subplot

matplotlib.pyplot.subplot(*args, **kwargs)[исходный код]

Добавляет Axes к текущей фигуре или возвращает существующий Axes.

Это обёртка для Figure.add_subplot, которая добавляет дополнительное поведение при работе с неявным API (см. раздел примечаний).

Сигнатуры вызова:

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

Параметры:

*argsint, (int, int, index), или SubplotSpec, по умолчанию: (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 фигуры.
Целое число из 3 цифр. Цифры интерпретируются так, как если бы они были переданы отдельно в виде трёх однозначных целых чисел, то есть fig.add_subplot(235) — это то же самое, что fig.add_subplot(2, 3, 5). Обратите внимание, что этот способ можно использовать только при наличии не более 9 подграфиков.
SubplotSpec.

projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, необязательный

Тип проекции подграфика (Axes). str — название пользовательской проекции, см. projections. Значение None по умолчанию соответствует проекции 'rectilinear'.

polarbool, по умолчанию: False

Если True, эквивалентно projection='polar'.

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

Общий axis x или y задаётся с помощью sharex и/или sharey. У оси будут те же пределы, деления и масштаб, что и у оси общего Axes.

labelstr

Метка возвращаемого Axes.

Возвращает:

Axes: Axes подграфика. Возвращённый Axes на самом деле может быть экземпляром подкласса, например projections.polar.PolarAxes для полярных проекций.

Другие параметры:

**kwargs

Этот метод также принимает именованные аргументы базового класса возвращаемого Axes, за исключением аргумента figure. Именованные аргументы базового класса для прямоугольной системы координат Axes приведены в следующей таблице, однако при использовании другой проекции могут быть доступны и другие именованные аргументы.

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

См. также

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

Примечания

Изменено в версии 3.8: В версиях до 3.8 любой существующий Axes, перекрывающийся с новым Axes не только по границе, удалялся. В более новых версиях удаление больше не выполняется. При необходимости используйте явный вызов Axes.remove.

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

Если kwargs не переданы и в положении, заданном аргументом args, уже существует Axes, будет возвращён этот Axes, а не создан новый.

Если переданы kwargs и в положении, заданном аргументом args, уже существует Axes с таким же типом проекции, а значения kwargs совпадают с параметрами существующего Axes, будет возвращён существующий Axes. В противном случае будет создан новый Axes с указанными параметрами. Для этого сравнения сохраняется ссылка на kwargs. Если какие-либо значения в kwargs изменяемы, изменения этих значений не будут обнаружены. В таких случаях рекомендуется использовать Figure.add_subplot и явный API Axes вместо неявного API pyplot.

Примеры

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)

# make the first Axes "current" again
plt.subplot(221)