# AI で図を描く

図の内容を言葉で伝え、編集できる TikZ や CeTZ をプレビューして、論文の中で調整します。

アシスタントのチャットで、図が載る論文と並べて図の内容を伝えます。LaTeX プロジェクトでは、アシスタントは TikZ か PGFPlots を書きます。Typst プロジェクトでは、CeTZ、fletcher、または素の Typst を書きます。どちらの場合も、ドキュメントに何かを入れる前に、図だけを単独で描画します。

> 3 段階のパイプラインを描いてください。サンプルの収集、不確かさの推定、予測の比較です。記法は methods.tex のものを使ってください。挿入する前にプレビューしてください。

## 最初に要点を伝える

読者に何を理解してほしいか、どのラベルが重要か、図をどこに置くかを伝えます。関連するプロジェクトのファイルは `@` でメンションします。スケッチがすでにある場合は、プロジェクトに追加し、アシスタントに参考にするよう頼みます。

Typst プロジェクトでは、 **プロンプト**に **CeTZ の図**という出だしの文面があり、依頼文が入力されるので、残りを自分で書き足せます。LaTeX プロジェクトでは、同じ出だしが **TikZ の図**という名前です。

## プレビューと調整

アシスタントは図のソースを書き、単体のプレビューを描画して、エラーが出ればそれをもとに修正します。画像に対応したモデルは、描画された画像も見て、ラベルの重なりがなくなり、間隔が整うまで調整を続けます。変更は同じ会話の中で頼めます。ラベルを短くする、レイアウトを広げる、記法をそろえる、などです。

Typst のプレビューは、プロジェクトで指定した Typst のバージョンを使います。CeTZ や fletcher などのパッケージは通常の Typst のコンパイルと同じように読み込まれるため、プロジェクトでまだ使っていないパッケージは、初回に Typst Universe からダウンロードされます。

図のツールは、Typst プロジェクトと、エンジンが図を単独でコンパイルできる LaTeX プロジェクトで使えます。Markdown プロジェクトでは使えません。チャットの**ツール**ポップオーバーの**図**グループでオフにできます。接続済みのモデルは [AI のセットアップ](/docs/ai-setup/)で選びます。

## 編集できるソースを挿入する

プレビューの出来がよければ、キャプションとラベルを付けて挿入するようアシスタントに頼みます。編集に承認が必要な場合、承認カードには描画された図が表示されるので、何を承認するのかを確認できます。そのあと、論文全体をコンパイルして、収まり具合を確認します。

- LaTeX では、コードは `figure` 環境の中に入り、`\caption` と `\label` が付きます。
- Typst では、コードは `#figure` の中にキャプションとともに入り、ラベルが `<label>` として続きます。図に必要でファイルにまだない `#import` の行は、その上に置かれます。

PNG のコピーも `figures/` に保存されます。ソースはドキュメントに残るので、直接編集することも、もう一度修正を頼むこともできます。対応している TikZ と fletcher の図は、[ダイアグラムコンポーザー](/docs/figures-diagrams/)に読み込んで、キャンバス上で編集することもできます。

## 研究データをプロットする

図がデータセットに依存する場合は、[分析ワークフロー](/docs/workflows/data-analysis/)を使います。再現できるように、プロットの元になったスクリプトとデータの選択を保存するようアシスタントに頼みます。

繰り返す図の作業には、[スキル](/docs/skills/)から `/oleafly-figure-prep` を呼び出します。
