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) [source]

Bases: matplotlib.gridspec.GridSpecBase

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

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

Параметры:

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

__getstate__(self) [source]

__init__(self, nrows, ncols, figure=None, left=None, bottom=None, right=None, top=None, wspace=None, hspace=None, width_ratios=None, height_ratios=None) [source]

Параметры:

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

__module__ = 'matplotlib.gridspec'

get_subplot_params(self, figure=None) [source]

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

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

• не-None атрибуты GridSpec
• переданная фигура figure
• rcParams["figure.subplot.*"]

locally_modified_subplot_params(self) [source]

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

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

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

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

Параметры:

padfloat Отступ между краем фигуры и краями подграфиков в долях размера шрифта. h_pad, w_padfloat, optional Отступ (высота/ширина) между краями смежных подграфиков. По умолчанию совпадает с pad. recttuple of 4 floats, default: (0, 0, 1, 1), i.e. the whole figure (левый, нижний, правый, верхний) прямоугольник в нормированных координатах фигуры, в который будет вписана вся область подграфиков (включая подписи).

update(self, **kwargs) [source]

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

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

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

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

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

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

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

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

Изменение размера осей с помощью constrained layout

Изменение размера осей с помощью tight layout

Объединение двух подграфиков с помощью subplots и GridSpec

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

Вложенные Gridspec

Создание нескольких подграфиков с помощью plt.subplots

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

Вложенные GridSpec

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

Руководство по constrained Layout

Руководство по Tight Layout

origin и extent в imshow