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.use(style)[source]#
根据样式规格使用 Matplotlib 样式设置。
'default' 样式名称保留用于恢复默认样式设置。
- 参数:
- 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进行更新。