生物学・ライフサイエンスの論文:図、複数パネルのプレート、共著者

ウェットラボと計算生物学のための実践的な LaTeX:複数パネルの図、解像度、補足資料、統計の記法、互いに上書きし合わない共同作業。

ライフサイエンスの原稿は、図が先です。査読者は文章を読む前にプレートに目を通すので、図はキャプションでごまかさなくても主張を支えられなければなりません。補足資料の締め切り前の午前 2 時に貼り込むものではなく、図をプロジェクトの第一級のファイルとして扱えば、LaTeX はそれを十分にこなします。

ウェットラボの研究グループも計算系のグループも、同じ混乱にぶつかります。スケールバーが揃っていないパネル、ブロット画像の JPEG アーティファクト、コンパイルできない補足資料、1 つの段落を編集する十数人の共著者。以下は、実際にうまくいく方法です。

複数パネルの図

査読者は、1 つのキャプションの下に (a)(b)(c) のパネルが並んでいることを期待します。方法は 2 つあります。

  1. TeX の外でプレートを作り(Illustrator、Inkscape、Fiji の書き出し)、単一の PDF か PNG として取り込む。
  2. 各パネルが別ファイルなら、subcaption で TeX 内で組み立てる。
\usepackage{subcaption}
\begin{figure}[htbp]
\begin{subfigure}{0.48\textwidth}
\includegraphics[width=\linewidth]{a.pdf}
\caption{Control}\label{fig:exp-a}
\end{subfigure}\hfill
\begin{subfigure}{0.48\textwidth}
\includegraphics[width=\linewidth]{b.pdf}
\caption{Treatment}\label{fig:exp-b}
\end{subfigure}
\caption{Overall experiment.}\label{fig:exp}
\end{figure}

本文中でパネルを Figure~\ref{fig:exp}a のように参照するのは、ジャーナルのスタイルが許す場合だけにしてください。多くの投稿先は、全体で一貫した 1 つの方式で「Figure 2A」と書くことを好みます。このパターンの詳細は、パネル a、b、cにあります。

ファイル名は一貫した付け方にして(fig03_western_a.pdf)、投稿の週に誰かが final_gel_NEW.png を作り出すことのないようにします。

解像度、色、ファイル形式

顕微鏡画像のアーカイブは、高解像度の TIFF か PDF で保管します。論文の PDF 自体では、模式図にはベクターグラフィックスを、ラスターデータには十分な dpi の PNG/PDF を使います。線の注釈やゲル画像に JPEG は使わないでください。圧縮アーティファクトは、実験自体に問題がなくても、雑な科学に見えてしまいます。

色にかかる費用と印刷の規則を確認してから、キャリブレーション済みの自分のモニターでしか通用しない 6 色のパレットを設計してください。CMYK を求めるジャーナルもあれば、断りなしに変換して悪い結果になるところもあります。主要な図について、グレースケールでも判読できる版を求められたら、それを提供してください。

スケールバーと強度の単位は、キャプションだけでなくパネルの上に入れてください。制作側が図のレイアウトを組み直しても、埋め込まれたスケールバーは残りますが、キャプションだけの注記は残らないことが多いのです。

模式図とデータパネル

「経路の模式図」と「ブロットの定量」は分けて管理してください。模式図は TikZ でも外部のベクターアートでもかまいません。データパネルは、査読者が別の正規化を求めたときに再生成できるよう、解析からの書き出しに近い場所に置いておきます。ジャーナルが許すなら、解析スクリプトのパスをキャプションの注記か、再現性のための補足資料に書いておきます。

コンパイルできる補足資料

巨大な表、追加のゲル画像、動画のスチル画像は、独立した文書の補足資料か、明確に分けた付録に置きます。頭痛を減らす規則がいくつかあります。

本文と補足資料が 1 回のコンパイルを共有する場合、ラベルは一意でなければなりません。別々のプロジェクトなら、「Figure S3」はプレーンテキストで書き、PDF をまたいだ \ref に頼らないでください。本文のどの主張がどの補足項目を指すのかを短い一覧にしておくと、ずれが起きません。

投稿の週に補足資料がコンパイルできないのは、本文の PDF がきれいに見えていても、やはりあなたの問題です。

多人数の混乱

生物学の論文には、LaTeX の習熟度がまちまちな共著者が大勢いることがよくあります。ファイルをセクションごとに担当し(results.tex、methods.tex、figs.tex)、Git でマージし、誰が .bib を管理するかを決めます(1 人か、共有 Zotero グループからの書き出しか)。

ローカルのプロジェクトフォルダーは、卒業後にアクセスを失うクラウドのプロジェクトより、共同研究者向けに zip にまとめやすいです。本物の Git の履歴は、誰かが手作業で TeX に戻すことになる、manuscript_JM_edits_FINAL.docx という名前のメール添付に勝ります。コンパイルが成功するたびにチェックポイントを作り、マージがうまくいかなかったら復元し、非公開のリモートを持ってください。

Word でしか編集しない共著者がいる場合は、その人たちには DOCX か PDF を書き出して渡し、.tex を正本として保ってください。Word しか使わない共著者を参照してください。

方法と統計の記法

同じ論文の中で p 値が $p$ と p= の両方で現れることのないよう、統計のマクロは一度だけ定義します。

\newcommand{\pvalue}[1]{$p = #1$}
\newcommand{\ci}[2]{95\% CI $[#1, #2]$}

検定、n、多重比較補正は、制作段階で切り取られかねない図の凡例だけでなく、方法の項か表の注記にも書いてください。情報量の多い論文では、記法の短い一覧があると助かります。研究用エディターの ref/cite のライブチェックは、削除したパネルへの \ref を、査読者より先に見つけてくれます。

主張を担うキャプション

よいキャプションは、何を、どの系で測定したか、そして読者が何に注目すべきかを述べます。「本文参照」で済ませないでください。方法の項に属する内容を、キャプションに詰め込まないでください。パネルの文字(太字か括弧か)は、ジャーナルの書式に合わせます。

投稿前の図のチェックリスト

投稿ボタンを押す前に、図を一度通して確認してください。

  • すべての主要な図が、順番どおりに(またはジャーナルが許す順序で)引用されている。
  • パネルにラベルが付いている。必要な箇所にはスケールバーがある。
  • 定量パネルに JPEG の劣化がない。
  • 補足資料がコンパイルでき、S 番号が入れ替わっていない。
  • 色の方針を確認済みで、ファイルサイズがポータルの上限未満である。
  • 元の画像とスクリプトが、プロジェクトか研究室のアーカイブでまだ見つかる。

ウェスタンブロット、ゲル、コントラスト

PDF のために、ブロットを加工しすぎないでください。ジャーナルも読者も、コントラストの操作に目を光らせています。生のファイルは研究室のアーカイブに保管し、定量に使ったものと一致するパネルを提出します。パネルを並べ替えたら、本文中のパネル文字をすべて当日中に更新し、「あとで」にしないでください。

動画とインタラクティブな補足資料

ジャーナルが動画を認めている場合は、指示されたとおりの方法でホストし、PDF にはスチル画像とキャプションを載せます。卒業後に切れてしまう個人のクラウドのリンクに頼らないでください。

図は、これらの論文の背骨です。LaTeX は枠にすぎません。投稿前夜に失敗するのが、その枠であってはなりません。

すべての投稿