matplotlib.pyplot.figure

matplotlib.pyplot.figure(num=None, figsize=None, dpi=None, *, facecolor=None, edgecolor=None, frameon=True, FigureClass=<class 'matplotlib.figure.Figure'>, clear=False, **kwargs)[source]

Создать новую фигуру или активировать существующую.

Параметры:

numint или str или Figure или SubFigure, необязательно

Уникальный идентификатор фигуры.

Если фигура с таким идентификатором уже существует, эта фигура активируется и возвращается. Целое число относится к атрибуту Figure.number, строка относится к метке фигуры.

Если фигура с данным идентификатором не найдена или num не задано, создается новая фигура, она активируется и возвращается. Если num — целое число, оно будет использовано для атрибута Figure.number, в противном случае используется сгенерированное автоматически целое число (начиная с 1 и увеличивающееся при каждом создании новой фигуры). Если num — строка, метка фигуры и заголовок окна устанавливаются на это значение. Если num — SubFigure, активируется родительский Figure.

figsize(float, float), по умолчанию: rcParams["figure.figsize"] (по умолчанию: [6.4, 4.8])

Ширина и высота в дюймах.

dpifloat, по умолчанию: rcParams["figure.dpi"] (по умолчанию: 100.0)

Разрешение фигуры в точках на дюйм.

facecolorцвет, по умолчанию: rcParams["figure.facecolor"] (по умолчанию: 'white')

Цвет фона.

edgecolorцвет, по умолчанию: rcParams["figure.edgecolor"] (по умолчанию: 'white')

Цвет границы.

frameonbool, по умолчанию: True

Если False, рамка фигуры не рисуется.

FigureClassподкласс Figure

Если задано, будет создан экземпляр этого подкласса вместо простой Figure.

clearbool, по умолчанию: False

Если True и фигура уже существует, она очищается.

layout{'constrained', 'compressed', 'tight', 'none', LayoutEngine, None}, по умолчанию: None

Механизм макета для размещения элементов графика, чтобы избежать перекрытия элементов оформления осей (метки, деления и т.д.). Обратите внимание, что менеджеры макета могут заметно замедлить отображение фигуры.

'constrained': решатель ограниченного макета подстраивает размеры осей, чтобы избежать перекрытия элементов оформления осей. Может обрабатывать сложные макеты графиков и цветовые шкалы, поэтому рекомендуется.

Примеры см. в Руководстве по ограниченному макету.
'compressed': использует тот же алгоритм, что и 'constrained', но удаляет лишнее пространство между осями с фиксированным соотношением сторон. Лучше всего подходит для простых сетки осей.
'tight': Используйте механизм плотного макета. Это относительно простой алгоритм, который изменяет параметры подграфиков так, чтобы элементы оформления не перекрывались. Дополнительные сведения см. в Figure.set_tight_layout.
'none': Не использовать механизм макета.
Экземпляр LayoutEngine. Встроенные классы макета — ConstrainedLayoutEngine и TightLayoutEngine, к которым проще получить доступ через 'constrained' и 'tight'. Передача экземпляра позволяет сторонним разработчикам предоставлять собственный механизм макета.

Если не указано, используется параметры tight_layout и constrained_layout, включая их значения по умолчанию rcParams["figure.autolayout"] (по умолчанию: False) и rcParams["figure.constrained_layout.use"] (по умолчанию: False).

**kwargs

Дополнительные ключевые аргументы передаются конструктору Figure.

Возвращает:

Figure

Примечания

Созданная фигура передается методу new_manager или функции new_figure_manager, предоставляемой текущим бэкендом, которые устанавливают холст и менеджер на фигуре.

После этого вызываются rcParams["figure.hooks"] (по умолчанию: []), по одному за раз, на фигуре; эти хуки позволяют произвольно настраивать фигуру (например, привязывать обратные вызовы) или связанные элементы (например, изменять панель инструментов). Пример настройки панели инструментов см. в mplcvd — пример хуков фигуры.

Если вы создаете много фигур, убедитесь, что вы явно вызываете pyplot.close для фигур, которыми вы не пользуетесь, так как это позволит pyplot корректно очистить память.

rcParams определяет значения по умолчанию, которые можно изменить в файле matplotlibrc.