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', 'compressed', 'tight', 'none', LayoutEngine, None}, по умолчанию: None

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

**kwargs

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

Возвращает:

Figure

Замечания

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

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

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

matplotlib.pyplot.figure

Замечания

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

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