論文対応の図エクスポート(R)
図の手直しの多くは、次の3つの回避可能な原因によるものです:任意のサイズでエクスポートし後で縮小する、フォントが埋め込まれていないかジャーナルの指定とは異なる、色覚多様性の読者に判別できないパレット。このスキルでは、最初にサイズをミリメートル単位で固定し、ベクターPDF(フォント埋め込み)と指定dpiのPNGをエクスポートし、何をエクスポートしたかを記録します。さらに、2つの独立したチェッカー(Python、標準ライブラリのみ)を提供し、ファイル自体から結果を検証します。
要件:R(ggplot2 と systemfonts、オプションで patchwork によるパネル構成、svglite によるSVG)、python3(チェッカー用)、pdffonts/pdfinfo(poppler、PDFチェックを強化、インストールされている場合に使用)。パスはこのスキルフォルダーを基準とします。
手順
- プロット前に目標を固定する。 ジャーナルとカラムを選択します(
JOURNAL_MM$nature[["single"]]は89mm;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))で各行を独立して作成するため、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は、サンプルサイズ、反復定義、統計量を示すキャプション行として図の下に折り返して表示されます。outdir内のfigure_manifest.tsvには、名前、形式、ファイル、サイズ、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は2色が類似しすぎていることを意味します。これはスクリーニングのためのヒューリスティックです。色覚多様性シミュレーターやグレースケールでも図を確認し、細い線や小さな点には色のみに頼らず、形状や直接ラベルを追加してください。- 最終サイズで図を見る(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がない場合にスキップされます。