出版级图表导出 (R)
大多数图表返工源于三个可避免的问题:以任意尺寸导出随后缩小、字体未嵌入或不符合期刊要求、以及不适合色盲读者的配色方案。本技能在导出前以毫米为单位固定尺寸,导出嵌入字体的矢量PDF以及指定dpi的PNG,记录导出内容,并提供两个独立检查器(Python,仅标准库),从而直接从文件本身验证结果。
环境要求:R 需安装 ggplot2 和 systemfonts(可选:patchwork 用于组合面板,svglite 用于 SVG);检查器需要 python3;pdffonts/pdfinfo(poppler)可改善 PDF 检查结果,安装后即被使用。路径均相对于本技能文件夹。
操作步骤
- 在绘图前确定目标尺寸。 选择期刊和列宽(
JOURNAL_MM$nature[["single"]]为 89 mm;参见references/journal-sizes.md)、最大高度和 dpi。记录下来,这些将用于导出和审计调用。 - 使用辅助主题和调色板构建图形。
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 种颜色:超出此范围应使用分面、形状或直接标签。 - 组合面板(可选)。
pf_row(list(a, b), tags = c("A","B"))和pf_stack(list(row1, row2), heights = c(1, 1))分别独立构建每一行,这样一行的对齐不会扭曲下一行;标签会跨行连续编号。 - 导出。
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")以保留包版本信息。 - 审计文件,而非意图。
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);这不视为通过。 - 检查调色板(当你使用非
okabe()的颜色时):python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15它会模拟红色盲、绿色盲和蓝色盲视觉,并报告最接近的颜色对。退出码为 4 表示两种颜色变得过于相似。这仅是一种筛查启发式方法;请同时使用色盲模拟器或灰度模式查看图形,并且对于细线或小点,不要仅依赖颜色(应添加形状或直接标签)。 - 以最终尺寸查看图形(以 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 环境时将被跳过。