matplotlib.gridspec.GridSpec

class matplotlib.gridspec.GridSpec(nrows, ncols, figure=None, left=None, bottom=None, right=None, top=None, wspace=None, hspace=None, width_ratios=None, height_ratios=None) [исходный код]

Базовые классы: matplotlib.gridspec.GridSpecBase

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

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

Параметры:

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

get_subplot_params(self, figure=None) [исходный код]

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

Значения берутся в следующем порядке приоритета:

• атрибуты GridSpec, отличные от None
• указанная figure
• rcParams["figure.subplot.*"]

locally_modified_subplot_params(self) [исходный код]

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

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

tight_layout(self, figure, renderer=None, pad=1.08, h_pad=None, w_pad=None, rect=None) [исходный код]

Настраивает параметры подграфиков, чтобы задать указанные отступы.

Параметры:

padfloat Отступ между краем фигуры и краями подграфиков в долях размера шрифта. h_pad, w_padfloat, optional Отступ (высота/ширина) между краями соседних подграфиков. По умолчанию равен pad. recttuple of 4 floats, optional Прямоугольная область (left, bottom, right, top) в нормализованных координатах фигуры, в которую должна поместиться вся область подграфиков (включая подписи). По умолчанию — (0, 0, 1, 1).

update(self, **kwargs) [исходный код]

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

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

Параметры:	left, right, top, bottomfloat or None, optional Размер области подграфиков в долях ширины или высоты фигуры. wspace, hspacefloat, optional Расстояние между подграфиками в долях средней ширины / высоты подграфика.

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

Демонстрация PSD

Диаграмма рассеяния с гистограммами

Потоковая диаграмма

Выравнивание меток

Изменение размера осей с помощью ограниченного макета

Изменение размера осей с помощью плотного макета

Комбинирование двух подграфиков с использованием subplots и GridSpec

Использование Gridspec для создания макетов подграфиков с несколькими столбцами/строками

Вложенные Gridspec

Демонстрация GridSpec

Вложенные GridSpecs

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

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

Руководство по компактному макету

Начальная точка и область в imshow