PowerPoint では足りないときの、TikZ による研究用の図

パイプライン、オートマトン、可換図式を TeX で描くとよい場面。ジャーナルに合わせて色を変えられ、印刷でも鮮明で、ソースとしてリポジトリに残せます。

PowerPoint の図は、PDF の中でぼやけた四角形になります。TikZ の図はベクタのままで、文書のフォントと揃い、ジャーナルがグレースケールや別のアクセントカラーを求めても色を変えられます。代わりに、最初の 1 時間は少し急な学習曲線を登ることになります。それを越えれば、小さな修正はテキストの差分で済み、スクリーンショットの発掘作業をしなくてすみます。

すべての図に TikZ が要るわけではありません。写真、顕微鏡の生データのフレーム、matplotlib の密度の高いプロットは、たいてい PDF / PNG として読み込んだままにします。TikZ を使うのは、図が構造であるとき、つまりパイプライン、オートマトン、アーキテクチャの箱、圏論の図式、簡単な木構造などです。

小さく始める

3 ノードのパイプラインで、基本の考え方が分かります。

\usepackage{tikz}
\usetikzlibrary{positioning,arrows.meta}
\begin{tikzpicture}[node distance=1.5cm]
\node[draw] (a) {Data};
\node[draw,right=of a] (b) {Model};
\node[draw,right=of b] (c) {Loss};
\draw[-Latex] (a) -- (b) -- (c);
\end{tikzpicture}

ノードには名前を付けます。接続は -- か、明示的なアンカー ((a.east)) で行います。あとで思い出せなくなる謎の座標より、相対配置 (right=of a) のほうが適しています。レッスン: 最初の TikZ の図、ノードと矢印。

個別のオプションよりスタイル

スタイルを一度定義しておけば、すべての箱がそろいます。

\tikzset{
block/.style={draw, rounded corners, align=center, minimum height=1cm},
arr/.style={-Latex}
}

ジャーナルがより太い線や単色を求めてきたら、20 個のノードではなく、スタイルを変更します。色は名前付きの色か小さなパレット用マクロで指定すると、16 進コードを探し回らずにアクセントカラーを入れ替えられます。

コンピュータサイエンスと工学: 揃ったフローチャート

箱が同じグリッドに乗るように、positioning ライブラリ (below=of、right=of) を使います。絶対座標を手で書くと、ノードを 1 つ挿入しただけで図が崩れていきます。テキストは短くし、詳細はキャプションに書きます。ガイド: 揃ったフローチャート。

ニューラルネットワークやシステムのスケッチでは、「ブロック」と「注釈」を分けます。注釈は枠のない小さなフォントのノードにすると、2 段組の幅でも主経路が読みやすいままです。

数学と理論: 可換図式

圏論スタイルの図式を、すべてのノードを手で配置せずに描くなら、tikz-cd が定番です。

\usepackage{tikz-cd}
\begin{tikzcd}
A \arrow[r,"f"] \arrow[d,"g"'] & B \arrow[d,"h"] \\
C \arrow[r,"k"'] & D
\end{tikzcd}

ガイド: 可換図式。木構造や証明論の図式には専用のライブラリがあります。CTAN の半分を取り込む前に、まず単純なものから始めましょう。

externalize とコンパイル時間

TikZ の図が 20 個ある論文は、全体のコンパイルが遅くなります。対策は次のとおりです。

  • 図ごとに専用のファイルに入れて \input する。
  • external ライブラリを使い、図をキャッシュされた PDF にする。
  • 文章だけを見たいときは、\tikzexternaldisable でドラフト作業をする。

スライド用には、standalone の TikZ 文書を PDF にコンパイルし、スライド作成ツールが PDF を受け付けない場合に限って PNG に変換します。正本はあくまで .tex のソースです。

キャンバスツールと手書きの TikZ

研究向けエディタの中には、編集可能な TikZ を出力する図のキャンバスを備えたものがあります (たとえば Oleafly のダイアグラムコンポーザー: 描く、コードを調整する、図をコンパイルする、挿入する)。ドラッグして決められる幾何的な配置には便利です。ぴったり詰めた可換図式や、規則的なグリッドでは、やはり手書きの TikZ が勝ります。どちらの場合でも、PNG だけでなく TikZ のソースをコミットしてください。

図をリポジトリに置く

図のソースは論文の隣に保管します。

figures/
pipeline.tex
pipeline.pdf % optional build product; often gitignored

ジャーナルがより太い線を求めたら、ソースを編集して再コンパイルします。共著者がスライドツールでスクリーンショットを「改善」してしまったら、唯一の編集可能なバージョンは失われています。

よくある失敗

2 段組での図のはみ出しはよくあります。\resizebox による拡大縮小は最後の手段にし、まず幅に合わせて作り直してください。フォントの不一致もあります。ジャーナルが求める場合を除き、TikZ の中にフォントファミリーを直書きするより、文書の既定のフォントを使ってください。発表用にはコントラストを確認します。プロジェクターで見えなくなる薄いグレーは典型的な落とし穴です。そしてラベルのない矢印は、すべての辺をキャプションで説明させることになり、図が不完全だということです。

レイヤーとオーバーレイ

発表と論文で図を共有する場合は、レイヤーに分けて図を作ります。まずベースの箱、次に矢印、最後にラベルです。配置のデバッグ中は、レイヤーをコメントアウトします。ノード名を安定させておけば、Beamer のオーバーレイ (\pause、\onslide) で、同じ TikZ のソースからパイプラインを 1 ステップずつ見せられます。

アクセシビリティと印刷

意味を赤と緑の違いだけで伝えないでください。形や線のスタイルも使います。図をグレースケールで確認しましょう。読者が色覚に特性がある場合や、白黒の研究室のプリンタで印刷する場合でも、キャプションが通じるようにします。

うまくいく進め方

30 秒だけ紙にスケッチし、主張を示せる最小限の TikZ を作ります。スタイルを一度定義して使い回します。図だけでコンパイルし、見た目が整うまで調整してから、論文に取り込み、主張はキャプションに担わせます。.tex をコミットします。

1 回きりの研究室ミーティングなら、PowerPoint でかまいません。ジャーナルが印刷する PDF には、色を変えられるベクタのソースのほうが、「編集可能なファイルを送ってもらえますか」というやり取りをもう一度繰り返すよりずっとましです。

すべての投稿