matplotlib.pyplot.subplot_mosaic
- matplotlib.pyplot.subplot_mosaic(mosaic, *, sharex=False, sharey=False, width_ratios=None, height_ratios=None, empty_sentinel='.', subplot_kw=None, gridspec_kw=None, **fig_kw)[source]
-
Построение макета Осей на основе ASCII-искусства или вложенных списков.
Это вспомогательная функция для построения сложных макетов GridSpec визуально.
Примечание
Этот API предварительной версии и может быть пересмотрен в будущем на основе ранней обратной связи пользователей.
См. Сложное и семантическое составление фигур для примера и полной документации API
- Параметры:
-
- mosaicсписок списков {хешируемых или вложенных} или строка
-
Визуальное представление того, как вы хотите расположить свои оси, помеченные строками. Например
x = [['A panel', 'A panel', 'edge'], ['C panel', '.', 'edge']]производит 4 оси:
- 'A panel', который имеет высоту 1 строки и занимает первые два столбца
- 'edge', который имеет высоту 2 строки и находится на правом краю
- 'C panel', который имеет ширину 1 строка и 1 столбец в левом нижнем углу
- пустое место шириной 1 строка и 1 столбец в нижнем центре
Любой элемент в макете может быть списком списков той же формы для создания вложенных макетов.
Если вход является строкой, то она должна иметь вид
''' AAE C.E '''
где каждый символ является столбцом, а каждая строка — строкой. Это позволяет только меткам осей с одиночными символами и не позволяет вложения, но очень кратко.
- sharex, shareybool, по умолчанию: False
-
Если True, ось x (sharex) или ось y (sharey) будут общими для всех подграфиков. В этом случае поведение метки тиков и единиц осей соответствует поведению
subplots. Если False, каждая ось x или y подграфика будет независимой. - width_ratiosмассив-подобный длины ncols, необязательно
-
Определяет относительные ширины столбцов. Каждый столбец получает относительную ширину
width_ratios[i] / sum(width_ratios). Если не задано, все столбцы будут иметь одинаковую ширину. Удобство дляgridspec_kw={'width_ratios': [...]}. - height_ratiosмассив-подобный длины nrows, необязательно
-
Определяет относительные высоты строк. Каждая строка получает относительную высоту
height_ratios[i] / sum(height_ratios). Если не задано, все строки будут иметь одинаковую высоту. Удобство дляgridspec_kw={'height_ratios': [...]}. - empty_sentinelобъект, необязательно
-
Элемент в макете, означающий "оставить это место пустым". По умолчанию
'.'. Обратите внимание, что если layout — строка, она обрабатывается с помощьюinspect.cleandocдля удаления начальных пробелов, что может помешать использованию пробелов в качестве пустого ограничителя. - subplot_kwdict, необязательно
-
Словарь с ключевыми словами, передаваемыми в вызов
Figure.add_subplot, используемый для создания каждого подграфика. - gridspec_kwdict, необязательно
-
Словарь с ключевыми словами, передаваемыми конструктору
GridSpec, используемому для создания сетки, на которой размещаются подграфики. - **fig_kw
-
Все дополнительные ключевые аргументы передаются в вызов
pyplot.figure.
- Возвращает:
-
-
fig
Figure -
Новая фигура
- dict[метка, Ось]
-
Словарь, сопоставляющий метки с объектами Оси. Порядок осей слева направо и сверху вниз от их позиции в общем макете.
-
fig
Примеры использования matplotlib.pyplot.subplot_mosaic
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.6.0/api/_as_gen/matplotlib.pyplot.subplot_mosaic.html