配置文件
把颜色、线条、标签与图例的设置保存为 econ-viz.toml，加载一次即可，不用每个方法都传相同的参数。
格式
段落名称对应 Theme 的属性，字段名称与样式对象的参数相同。没写到的设置沿用内置默认值。
# econ-viz.toml
base = "default" # default or nord
[font]
text = "TeX Gyre Pagella"
math = "stix"
[color]
ic = "#2E86AB"
budget = "#6C3483"
equilibrium = "#C0392B"
[stroke.budget] # theme.budget_stroke
width = 1.5
style = "solid"
[stroke.ic] # theme.ic_stroke
width = 1.8
opacity = 0.9
[marker.equilibrium] # theme.eq_marker
size = 5
[label.point] # theme.point_label
fontsize = 12
position = "top-right"
[label.origin]
visible = false
[fill.budget] # theme.budget_fill
color = "lightgrey"
opacity = 0.3
[legend] # theme.legend
position = "auto"
fontsize = 10
| 段落 | 设置的对象 | 字段 |
|---|---|---|
base |
作为基础的内置主题 | "default"、"nord" |
[font] |
正文与数学字体 | text、math |
[color] |
Theme 的颜色，例如 ic → ic_color |
颜色字符串 |
[stroke.<name>] |
theme.<name>_stroke |
width、style、color、arrow、opacity |
[marker.<name>] |
theme.<name>_marker |
color、size、shape、opacity |
[label.<name>] |
theme.<name>_label |
position、offset、color、fontsize、visible、opacity |
[fill.<name>] |
theme.<name>_fill |
color、opacity |
[legend] |
theme.legend |
position、fontsize、frame、columns、visible、opacity |
eq 也可以写成 equilibrium（[marker.equilibrium]、[color] equilibrium）。段落、名称或字段写错时，错误信息会列出可用的选项。
加载
from econ_viz import Canvas, Config
Config.load("econ-viz.toml").use() # 之后创建的图
Canvas(x_max=20, y_max=15) # 应用配置文件
theme = Config.load("econ-viz.toml").theme
Canvas(theme=theme) # 或只应用于这张图
Config.reset() # 回到内置默认值
方法显式传入的参数仍然优先于配置文件：以上面的设置为例，add_budget(..., stroke=Stroke(width=1)) 会画出 1 pt 粗、其余沿用配置文件样式的线。
命令行
econ-viz init 会生成一份带注释的模板，列出所有可以设置的名称；econ-viz plot 则通过 --config 读取同一份配置文件：
uv run econ-viz init # 生成 econ-viz.toml
uv run econ-viz plot --model cobb-douglas --px 2 --py 3 --income 30 \
--config econ-viz.toml --output cd.png