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