matplotlib.pyplot.subplot

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

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

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

Возможные сигнатуры вызова:

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

Параметры:	args Либо трёхзначное целое число, либо три отдельных целых числа, описывающие положение подграфика. Если три целых числа представляют собой nrows, ncols* и index (в указанном порядке), подграфик займёт позицию index на сетке с nrows строками и ncols столбцами. index начинается с 1 в верхнем левом углу и увеличивается вправо. pos — трёхзначное целое число, где первая цифра — количество строк, вторая — количество столбцов, а третья — индекс подграфика. Например, fig.add_subplot(235) эквивалентно fig.add_subplot(2, 3, 5). Обратите внимание, что все целые числа должны быть меньше 10, чтобы этот формат работал. `projection : {None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional` Тип проекции подграфика (`Axes`). str — имя пользовательской проекции, см. `projections`. По умолчанию None соответствует 'rectilinear' проекции. `polar : boolean, optional` Если True, эквивалентно projection='polar'. `sharex, sharey : Axes, optional` Поделиться осью x или y `axis` с sharex и/или sharey. Ось будет иметь те же пределы, метки и масштаб, что и ось совмещённой оси. `label : str` Метка возвращаемой оси.
Возвращает:	`axes : an axes.SubplotBase subclass of Axes (or a subclass of Axes)` Ось подграфика. Базовый класс возвращаемой оси зависит от используемой проекции. Это `Axes` при использовании прямолинейной проекции и `projections.polar.PolarAxes` при использовании полярной проекции. Возвращённая ось — подкласс базового класса, представляющий подграфик.
Другие параметры:	**kwargs Этот метод также принимает ключевые аргументы для базового класса возвращаемой оси. Ключевые аргументы для прямолинейного базового класса `Axes` можно найти в следующей таблице, но могут быть и другие ключевые аргументы, если используется другая проекция.

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

END_OF_DOCUMENT_MARKER

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

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

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

Примеры

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)