matplotlib.figure.SubFigure.add_subplot

SubFigure.add_subplot(*args, **kwargs)[source]

Добавляет Axes в фигуру как часть компоновки подграфиков.

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

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

Параметры:

*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.

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

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

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

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

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

axes_classподкласс типа Axes, необязательный

Создаваемый подкласс axes.Axes. Этот параметр несовместим с projection и polar. Примеры см. в разделе axisartist.

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

Общая ось x или y axis задаётся с помощью 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_axes

pyplot.subplot

pyplot.axes

Figure.subplots

pyplot.subplots

Примеры

fig = plt.figure()

fig.add_subplot(231)
ax1 = fig.add_subplot(2, 3, 1)  # equivalent but more general

fig.add_subplot(232, frameon=False)  # subplot with no frame
fig.add_subplot(233, projection='polar')  # polar subplot
fig.add_subplot(234, sharex=ax1)  # subplot sharing x-axis with ax1
fig.add_subplot(235, facecolor="red")  # red subplot

ax1.remove()  # delete ax1 from the figure
fig.add_subplot(ax1)  # add ax1 back to the figure