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]

Bases: GridSpecBase

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

Расположение ячеек сетки определяется аналогично 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_ratiosarray-like длиной ncols, необязательно: Определяет относительные ширины столбцов. Каждый столбец получает относительную ширину width_ratios[i] / sum(width_ratios). Если не указано, все столбцы будут иметь одинаковую ширину.
height_ratiosarray-like длиной 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, необязательно: Интервал между подграфиками как доля средней ширины/высоты подграфика.