matplotlib.figure.SubFigure.subplot_mosaic

SubFigure.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список списков из {хешируемых объектов или вложенных списков} либо строка

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

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

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

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

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

Если входное значение — строка, это может быть многострочная строка следующего вида:

'''
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.SubFigure.subplot_mosaic

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

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