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, per_subplot_kw=None, **fig_kw)[source]
-
Построение макета Axes на основе ASCII-изображения или вложенных списков.
Эта вспомогательная функция предназначена для построения сложных макетов GridSpec визуально.
См. Сложное и семантическое составление фигур (subplot_mosaic) для примера и полного документации API.
- Параметры:
-
- mosaicсписок списков {хешируемых или вложенных} или строка
-
Визуальный макет того, как вы хотите разместить свои Axes, помеченные строками. Например
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_kwсловарь, необязательно
-
Словарь с ключевыми словами, передаваемыми в вызов
Figure.add_subplot, используемый для создания каждого подграфика. Эти значения могут быть переопределены значениями в per_subplot_kw. - per_subplot_kwсловарь, необязательно
-
Словарь, сопоставляющий идентификаторы Axes или кортежи идентификаторов со словарем ключевых аргументов, которые будут переданы в вызов
Figure.add_subplot, используемый для создания каждого подграфика. Значения в этих словарях имеют приоритет над значениями в subplot_kw.Если mosaic — строка, и, следовательно, все ключи — одиночные символы, можно использовать одну строку вместо кортежа в качестве ключей; т.е.
"AB"эквивалентно("A", "B").Новое в версии 3.7.
- gridspec_kwсловарь, необязательно
-
Словарь с ключевыми словами, передаваемыми конструктору
GridSpec, используемому для создания сетки, на которой размещаются подграфики. - **fig_kw
-
Все дополнительные ключевые аргументы передаются в вызов
pyplot.figure.
- Возвращает:
-
-
fig
Figure -
Новая фигура
- словарь[метка, Axes]
-
Словарь, сопоставляющий метки с объектами Axes. Порядок осей слева направо и сверху вниз соответствует их позиции в общем макете.
-
fig
Примеры использования matplotlib.pyplot.subplot_mosaic
Составление сложных и осмысленных фигур (subplot_mosaic)
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/_as_gen/matplotlib.pyplot.subplot_mosaic.html
