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)[исходный код]
-
Базовые классы:
GridSpecBaseСетка для размещения подграфиков на рисунке.
Расположение ячеек сетки определяется аналогично
SubplotParamsс использованием параметров left, right, top, bottom, wspace и hspace.Индексация экземпляра GridSpec возвращает
SubplotSpec.- Параметры:
-
- nrows, ncolsint
-
Количество строк и столбцов сетки.
-
figure
Figure, необязательный -
Используется только при ограниченном макете для создания подходящей сетки макета.
- 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)[исходный код]
-
Возвращает
SubplotParamsдля GridSpec.Значения берутся в следующем порядке приоритета:
- атрибуты GridSpec, не равные None
- переданный figure
rcParams["figure.subplot.*"]
Обратите внимание: атрибут
figureобъекта GridSpec всегда игнорируется.
- locally_modified_subplot_params()[исходный код]
-
Возвращает список имен параметров подграфиков, явно заданных в GridSpec.
Это подмножество атрибутов
SubplotParams.
- tight_layout(figure, renderer=None, pad=1.08, h_pad=None, w_pad=None, rect=None)[исходный код]
-
Настраивает параметры подграфиков, чтобы задать указанные отступы.
- Параметры:
-
-
figure
Figure -
Рисунок.
-
rendererподкласс
RendererBase, необязательный -
Используемый рендерер.
- padfloat
-
Отступ между краем рисунка и краями подграфиков в долях размера шрифта.
- h_pad, w_padfloat, необязательный
-
Отступ (по высоте/ширине) между краями соседних подграфиков. По умолчанию равен pad.
- rectкортеж (left, bottom, right, top), по умолчанию: None
-
Прямоугольная область (left, bottom, right, top) в нормализованных координатах рисунка, в которую должны поместиться все подграфики (включая подписи). По умолчанию (None) используется весь рисунок.
-
figure
- update(**kwargs)[исходный код]
-
Обновляет параметры подграфиков сетки.
Параметры, которые не указаны явно, не изменяются. При установке параметра в None он сбрасывается до
rcParams["figure.subplot.*"].- Параметры:
-
- left, right, top, bottomfloat или None, необязательный
-
Границы подграфиков как доля ширины или высоты рисунка.
- wspace, hspacefloat, необязательный
-
Расстояние между подграфиками как доля средней ширины/высоты подграфика.
Примеры использования matplotlib.gridspec.GridSpec
Изменение размеров областей Axes с ограниченным макетом
Изменение размеров областей Axes с помощью tight layout
Объединение двух подграфиков с помощью subplots и GridSpec
GridSpec для макетов подграфиков с несколькими столбцами и строками
Создание нескольких подграфиков с помощью plt.subplots
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.gridspec.GridSpec.html