SuperAPI AI 工具集

figure-planner

写作与研究

查看项目

更新于 10-15 17:28

技能介绍

用途:当论文瓶颈不再是句子写作而是图表逻辑时使用。目标是让每张图承担一个可辩护的科学任务,保持面板集合连贯,并确保图例与 Results 文本讲述同一故事。它比 manuscript-optimizer 更窄:整篇论文结构不稳时用后者,核心问题在于每张图应证明什么、每个面板应起什么作用时用本技能。

适用情形:图显得过载、碎片化或难以概括;Results 小节数量被面板数量驱动;不清楚哪些内容应放主图、哪些放补充材料;图例、面板字母与 Results 文本可能已脱节;需要围绕主张而非绘图便利重新设计图题或面板分组。不适用于仅做底层视觉样式、不涉及图表改动的最终校对,或超出图表本身的全文主张重构。

核心规则:每张主图应通过承载一个主导主张来证明其存在价值。若无法用一句干净的话概括,就拆分、将部分降级到补充材料,或围绕更清晰的主张重写。

面板角色:写图例或 Results 段落前,为每个面板指定一个主要角色,如支持主张的证据、方法学桥梁或定义、新条件下的验证、排名或基准比较、转化或实际后果、案例说明、作为发现陈述的零结果或负结果。不要让一个面板同时假装做三件事。

规划顺序:写出图的单句主张;列出支持该主张所需的最少面板;为每个面板分配一个角色;确定锚定面板(Results 段落应围绕它展开);将次要细节移到另一张图、补充材料或图例;重写图题和图例以匹配实际主张;检查 Results 小节是否符合同一面板逻辑。

主图与补充材料:主图保留建立核心主张所需的面板、读者必须立即看到的关键比较,以及当新指标、分解或评估制度的定义是论证一部分时定义它的面板。补充材料放稳健性变体、更密集的方法间比较、扩展案例、次要消融、支持但不定义主主张的额外示例,以及接口、兼容性或资格矩阵(应作为 SI 表或一句 Methods 说明)。

图例规则:图例不应只解读坐标轴,还应定义每个面板的角色、保留压缩正文中省略的关键定量锚点、与面板字母、指标、数据集和基线保持一致、避免比所绘证据更强的解释、不携带解释性防御(如“未被选中”“为完整性列出”“不应比较”),而是陈述决定可比性的事实(不同面板、不同 n);对反直觉值正面解释其量是什么;仅在提供 Source Data 文件时才命名它。

图弧:Figure 1 将论文一句话卖点渲染为数据:范围而非架构。后续图承载机制、证据、稳健性和应用。依据论文卖点及该图自身主张评判每个面板,必要时在图表间移动内容。figure-style 规则 7.5 指向此处(figure-style 属于 figure stack,用 --figure 安装)。

视觉卫生检查:图逻辑稳定后做一次视觉卫生检查:保持图内字体一致并接近正文阅读尺度;绘图、示意图和示意面板尽量用矢量图;使用克制配色,同一类别保持同一色系;避免某面板或模块因过暗或过亮产生意外显著性,除非刻意强调;修剪面板周围死边距和不必要空白;减少图内文字负担,让形状、对齐和分组承担更多解释;展示流程或过程时保持箭头方向和符号约定一致;可借用成熟表格或面板布局作参考,但不要默认继承会议模板的杂乱。

常见失败模式:一张图承载多个不相关主张;面板顺序按绘图时间而非论证逻辑;方法学桥梁面板被描述为泛泛动机;Results 文本声称图例或面板不支持的内容;补充图引用过于模糊而实际是某一面板在起作用;把弱辅助指标留在标题级别而非降级;图排版、空白或颜色逻辑不一致,使科学比较更难读。

Nature 风格增强:面向 Nature 或类似高影响力期刊的图,可应用给定 rcParams(Arial、svg.fonttype='none'、pdf.fonttype=42、font.size=7、隐藏右/上边框、axes.linewidth=0.8、legend.frameon=False,figsize 单栏 89 mm、双栏 183 mm)。仅在安装 LaTeX 且需要数学标签时用 text.usetex=True。打印尺度与设计尺度:上述数值为打印尺度,画布即印刷面板,所见即所得,是默认且更安全的制度。设计尺度画布为印刷宽度的 S 倍,导出时缩小到栏宽,常见 S 约 4,使 font.size=24 变为 6.1 pt、axes.linewidth=3 变为 0.76 pt;这些值合法但仅在除法之后。两条规则:不要在一个脚本中混用制度,选定 S 并在注释中说明,将所有绝对尺寸除以它;设计尺度只导出栅格,若为线稿应使用打印尺度并导出矢量。

Nature 风格调色板:需要固定、适合印刷的调色板时,可使用给定暖色 Nature 风格集合,基线或参考系列用 terracotta,其余类别按列表顺序取色,同一类别保持同一色系。NATURE_PALETTE 与 nature_assign 函数按资料原样保留,用于将标签映射到调色板颜色,基线取 terracotta,其余按序取色,颜色不足时抛出错误而非复用颜色。

使用时机:面向 Nature、NeurIPS、ICLR 或类似场所的论文、幻灯片或报告图;涉及分组柱状图、趋势线、热图、雷达图、多面板网格或 PDF/SVG/高 DPI 输出;任何提到“Nature style”“publication figure”“paper figure”或“high-quality scientific plot”的请求。

输出标准:使用时产出图的单句主张、带角色的建议面板列表、主图与补充材料的划分、图例逻辑、仍需注意的视觉卫生说明,以及匹配的 Results 小节标题或主题句。