matplotlib.style#

样式是预定义的 rcParams 集合,用于定义绘图的视觉外观。

使用样式表和 rcParams 自定义 Matplotlib 介绍了样式的机制与用法。

样式表参考 概述了内置样式。

Matplotlib 样式库的核心函数与属性

use

选择样式表以覆盖当前的 matplotlib 设置。

context

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

available

列出可用的样式表。以下划线开头命名的样式被视为私有,不会被列出,但仍可通过 library 直接访问。

library

包含样式名称与 matplotlib 设置的字典。

matplotlib.style.context(style, after_reset=False)[source]#

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

参数:
stylestr, dict, Path 或 list

样式规格。有效的选项包括:

str
  • style.available 中的样式名称之一(内置样式或安装在用户库路径下的样式)。

  • 形如 "package.style_name" 的点分名称;在此情况下,"package" 应为一个可导入的 Python 包名称,例如在 /path/to/package/__init__.py;加载的样式文件路径为 /path/to/package/style_name.mplstyle。(同样支持子包中的样式文件。)

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

字典

matplotlib.rcParams 的键/值对映射。

Path

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

list

样式说明符的列表(str、Path 或 dict),将按照列表中从前到后的顺序应用。

after_resetbool

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

matplotlib.style.reload_library()[source]#

重新加载样式库。

matplotlib.style.use(style)[source]#

根据样式规格使用 Matplotlib 样式设置。

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

注意

这会根据样式中的设置更新 rcParams。未在样式中定义的 rcParams 将保持不变。

参数:
stylestr, dict, Path 或 list

样式规格。有效的选项包括:

str
  • style.available 中的样式名称之一(内置样式或安装在用户库路径下的样式)。

  • 形如 "package.style_name" 的点分名称;在此情况下,"package" 应为一个可导入的 Python 包名称,例如在 /path/to/package/__init__.py;加载的样式文件路径为 /path/to/package/style_name.mplstyle。(同样支持子包中的样式文件。)

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

字典

matplotlib.rcParams 的键/值对映射。

Path

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

list

样式说明符的列表(str、Path 或 dict),将按照列表中从前到后的顺序应用。

备注

以下 rcParams 与样式无关,如果出现在样式规格中将被忽略:

  • backend

  • backend_fallback

  • date.epoch

  • docstring.hardcopy

  • figure.max_open_warning

  • figure.raise_window

  • interactive

  • savefig.directory

  • timezone

  • tk.window_focus

  • toolbar

  • webagg.address

  • webagg.open_in_browser

  • webagg.port

  • webagg.port_retries

matplotlib.style.library#

将样式名称映射到定义该样式的 rcParams 的字典。

此字典旨在为只读。使用 reload_library 进行更新。

matplotlib.style.available#

可用样式的名称列表。

此字典旨在为只读。使用 reload_library 进行更新。