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

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

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

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

Параметры:

mosaiclist of list of {hashable or nested} or str

Визуальное описание желаемого расположения объектов Axes с метками в виде строк. Например:

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

создаёт 4 объекта Axes:

«Панель A», высота которой составляет 1 строку и которая занимает первые два столбца
«край», высота которого составляет 2 строки и который находится у правого края
«Панель C», ширина и высота которой составляют по 1 ячейке и которая находится внизу слева
пустое пространство шириной и высотой в 1 ячейку внизу по центру

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

Если входные данные — строка, она должна иметь следующий формат:

'''
AAE
C.E
'''

где каждый символ соответствует столбцу, а каждая строка — строке компоновки. Такой формат допускает только однобуквенные метки Axes и не поддерживает вложенность, но очень краток.

sharex, shareybool, default: False

Если True, ось x (sharex) или ось y (sharey) будет общей для всех подграфиков. В таком случае видимость меток делений и единицы измерения осей работают так же, как в subplots. Если False, оси x или y каждого подграфика будут независимыми.

width_ratiosarray-like of length ncols, optional

Задаёт относительную ширину столбцов. Каждому столбцу присваивается относительная ширина width_ratios[i] / sum(width_ratios). Если параметр не задан, все столбцы будут иметь одинаковую ширину. Упрощённая запись для gridspec_kw={'width_ratios': [...]}.

height_ratiosarray-like of length nrows, optional

Задаёт относительную высоту строк. Каждой строке присваивается относительная высота height_ratios[i] / sum(height_ratios). Если параметр не задан, все строки будут иметь одинаковую высоту. Упрощённая запись для gridspec_kw={'height_ratios': [...]}.

empty_sentinelobject, optional

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

subplot_kwdict, optional

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

per_subplot_kwdict, optional

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

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

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

gridspec_kwdict, optional

Словарь с именованными аргументами, передаваемыми конструктору GridSpec, который используется для создания сетки, в которой размещаются подграфики.

**fig_kw

Все дополнительные именованные аргументы передаются вызову pyplot.figure.

Возвращает:

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