matplotlib.pyplot.subplot

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

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

Это обёртка для 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 фигуры.
Трехзначное целое число. Цифры интерпретируются так, как если бы они были заданы отдельно как три однозначных целых числа, т.е. 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, по умолчанию: False

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

sharex, shareyAxes, optional

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

labelstr

Метка возвращаемой оси.

Возвращаемое значение:

axes.SubplotBase, или другой подкласс Axes: Ось подграфика. Возвращаемый базовый класс оси зависит от используемой проекции. Это Axes, если используется проекция rectilinear, и projections.polar.PolarAxes, если используется проекция polar. Возвращённая ось является подклассом базового класса подграфика.

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

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

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	скаляр или None
`anchor`	(число, число) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	логическое значение
`aspect`	{'auto', 'equal'} или число
`autoscale_on`	логическое значение
`autoscalex_on`	неизвестно
`autoscaley_on`	неизвестно
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	логическое значение или 'line'
`box_aspect`	число или None
`clip_box`	`Bbox`
`clip_on`	логическое значение
`clip_path`	Patch или (Path, Transform) или None
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	логическое значение
`gid`	строка
`in_layout`	логическое значение
`label`	объект
`mouseover`	логическое значение
`navigate`	логическое значение
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или логическое значение или число с плавающей точкой или вызываемый объект
`position`	[левое, нижнее, ширина, высота] или `Bbox`
`prop_cycle`	неизвестно
`rasterization_zorder`	число с плавающей точкой или None
`rasterized`	логическое значение
`sketch_params`	(масштаб: число, длина: число, случайность: число)
`snap`	логическое значение или None
`title`	строка
`transform`	`Transform`
`url`	строка
`visible`	логическое значение
`xbound`	неизвестно
`xlabel`	строка
`xlim`	(нижнее: число, верхнее: число)
`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

Примечания

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

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 вместо этого.

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

Если переданы kwargs и существует Axes в указанном args расположении, тип проекции совпадает, а 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)