Community图像github.com

论文图表导出工具

从R (ggplot2/patchwork) 中导出符合出版要求的图件,指定物理尺寸、嵌入字体、色盲友好的Okabe-Ito调色板、300+ dpi PNG、说明注释和导出清单,然后审计文件(尺寸以mm为单位、dpi、嵌入字体)并检查调色板是否存在色觉缺陷。适用于期刊图表、Nature/Cell列宽、'让这张图达到出版标准'、字体嵌入、图dpi、面板组合、色盲友好颜色。

论文图表导出工具 是什么?

该技能解决了学术图表返工中最常见的三个问题:以任意尺寸导出后再缩放导致尺寸不符、未嵌入或不符合期刊要求的字体、以及不适合色盲读者的配色方案。它允许用户在导出前以毫米为单位固定图表尺寸,输出嵌入字体的矢量PDF和指定dpi的PNG,并生成导出清单。同时,该技能提供两个独立的检查器(Python,仅使用标准库),分别用于审计最终文件(验证尺寸、dpi、字体嵌入)和检查调色板是否对常见色盲类型(红色盲、绿色盲、蓝色盲)有足够的区分度。该技能主要面向R用户(需要ggplot2和systemfonts),同时也支持patchwork组合面板和svglite导出SVG,检查器需要Python 3环境。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/harshameghadri/claude-bioinfo-skills/tree/HEAD/skills/paper-figure-export

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

出版级图表导出 (R)

大多数图表返工源于三个可避免的问题:以任意尺寸导出随后缩小、字体未嵌入或不符合期刊要求、以及不适合色盲读者的配色方案。本技能在导出前以毫米为单位固定尺寸,导出嵌入字体的矢量PDF以及指定dpi的PNG,记录导出内容,并提供两个独立检查器(Python,仅标准库),从而直接从文件本身验证结果。

环境要求:R 需安装 ggplot2 和 systemfonts(可选:patchwork 用于组合面板,svglite 用于 SVG);检查器需要 python3;pdffonts/pdfinfo(poppler)可改善 PDF 检查结果,安装后即被使用。路径均相对于本技能文件夹。

操作步骤

  1. 在绘图前确定目标尺寸。 选择期刊和列宽(JOURNAL_MM$nature[["single"]] 为 89 mm;参见 references/journal-sizes.md)、最大高度和 dpi。记录下来,这些将用于导出和审计调用。
  2. 使用辅助主题和调色板构建图形。
    source("scripts/paper_figure.R")
    p <- ggplot(d, aes(x, y, colour = group)) + geom_point() +
         scale_colour_manual(values = okabe(3, skip_black = TRUE)) + theme_paper()
    
    theme_paper() 使用 8 pt 基础字号,6 pt 坐标轴文本,7 pt 图例,0.3 mm 线条和 10 pt 加粗面板标签。pf_font() 会选择 Arial、Helvetica 或兼容度量的 Liberation Sans,具体取决于系统中安装的字体,并在回退到通用 sans 时给出提示。在一篇论文的所有图中,为每个实体使用一种颜色。okabe(n) 最多支持 8 种颜色:超出此范围应使用分面、形状或直接标签。
  3. 组合面板(可选)。 pf_row(list(a, b), tags = c("A","B")) 和 pf_stack(list(row1, row2), heights = c(1, 1)) 分别独立构建每一行,这样一行的对齐不会扭曲下一行;标签会跨行连续编号。
  4. 导出。 pf_save(p, "fig1", width_mm = 89, height_mm = 70, outdir = "figures", formats = c("pdf","png"), dpi = 300, note = "n = ... per group; error bars show ...") PDF 使用 Cairo 设备(字体嵌入;如果没有 Cairo 则会警告并回退)。note 会在图下方生成一行换行说明,用于标注样本量、重复定义和统计信息。figure_manifest.tsv 文件将生成在 outdir 中,记录每个文件的名称、格式、路径、尺寸、dpi 和 md5 值。运行 pf_session("figures/sessionInfo.txt") 以保留包版本信息。
  5. 审计文件,而非意图。 python3 scripts/figure_audit.py figures/fig1.png figures/fig1.pdf --expect-width-mm 89 --max-height-mm 170 --expect-dpi 300 退出码为 4 并显示 FAIL 表示尺寸、dpi 或字体嵌入有误。SKIP 表示检查无法运行(例如没有 pdffonts);这不视为通过。
  6. 检查调色板(当你使用非 okabe() 的颜色时): python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15 它会模拟红色盲、绿色盲和蓝色盲视觉,并报告最接近的颜色对。退出码为 4 表示两种颜色变得过于相似。这仅是一种筛查启发式方法;请同时使用色盲模拟器或灰度模式查看图形,并且对于细线或小点,不要仅依赖颜色(应添加形状或直接标签)。
  7. 以最终尺寸查看图形(以 100% 比例打印 PNG 或以物理宽度打开 PDF)。小于期刊最小要求的文字、重叠的标签以及被裁剪的坐标轴标题只有在这种方式下才能被发现。

可防止已知失败的规则

  • 尺寸在导出时以毫米为单位设置(width_mm);切勿重新缩放导出的文件以适应要求。
  • 对图形使用矢量 PDF,PNG 仅用于预览或纯栅格内容;照片和具有大量单元格的热图可能需要在最终 dpi 下使用栅格图层。
  • 文字大小:保持在期刊允许范围内(Nature 要求 5-7 pt)。geom_text/annotate 的尺寸单位为 mm:使用 pt_to_geom(6)。
  • 在图例或图注中说明样本量 n 以及什么是重复;误差棒必须标明其含义。
  • 不要将项目结论或项目特定的标签嵌入共享辅助工具中:将这些保留在调用 pf_save 的分析脚本中。
  • 字体:安装 Arial/Helvetica 或 Liberation Sans;缺少的字体会在导出时静默地变为其他字体族。pf_env_check() 会打印使用的字体。

输出

<outdir>/<name>.pdf|png|svg|tiff、figure_manifest.tsv,可选 sessionInfo.txt;审计和调色板报告输出至标准输出。

测试

bash tests/run.sh(27 个测试):生成的图形将审计精确的像素宽度、记录的 dpi、以 mm 为单位的页面尺寸和嵌入字体;未嵌入字体的普通 pdf() 导出必须被检出;错误的尺寸、错误的 dpi、缺少 dpi 元数据、损坏的文件和错误的参数必须按文档中的退出码失败;调色板检查器必须通过 Okabe-Ito 并在 deuteranopia 下检测出红/绿对失败。依赖 R 的测试在缺少 R 环境时将被跳过。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能