XiaoMaColtAI/math-modeling-skill / tools/figure
科研可视化工具
Verified从数据剖析到出版级成图的完整可视化工具。先做数据剖析(列类型/样本量/分布/异常值/分组结构/相关性), 再结合论证目标推荐图型,主动拦截科研画图经典错误,产出 Nature / Science / IEEE / Elsevier / PNAS / 中文核心期刊级别的成图。覆盖数据 EDA、图表契约、选图决策、出版级绘制、程序自检 + AI 读图闭环、多格式 导出和文件审计。数学建模场景额外支持三类图体系(原始数据/过程/结果)、子问题覆盖检查和建模流程图规范。 当用户涉及论文配图、科研画图、数据可视化、选图、期刊投稿图、figure、出版级图表、matplotlib、seaborn、 plotly、误差棒、显著性标注、色盲安全配色、矢量图导出、中文论文图表、多面板时使用。
references/guides/figure_contract.md
View on GitHub# 图表契约详细工作流
在写绘图代码之前使用本参考。目标是让图表服务于论文的科学逻辑。
## 隐私规则
图表契约面向用户,但工作痕迹保持私密。不要在用户界面暴露私有路径、源文件名、
内部参考文档或模板标识,除非用户明确要求追溯来源。
## 必需契约
在工作笔记或回复中创建简短契约:
```text
核心结论:
图表原型:
目标期刊/输出:
后端:Python
最终尺寸:
面板映射:
a:
b:
c:
证据层级:
核心证据:
验证证据:
对照/鲁棒性:
所需统计:
所需源数据:
图像完整性说明:
审稿人风险:
```
不要从喜欢的模板开始。从结论开始,然后选择使结论清晰可辩护的最小面板集。
## 核心结论规则
- 核心结论应是一个带动词的句子:"方法 X 通过恢复 Y 降低 Z",而不是"方法结果"。
- 每个面板必须回答一个唯一的问题。遮盖某个面板不会削弱论证,则删除或合并它。
- 将主要证据与支撑证据分开。主要证据获得主面板或最清晰的坐标轴;
对照和鲁棒性面板在视觉上应更安静。
- 如果用户提供数据但没有声明,从数据请求推断临时声明,并在最终样式化前请求确认。
## 原型选择
| 原型 | 适用场景 | 主面板 | 支撑面板 |
|---|---|---|---|
| `quantitative grid` | 声明主要是数值对比 | 可选;通常是主导摘要指标 | 共享坐标轴、对齐尺度、紧凑图例 |
| `schematic-led composite` | 需要先理解工作流、机制或实验设计 | 左侧或顶部示意图,占 35-60% 面积 | 2-4 个定量验证面板 |
| `image plate + quant` | 显微镜、成像、空间叠加主导证据 | 图像板或代表性图像 | 比例尺、叠加、裁切、量化 |
| `asymmetric mixed-modality figure` | 组合示意图、光栅图像、热力图和定量图 | 一个面板跨行/列 | 按证据价值排列的较小面板 |
**数学建模常用**:`quantitative grid`(方法对比)、`asymmetric mixed-modality figure`
(求解流程 + 结果面板)。
## 面板逻辑
除非论文故事明确需要其他顺序,使用以下顺序:
1. 建立系统:样本、方法、模型架构、实验设计。
2. 展示主要效应或主要对比。
3. 展示机制或定位。
4. 量化代表性结果或定性观察。
5. 添加鲁棒性、对照、子组分析或灵敏度分析。
对于数学建模论文:
- 面板 a 通常定义视觉词汇:颜色、符号、工作流方向、样本类别。
- 在整个图中复用该词汇,尽可能在整篇论文中复用。
- 三类图体系中,每类图的面板逻辑独立但颜色语义一致。
## 反冗余检查(面板逻辑补充)
定稿前逐条检查(详见 `design_theory.md` §11):
- [ ] 每个面板回答一个**唯一的问题**——遮盖某面板不会削弱论证,则删除或合并
- [ ] 面板 b **不是**用不同图表形式重复面板 a 的相同数据
- [ ] 每个面板有**独立的坐标轴词汇**(不同 x/y 变量或不同物理含义)
- [ ] 三类图之间不重复——原始数据图展示分布特征,过程图展示求解行为,结果图支撑结论
- [ ] 全文图型种类 ≥ 3 种(如折线+柱状+散点),不全部是同一种图表类型
## 美学整合
- 使用一个中性色系、一个信号色系、一个强调色系。
- 所有面板中同一条件/方法使用相同颜色。
- 对稳定的线标识、通道和固定空间区域优先使用直接标签。
- 当重复图例浪费空间时,使用共享图例区域。
- 当证据重要性不等时,避免等大面板。
- 保持示意图颜色和定量图颜色相关。示意图主导的图应看起来像一个整合论证,
而不是拼贴画。
## 审稿人风险提示
最终化前,质疑一个持怀疑态度的审稿人会挑战什么:
- 样本量在图注或源数据中可见吗?
- 误差棒、区间和统计检验有定义吗?
- 邀请对比的面板之间坐标轴可比吗?
- 代表性结果有量化并可追溯到原始文件吗?
- 图像调整是全局的且有记录吗?
- 用更少的面板能得出同样的结论吗?
**数学建模特有风险**:
- 三类图是否覆盖全部子问题?每个子问题在三类中各至少 1 张?
- 统计标注是否由代码计算,而非硬编码?
- 图注是否写清了误差类型、n、检验方法和校正?
- 最终尺寸下所有文字是否可读(≥6pt)?
- 同一变量跨图颜色语义是否一致?
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |