matplotlib.figure.Figure.subplot_mosaic

Figure.subplot_mosaic(mosaic, *, sharex=False, sharey=False, width_ratios=None, height_ratios=None, empty_sentinel='.', subplot_kw=None, per_subplot_kw=None, gridspec_kw=None)[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
'''

где каждый символ — это столбец, а каждая строка — это строка. Или это может быть строка с одной строкой, где строки разделены ;:

'AB;CC'

Нотация строки допускает только метки осей с одним символом и не поддерживает вложенность, но очень краткая.

Идентификаторы осей могут быть str или неитерируемым хешируемым объектом (например, tuple не могут быть использованы).

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': [...]}. В случае вложенных макетов этот аргумент применяется только к внешнему макету.

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, используемому для создания сетки, на которой размещаются подграфики. В случае вложенных макетов этот аргумент применяется только к внешнему макету. Для более сложных макетов пользователи должны использовать Figure.subfigures для создания вложенности.

empty_sentinelобъект, необязательно

Элемент в макете, означающий "оставьте это место пустым". По умолчанию '.'. Обратите внимание, что если layout — строка, она обрабатывается через inspect.cleandoc для удаления начальных пробелов, которые могут помешать использовать пробелы в качестве пустого маркера.

Возвращает:

dict[метка, ось]: Словарь, сопоставляющий метки объектам осей. Порядок осей слева направо и сверху вниз от их позиции в общем макете.

Примеры использования `matplotlib.figure.Figure.subplot_mosaic`

Представления спектра

Демонстрация стрелок

Подписи к подграфикам

Демонстрация штриховки

Сложное и семантическое композирование фигур (subplot_mosaic)

matplotlib.figure.Figure.subplot_mosaic

Примеры использования matplotlib.figure.Figure.subplot_mosaic

Примеры использования `matplotlib.figure.Figure.subplot_mosaic`