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, необязательно: Область подграфиков как часть ширины или высоты фигуры. Left не может быть больше right, а bottom не может быть больше top. Если не указано, значения будут взяты из фигуры или 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.
recttuple (left, bottom, right, top), default: None: (left, bottom, right, top) прямоугольник в нормализованных координатах фигуры, в который поместится вся область подграфиков (включая метки). По умолчанию (None) — вся фигура.

update(**kwargs)[source]

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

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

Параметры:

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