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 or str, optional` Уникальный идентификатор фигуры. Если фигура с таким идентификатором уже существует, эта фигура активируется и возвращается. Целое число относится к атрибуту `Figure.number`, строка — к метке фигуры. Если нет фигуры с идентификатором или num не указан, создаётся новая фигура, активируется и возвращается. Если num — целое число, оно будет использоваться для атрибута `Figure.number`, в противном случае используется автоматически сгенерированное целое число (начиная с 1 и увеличивается для каждой новой фигуры). Если num — строка, то метка фигуры и заголовок окна будут установлены на это значение. `figsize(float, float), default: rcParams["figure.figsize"] (default: [6.4, 4.8])` Ширина и высота в дюймах. `dpifloat, default: rcParams["figure.dpi"] (default: 100.0)` Разрешение фигуры в точках на дюйм. `facecolorcolor, default: rcParams["figure.facecolor"] (default: 'white')` Цвет фона. `edgecolorcolor, default: rcParams["figure.edgecolor"] (default: 'white')` Цвет границы. `frameonbool, default: True` Если False, подавить отображение рамки фигуры. `FigureClasssubclass of Figure` Используйте экземпляр `Figure` для пользовательской настройки. `clearbool, default: False` Если True и фигура уже существует, она очищается. `tight_layoutbool or dict, default: rcParams["figure.autolayout"] (default: False)` Если `False`, используйте subplotpars. Если `True`, отрегулируйте параметры подграфиков с помощью `tight_layout` со значениями по умолчанию для отступов. При предоставлении словаря с ключами `pad`, `w_pad`, `h_pad`, и `rect`, значения по умолчанию для отступов `tight_layout` будут переопределены. `constrained_layoutbool, default: rcParams["figure.constrained_layout.use"] (default: False)` Если `True`, используйте ограниченную компоновку для регулировки расположения элементов графика. Подобно `tight_layout`, но разработан более гибко. См. Руководство по ограниченной компоновке для примеров. (Примечание: не работает с `add_subplot` или `subplot2grid`.) **kwargs : необязательно См. `Figure` для других возможных аргументов.
Возвращает:	`Figure` Экземпляр `Figure`, возвращённый также будет передан в new_figure_manager в бэкендах, что позволяет подключить пользовательские классы `Figure` к интерфейсу pyplot. Дополнительные kwargs будут переданы в функцию инициализации `Figure`.

numint or str, optional

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

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

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

figsize(float, float), default: rcParams["figure.figsize"] (default: [6.4, 4.8])

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

dpifloat, default: rcParams["figure.dpi"] (default: 100.0)

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

facecolorcolor, default: rcParams["figure.facecolor"] (default: 'white')

Цвет фона.

edgecolorcolor, default: rcParams["figure.edgecolor"] (default: 'white')

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

frameonbool, default: True

Если False, подавить отображение рамки фигуры.

FigureClasssubclass of Figure

Используйте экземпляр Figure для пользовательской настройки.

clearbool, default: False

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

tight_layoutbool or dict, default: rcParams["figure.autolayout"] (default: False)

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

constrained_layoutbool, default: rcParams["figure.constrained_layout.use"] (default: False)

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

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

См. Figure для других возможных аргументов.

Возвращает:

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

Примечания

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

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

matplotlib.pyplot.figure

Примечания

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

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