matplotlib.gridspec.SubplotSpec

class matplotlib.gridspec.SubplotSpec(gridspec, num1, num2=None) [source]

Bases: object

Указывает расположение подграфика в GridSpec.

Примечание

Вероятнее всего, вам никогда не придётся создавать экземпляр SubplotSpec самостоятельно. Обычно вы получаете его из GridSpec с помощью доступа по индексу.

Параметры:	gridspec : GridSpec Объект GridSpec, к которому относится подграфик. num1, num2 : int Подграфик займёт ячейку с номером num1 в заданном gridspec. Если указан num2, подграфик будет занимать ячейки с номерами от num1 до num2. Индексация начинается с 0.

get_geometry(self) [source]

Возвращает геометрию подграфика в виде кортежа (n_rows, n_cols, start, stop).

Индексы start и stop определяют диапазон подграфика в GridSpec. stop является инклюзивным (т.е. для одной ячейки start == stop).

get_gridspec(self) [source]

get_position(self, figure, return_all=False) [source]

Обновляет позицию подграфика из figure.subplotpars.

get_rows_columns(self) [source]

Возвращает номера строки и столбца подграфика в виде кортежа (n_rows, n_cols, row_start, row_stop, col_start, col_stop).

get_topmost_subplotspec(self) [source]

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

subgridspec(self, nrows, ncols, **kwargs) [source]

Создаёт GridSpec внутри этого подграфика.

Созданный GridSpecFromSubplotSpec будет иметь этот SubplotSpec в качестве родителя.

Параметры:	nrows : int Количество строк в сетке. ncols : int Количество столбцов в сетке.
Возвращает:	gridspec : GridSpecFromSubplotSpec
Другие параметры:	**kwargs Все остальные параметры передаются в GridSpecFromSubplotSpec.

См. также

matplotlib.pyplot.subplots

Примеры

Добавление трёх подграфиков в пространство, занимаемое одним подграфиком:

fig = plt.figure()
gs0 = fig.add_gridspec(3, 1)
ax1 = fig.add_subplot(gs0[0])
ax2 = fig.add_subplot(gs0[1])
gssub = gs0[2].subgridspec(1, 3)
for i in range(3):
    fig.add_subplot(gssub[0, i])