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]

Основа: GridSpecBase

Сетка для размещения подграфиков в окне фигуры.

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

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

Параметры:

nrows, ncolsint: Количество строк и столбцов в сетке.
figureFigure, необязательно: Используется только для ограниченной компоновки, чтобы создать правильную сетку компоновки.
left, right, top, bottomfloat, необязательно: Границы подграфиков как часть ширины или высоты фигуры. Left не может быть больше right, а bottom не может быть больше top. Если не указано, значения будут получены из фигуры или 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.

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

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

Обратите внимание, что атрибут figure GridSpec всегда игнорируется.

locally_modified_subplot_params()[source]

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

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

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

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

Параметры:

figureFigure: Фигура.
rendererRendererBase подкласс, необязательно: Используемый рендерер.
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, необязательно: Пробел между подграфиками как часть средней ширины/высоты подграфиков.