matplotlib.pyplot.figure

matplotlib.pyplot.figure(num=None, figsize=None, dpi=None, *, facecolor=None, edgecolor=None, frameon=True, FigureClass=>, 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', 'tight', LayoutEngine, None}, по умолчанию: None

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

**kwargs

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

Возвращает:

Figure

Примечания

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

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

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

matplotlib.pyplot.figure

Примечания

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

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