matplotlib.gridspec.GridSpec

classmatplotlib.gridspec.GridSpec(nrows, ncols, figure=None, left=None, bottom=None, right=None, top=None, wspace=None, hspace=None, width_ratios=None, height_ratios=None)[source]

Базовый класс для размещения подграфиков в пределах фигуры.

Расположение ячеек сетки определяется аналогично SubplotParams, используя left, right, top, bottom, wspace и hspace.

Индексирование экземпляра GridSpec возвращает SubplotSpec.

Параметры:

nrows, ncolsint: Количество строк и столбцов в сетке.
figureFigure, необязательно: Используется только для ограниченного макета для создания правильной сетки макета.
left, right, top, bottomfloat, необязательно: Границы подграфиков как доля ширины или высоты фигуры. Левая граница не может быть больше правой, а нижняя — больше верхней. Если не заданы, значения будут взяты из фигуры или rcParams во время отрисовки. См. также GridSpec.get_subplot_params.
wspacefloat, необязательно: Ширина отступа между подграфиками, выраженная как доля средней ширины оси. Если не задана, значения будут взяты из фигуры или rcParams при необходимости. См. также GridSpec.get_subplot_params.
hspacefloat, необязательно: Высота отступа между подграфиками, выраженная как доля средней высоты оси. Если не задана, значения будут взяты из фигуры или rcParams при необходимости. См. также GridSpec.get_subplot_params.
width_ratiosмассив-подобный список длиной ncols, необязательно: Определяет относительные ширины столбцов. Каждый столбец получает относительную ширину width_ratios[i] / sum(width_ratios). Если не задано, все столбцы будут иметь одинаковую ширину.
height_ratiosмассив-подобный список длиной nrows, необязательно: Определяет относительные высоты строк. Каждая строка получает относительную высоту height_ratios[i] / sum(height_ratios). Если не задано, все строки будут иметь одинаковую высоту.

get_subplot_params(figure=None)[source]

Возвращает SubplotParams для GridSpec.

В порядке приоритета значения берутся из

атрибутов GridSpec, отличных от None
предоставленной figure
rcParams["figure.subplot.*"]

locally_modified_subplot_params()[source]

Возвращает список имён параметров подграфиков, явно заданных в GridSpec.

Это подмножество атрибутов SubplotParams.

tight_layout(figure, renderer=None, pad=1.08, h_pad=None, w_pad=None, rect=None)[source]

Настройка параметров подграфиков для задания указанного отступа.

Параметры:

padfloat: Отступ между краем фигуры и краями подграфиков как доля размера шрифта.
h_pad, w_padfloat, необязательно: Отступ (высота/ширина) между краями соседних подграфиков. По умолчанию равно pad.
rectкортеж (left, bottom, right, top), по умолчанию: None: (left, bottom, right, top) прямоугольник в нормализованных координатах фигуры, в который будет помещена вся область подграфиков (включая метки). По умолчанию (None) — вся фигура.

update(**kwargs)[source]

Обновление параметров подграфиков сетки.

Параметры, которые не заданы явно, не меняются. Установка параметра в None сбрасывает его до rcParams["figure.subplot.*"].

Параметры:

left, right, top, bottomfloat или None, необязательно: Границы подграфиков как доля ширины или высоты фигуры.
wspace, hspacefloat, необязательно: Отступ между подграфиками как доля средней ширины/высоты подграфика.