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`, настроить параметры subplot с помощью `tight_layout` с подумолчательными отступами. При указании dict содержащего ключи `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. Дополнительные kwargs будут переданы в функцию инициализации `Figure`.

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, настроить параметры subplot с помощью tight_layout с подумолчательными отступами. При указании dict содержащего ключи 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. Дополнительные kwargs будут переданы в функцию инициализации Figure.

Примечания

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

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

matplotlib.pyplot.figure

Примечания

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

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