# Plot Figure

> Use when users need a standardized grouped bar chart template for baseline-vs-method comparisons, with fixed axis/legend/color/data-label conventions and user-provided methods/data.

- Skill: `xlinsist/plot-figure` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add xlinsist/plot-figure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xlinsist/plot-figure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xlinsist (https://skillmd.com/u/xlinsist)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xlinsist/plot-figure

---


# Plot Figure

用于把“与 baseline 比较的可视化”统一为同一套柱状图模板。  
这个 skill 只固定绘图模板细节，不固定具体方法名和数据；方法与数据由用户输入描述。

## 适用场景

- 用户要画“baseline vs 其它方法”的对比图。
- 需要统一视觉规范：横轴、纵轴、legend、配色、柱顶数值。
- 输入通常包含：任务名、x 轴类别、各方法名称、各方法对应数值、输出文件名。

## 固定模板约束

- 图类型：分组柱状图（grouped bar chart）。
- 横轴：用户给定类别（通常是 shape/size/batch 等），以离散标签显示。
- 纵轴：性能指标数值，默认标签 `Execution Time (s)`（可按用户要求改名）。
- Legend：必须显示 baseline 与其它方法名称。
- 配色：
  - baseline：`#182345`
  - 当仅有 1 个对比方法时：对比方法主色 `#FFC000`
  - 当对比方法大于 2 个时：参考 `references/plot_figure_multi_method_reference.py`，对比方法使用 `Set2` 风格扩展色盘（baseline 仍保持 `#182345`）。
- 柱上数值：必须展示，默认 `fmt='%.2f'`、`padding=3`、`fontsize=10`。
- 版式：
  - 常规（baseline + 1 方法）：
    - `figsize=(9, 6)`
    - `grid(axis='y', linestyle='--', alpha=0.3)`
    - 字体遵循模板默认 rcParams
  - 多方法（对比方法 > 2）：
    - 参考 `references/plot_figure_multi_method_reference.py`
    - 推荐 `figsize=(24, 10)`、较大字体（如 x/y 轴 32、x tick 26、y tick 22、legend 28）
    - 输出建议 `dpi=300`，并在柱顶显示较大数据标签

## 工作流程

1. 先收集用户输入：
- baseline 名称。
- 对比方法名称列表。
- x 轴标签列表。
- 每个方法对应的 y 值列表（长度需与 x 轴一致）。
- 图标题、y 轴标题、输出文件名。

2. 使用模板脚本生成图：
- 从 `scripts/plot_figure_template.py` 拷贝一份到当前工作目录。
- 仅替换数据区与元信息区，不改动模板风格约束。
- 当对比方法 > 2 时，启用模板中的多方法样式分支（已对齐 reference 的配色/画布/字体策略）。

3. 基础校验：
- 检查每个方法数据长度是否等于 x 轴长度。
- 检查是否包含 baseline。
- 检查输出文件成功生成。

## 资源

- 模板脚本：`scripts/plot_figure_template.py`
- 模板说明：`references/template_notes.md`
- 多方法样式参考：`references/plot_figure_multi_method_reference.py`