Community画像github.com

paper-figure-export

Rから出版物向けの図を作成(ggplot2/patchwork)し、指定した物理サイズ、埋め込みフォント、色覚多様性対応のOkabe-Itoパレット、300 dpi以上のPNG、キャプション注釈、エクスポートマニフェストで出力。その後ファイル(サイズmm、dpi、埋め込みフォント)を監査し、パレットの色覚多様性をチェックします。ジャーナル用図、Nature/Cellのカラム幅、『この図を論文対応に』、フォント埋め込み、図のdpi、パネル構成、色覚多様性対応色に使用します。

paper-figure-export とは?

このスキルは、Rのggplot2とpatchworkを用いて出版物品質の図を生成し、エクスポート後、ファイル自体を監査・検証するためのものです。研究者や論文執筆者がよく直面する問題——任意のサイズで出力して後から縮小する、フォントが埋め込まれていない、色覚多様性未対応のパレット——を解決します。NatureやCellなどのジャーナルが指定するカラム幅(例えばNatureシングルカラム89mm)に合わせた物理サイズで図を出力し、PDF(フォント埋め込み)とPNGを指定dpiで生成。`pf_save()` 関数でエクスポートし、`figure_manifest.tsv` にメタデータを記録します。さらに、Python標準ライブラリのみで動作する独立した監査スクリプト `figure_audit.py` で実寸やフォント埋め込みを、`palette_check.py` で色覚多様性シミュレーション(プロタン、デュータン、トリタン)をチェック。`pf_row` や `pf_stack` でパネルを構成し、タグ「A」「B」などを自動付与します。テストも完備しており、実際の図のピクセル幅やdpiを検証し、エラーを確実に検出します。

対応~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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

論文対応の図エクスポート(R)

図の手直しの多くは、次の3つの回避可能な原因によるものです:任意のサイズでエクスポートし後で縮小する、フォントが埋め込まれていないかジャーナルの指定とは異なる、色覚多様性の読者に判別できないパレット。このスキルでは、最初にサイズをミリメートル単位で固定し、ベクターPDF(フォント埋め込み)と指定dpiのPNGをエクスポートし、何をエクスポートしたかを記録します。さらに、2つの独立したチェッカー(Python、標準ライブラリのみ)を提供し、ファイル自体から結果を検証します。

要件:R(ggplot2 と systemfonts、オプションで patchwork によるパネル構成、svglite によるSVG)、python3(チェッカー用)、pdffonts/pdfinfo(poppler、PDFチェックを強化、インストールされている場合に使用)。パスはこのスキルフォルダーを基準とします。

手順

  1. プロット前に目標を固定する。 ジャーナルとカラムを選択します(JOURNAL_MM$nature[["single"]] は89mm;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)) で各行を独立して作成するため、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 は、サンプルサイズ、反復定義、統計量を示すキャプション行として図の下に折り返して表示されます。outdir 内の figure_manifest.tsv には、名前、形式、ファイル、サイズ、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は2色が類似しすぎていることを意味します。これはスクリーニングのためのヒューリスティックです。色覚多様性シミュレーターやグレースケールでも図を確認し、細い線や小さな点には色のみに頼らず、形状や直接ラベルを追加してください。
  7. 最終サイズで図を見る(PNGを100%で印刷するか、物理的な幅で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を合格とし、デュータノピア下での赤/緑ペアを失敗と判定する必要があります。R依存のテストはRがない場合にスキップされます。

Individual skills in this repo

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

関連スキル