論文等級圖表匯出 (R)
多數圖表修改源於三個可避免的問題:以任意尺寸匯出後再縮小、字體未內嵌或非期刊指定字體、以及對色盲讀者不友善的調色板。本技能預先設定好以毫米為單位的尺寸,匯出內嵌字體的向量 PDF 與指定 dpi 的 PNG,記錄所有匯出的內容,並提供兩個獨立的檢查程式(使用 Python,僅使用標準函式庫),從檔案本身驗證結果。
需求:具備 ggplot2 與 systemfonts 的 R(選用:patchwork 用於組合,svglite 用於 SVG);用於檢查程式的 python3;pdffonts/pdfinfo (poppler) 可增強 PDF 檢查,若已安裝則會使用。路徑均相對於此技能資料夾。
步驟
- 先設定目標再開始繪圖。 選擇期刊與欄位(
JOURNAL_MM$nature[["single"]]為 89 毫米;參考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 毫米線條與 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的尺寸單位為毫米:請使用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、頁面尺寸(毫米)與內嵌字體;使用未內嵌字體的單純 pdf() 匯出必須被偵測到;錯誤的尺寸、錯誤的 dpi、缺少 dpi 中繼資料、損毀的檔案與錯誤的參數必須以文件記錄的結束碼失敗;調色板檢查器必須通過 Okabe-Ito 調色板,且在模擬綠色盲下必須偵測紅/綠配對失敗。依賴 R 的測試在 R 不存在時會被跳過。