matplotlib.gridspec.SubplotSpec

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

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

Примечание

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

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

__dict__ = mappingproxy({'__module__': 'matplotlib.gridspec', '__doc__': "\n Specifies the location of a subplot in a `GridSpec`.\n\n .. note::\n\n Likely, you'll never instantiate a `SubplotSpec` yourself. Instead you\n will typically obtain one from a `GridSpec` using item-access.\n\n Parameters\n ----------\n gridspec : `~matplotlib.gridspec.GridSpec`\n The GridSpec, which the subplot is referencing.\n num1, num2 : int\n The subplot will occupy the num1-th cell of the given\n gridspec. If num2 is provided, the subplot will span between\n num1-th cell and num2-th cell *inclusive*.\n\n The index starts from 0.\n ", '__init__': <function SubplotSpec.__init__>, '__repr__': <function SubplotSpec.__repr__>, '_from_subplot_args': <staticmethod object>, 'num2': <property object>, '__getstate__': <function SubplotSpec.__getstate__>, 'get_gridspec': <function SubplotSpec.get_gridspec>, 'get_geometry': <function SubplotSpec.get_geometry>, 'get_rows_columns': <function SubplotSpec.get_rows_columns>, 'rowspan': <property object>, 'colspan': <property object>, 'get_position': <function SubplotSpec.get_position>, 'get_topmost_subplotspec': <function SubplotSpec.get_topmost_subplotspec>, '__eq__': <function SubplotSpec.__eq__>, '__hash__': <function SubplotSpec.__hash__>, 'subgridspec': <function SubplotSpec.subgridspec>, '__dict__': <attribute '__dict__' of 'SubplotSpec' objects>, '__weakref__': <attribute '__weakref__' of 'SubplotSpec' objects>})

__eq__(self, other) [source]

Два SubplotSpec считаются равными, если они ссылаются на одну и ту же позицию(и) в одном и том же GridSpec.

__getstate__(self) [source]

__hash__(self) [source]

Возвращает хэш-значение объекта.

__init__(self, gridspec, num1, num2=None) [source]

Инициализирует объект. Подробнее см. help(type(self)).

__module__ = 'matplotlib.gridspec'

__repr__(self) [source]

Возвращает строковое представление объекта.

__weakref__

Список слабых ссылок на объект (если определён).

property colspan

Количество столбцов, занимаемых подграфиком, как объект range.

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

Примечания

Устарело начиная с версии 3.3.

get_topmost_subplotspec(self) [source]

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

property num2

property rowspan

Количество строк, занимаемых подграфиком, как объект range object.

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

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

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

Параметры:	nrowsint Количество строк в сетке. ncolsint Количество столбцов в сетке.
Возвращает:	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])

Примеры использования matplotlib.gridspec.SubplotSpec

Настройка макета фигуры с помощью GridSpec и других функций

Руководство по ограниченному размещению

Руководство по tight-layout