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)[исходный код]

Создаёт расположение областей Axes на основе ASCII-графики или вложенных списков.

Это вспомогательная функция для наглядного создания сложных макетов GridSpec.

Пример и полную документацию API см. в разделе Сложная и семантическая композиция рисунков (subplot_mosaic)

Параметры:

mosaicсписок списков из {хешируемых или вложенных элементов} или str

Визуальное описание расположения областей Axes, обозначенных строками. Например

x = [['A panel', 'A panel', 'edge'],
     ['C panel', '.',       'edge']]

создаёт 4 области Axes:

• 'A panel' высотой в 1 строку, занимает первые два столбца
• 'edge' высотой в 2 строки, расположен у правого края
• 'C panel' занимает 1 строку и 1 столбец в нижней левой части
• пустое пространство размером 1 строка и 1 столбец внизу по центру

Любой элемент макета можно заменить списком списков той же формы, чтобы создать вложенные макеты.

Если входное значение — str, оно может быть либо многострочной строкой вида

'''
AAE
C.E
'''

где каждый символ задаёт столбец, а каждая строка — строку макета. Также это может быть однострочная строка, в которой строки разделяются с помощью ;:

'AB;CC'

Строковая запись допускает только однобуквенные метки областей Axes и не поддерживает вложенность, но зато она очень компактна.

Идентификаторы областей Axes могут быть 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_kwdict, необязательно

Словарь с именованными аргументами, передаваемыми при вызове Figure.add_subplot, используемом для создания каждого подграфика. Эти значения могут быть переопределены значениями из per_subplot_kw.

per_subplot_kwdict, необязательно

Словарь, сопоставляющий идентификаторы областей Axes или кортежи идентификаторов со словарём именованных аргументов, передаваемых при вызове Figure.add_subplot, используемом для создания каждого подграфика. Значения в этих словарях имеют приоритет над значениями в subplot_kw.

Если mosaic — это строка, а значит, все ключи состоят из одного символа, в качестве ключей вместо кортежей можно использовать одиночные строки; то есть "AB" эквивалентно ("A", "B").

Добавлено в версии 3.7.

gridspec_kwdict, необязательно

Словарь с именованными аргументами, передаваемыми конструктору GridSpec, который используется для создания сетки, в которой располагаются подграфики. Во вложенных макетах этот аргумент применяется только к внешнему макету. Для более сложных макетов используйте Figure.subfigures для создания вложенных элементов.

empty_sentinelobject, необязательно

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

Возвращает:

dict[label, Axes]

Словарь, сопоставляющий метки объектам Axes. Области Axes расположены слева направо и сверху вниз в соответствии с их положением в общем макете.

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

Диаграмма рассеяния с гистограммами

Диаграмма рассеяния с гистограммами

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

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

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

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

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

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

Добавление подписей к подграфикам

Добавление подписей к подграфикам

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

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