Community影像github.com

論文圖表匯出

以指定的實際物理尺寸、內嵌字體、色盲友善的 Okabe-Ito 調色板、300+ dpi PNG、圖說註記及匯出清單,將 R (ggplot2/patchwork) 圖表匯出為可出版等級的圖檔,接著稽核檔案(尺寸以毫米為單位、dpi、內嵌字體)並檢查調色板的色覺缺陷。使用於期刊圖表、Nature/Cell 欄寬、『讓這張圖達到論文等級』、字體內嵌、圖表 dpi、面板組合、色盲友善色彩。

論文圖表匯出 是什麼?

此技能提供了一個完整的端到端流程,將 R 圖表轉換為出版就緒的圖檔。它強制以毫米為單位指定尺寸,使用 cairo 設備內嵌字體,並產生向量 PDF 與高 dpi PNG。內建 Python 檢查器會根據實際檔案驗證尺寸、dpi 與字體內嵌,並模擬色覺缺陷檢查調色板,確保符合色盲友善標準。支援 `ggplot2`、`patchwork` 與 `svglite`,並包含輔助主題 (`theme_paper()`)、調色板 (`okabe()`) 與圖說註記功能,讓匯出流程標準化。這項技能對於投稿至 Nature、Cell 等期刊、需要嚴謹遵守字型、尺寸與可及性規範的研究人員特別有用。

相容平台~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,僅使用標準函式庫),從檔案本身驗證結果。

需求:具備 ggplot2 與 systemfonts 的 R(選用:patchwork 用於組合,svglite 用於 SVG);用於檢查程式的 python3;pdffonts/pdfinfo (poppler) 可增強 PDF 檢查,若已安裝則會使用。路徑均相對於此技能資料夾。

步驟

  1. 先設定目標再開始繪圖。 選擇期刊與欄位(JOURNAL_MM$nature[["single"]] 為 89 毫米;參考 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 毫米線條與 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 的尺寸單位為毫米:請使用 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 不存在時會被跳過。

Individual skills in this repo

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

相關技能