mpl gui#

显示#

mpl_gui.show

显示图形并可能阻塞。

交互性#

mpl_gui.ion

启用交互模式。

mpl_gui.ioff

禁用交互模式。

mpl_gui.is_interactive

返回是否在每次绘图命令后更新绘图。

图形创建#

非管理#

mpl_gui.figure

创建一个新图表

mpl_gui.subplots

创建一个图和一组子图。

mpl_gui.subplot_mosaic

根据 ASCII 艺术或嵌套列表构建 Axes 布局。

mpl_gui.promote_figure

创建一个新的图形管理器实例。

管理#

class mpl_gui.FigureRegistry(*, block=None, timeout=0, prefix='Figure ')[源]#

基类: object

一个用于封装图形创建并跟踪它们的注册表。

此实例将保留对已创建图形的强引用,以确保它们不会被垃圾回收。

参数:
block布尔值, 可选

是否在 show_all 返回之前等待所有图形关闭。

如果为 True,则阻塞并运行 GUI 主循环,直到所有图形窗口关闭。

如果为 False,则确保所有图形窗口都已显示并立即返回。在这种情况下,您需要负责确保事件循环正在运行,以便图形响应。

在非交互模式下默认为 True,在交互模式下默认为 False(参见 is_interactive)。

超时浮点数,可选

如果阻塞,等待所有图形关闭的默认时间。

如果为 0,则永远阻塞。

mpl_gui.FigureRegistry.figure

创建一个新图表

mpl_gui.FigureRegistry.subplots

创建一个图和一组子图。

mpl_gui.FigureRegistry.subplot_mosaic

根据 ASCII 艺术或嵌套列表构建 Axes 布局。

mpl_gui.FigureRegistry.by_label

返回当前标签到图形映射的字典。

mpl_gui.FigureRegistry.show_all

显示 FigureRegistry 已知的所有图形。

mpl_gui.FigureRegistry.close_all

关闭此注册表已知的所有图形。

class mpl_gui.FigureContext(*, forgive_failure=False, **kwargs)[源]#

基类: FigureRegistry

扩展 FigureRegistry 以用作上下文管理器。

离开上下文时,注册表已知的所有图形都将显示。

参数:
block布尔值, 可选

是否在 show_all 返回之前等待所有图形关闭。

如果为 True,则阻塞并运行 GUI 主循环,直到所有图形窗口关闭。

如果为 False,则确保所有图形窗口都已显示并立即返回。在这种情况下,您需要负责确保事件循环正在运行,以便图形响应。

在非交互模式下默认为 True,在交互模式下默认为 False(参见 is_interactive)。

超时浮点数,可选

如果阻塞,等待所有图形关闭的默认时间。

如果为 0,则永远阻塞。

forgive_failure布尔值,可选

如果为 True,则在异常传播之前阻塞以显示图形

选择后端#

mpl_gui.select_gui_toolkit

选择要使用的 GUI 工具包。