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, необязательно

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

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

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

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 и фигура уже существует, она очищается.

tight_layoutbool или dict, по умолчанию: rcParams["figure.autolayout"] (по умолчанию: False)

Если False, используйте subplotpars. Если True, настраивайте параметры подграфиков с помощью tight_layout с заданными по умолчанию отступами. При передаче словаря, содержащего ключи pad, w_pad, h_pad, и rect, по умолчанию будут переопределены отступы tight_layout.

constrained_layoutbool, по умолчанию: rcParams["figure.constrained_layout.use"] (по умолчанию: False)

Если True, используйте ограниченную компоновку для настройки позиционирования элементов графика. Похоже на tight_layout, но разработано для большей гибкости. Примеры см. в Руководство по ограниченной компоновке. (Примечание: не работает с add_subplot или subplot2grid.)

**kwargs : необязательно

Дополнительные аргументы см. в Figure.

Возвращает

Figure: Экземпляр Figure, возвращённый также будет передан в функцию new_figure_manager в бэкендах, что позволяет подключать пользовательские классы Figure к интерфейсу pyplot. Дополнительные аргументы будут переданы в функцию инициализации Figure.

Примечания

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

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