matplotlib.figure.Figure.add_subplot

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

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

projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional

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

polarbool, default: False

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

axes_classподкласс Axes, optional

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

sharex, shareyAxes, optional

Поделиться осью 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`	скаляр или 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`
`forward_navigation_events`	bool или "auto"
`frame_on`	bool
`gid`	str
`in_layout`	bool
`label`	объект
`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`	(нижняя: float, верхняя: float)
`xlabel`	str
`xlim`	(левая: float, правая: float)
`xmargin`	float больше -0.5
`xscale`	неизвестно

`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	(нижняя: float, верхняя: float)
`ylabel`	строка
`ylim`	(нижняя: float, верхняя: float)
`ymargin`	число больше -0,5
`yscale`	неизвестно
`yticklabels`	неизвестно
`yticks`	неизвестно
`zorder`	число с плавающей точкой

См. также

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