matplotlib.style

样式是预定义的 rcParams 集合，它们定义了图形的视觉外观。

使用样式表和rcParams自定义Matplotlib 描述了样式机制和使用方法。

The 样式表引用 提供了内置样式的概览。

matplotlib.style.context(style, after_reset=False)

用于临时使用样式设置的上下文管理器。

参数:

风格str, dict, Path 或 list

样式规范。有效选项包括：

str

• style.available 中的样式名称之一（内置样式或用户库路径中安装的样式）。

• 形式为“包.样式名”的点名称；在这种情况下，“包”应该是一个可导入的Python包名，例如在 /path/to/package/__init__.py；加载的样式文件是 /path/to/package/style_name.mplstyle。（子包中的样式文件同样受支持。）

• 样式文件的路径或URL，由 rc_params_from_file 加载。

dict

matplotlib.rcParams 的键/值对映射。

路径

样式文件的路径，由 rc_params_from_file 加载。

列表

样式说明符列表（str、Path 或 dict），这些说明符按列表中的顺序从第一个到最后一个应用。

after_reset布尔值

如果为 True，则在将设置重置为默认值后应用样式；否则，在当前设置的基础上应用样式。

matplotlib.style.reload_library()

重新加载样式库。

matplotlib.style.use(style)

使用来自样式规范的 Matplotlib 样式设置。

样式名称 'default' 被保留用于恢复到默认样式设置。

备注

这将使用样式中的设置更新 rcParams。样式中未定义的 rcParams 保持不变。

参数:

风格str, dict, Path 或 list

样式规范。有效选项包括：

str

• style.available 中的样式名称之一（内置样式或用户库路径中安装的样式）。

• 形式为“包.样式名”的点名称；在这种情况下，“包”应该是一个可导入的Python包名，例如在 /path/to/package/__init__.py；加载的样式文件是 /path/to/package/style_name.mplstyle。（子包中的样式文件同样受支持。）

• 样式文件的路径或URL，由 rc_params_from_file 加载。

dict

matplotlib.rcParams 的键/值对映射。

路径

样式文件的路径，由 rc_params_from_file 加载。

列表

样式说明符列表（str、Path 或 dict），这些说明符按列表中的顺序从第一个到最后一个应用。

注释

以下 rcParams 与样式无关，如果在样式规范中找到，将被忽略：

• 后端

• backend_fallback

• date.epoch

• docstring.hardcopy

• figure.max_open_warning

• figure.raise_window

• 交互式

• savefig.directory

• 时区

• tk.window_focus

• 工具栏

• webagg.地址

• webagg.open_in_browser

• webagg.port

• webagg.port_retries

matplotlib.style.library

一个从样式名称映射到定义该样式的 rcParams 的字典。

这是只读的。使用 reload_library 来更新。

matplotlib.style.available

可用样式的名称列表。

这是只读的。使用 reload_library 来更新。