# データをもとに書く

分析の入力、スクリプト、表、原稿の結果を、つながったまま保ちます。

結果の段落は、その裏にある計算が近くにあるほうが信頼しやすくなります。研究プロジェクトを使って、分析の手順とその出力を、原稿のそばに置いておきます。

## プロジェクトを設定する

**再現可能な分析**のひな形を選びます。[データのフォルダをリンク](/docs/linked-folders/)すると、調査ツールが、元の測定値を論文の中に移さずに読み取れます。

分析を頼む前に、列の意味、単位、除外した項目を記録しておきます。

## アシスタントに範囲を決めた仕事を任せる

`/oleafly-data-analysis` か、**分析**の[調査タスク](/docs/research-tasks/)を使います。

> リンクした Data フォルダの測定値を読んでください。analysis-plan.md の方法で、2 つの条件を比べてください。スクリプトと、単位付きの表と、除外した項目を説明するメモを保存してください。入力データは変更しないでください。

分析スクリプトには、該当するローカルの実行環境とライブラリが必要です。アシスタントにそれらの要件を確認させ、作業を再実行する方法を保存させてください。

## 出力を確認する

スクリプトを読み、選ばれたデータと方法が問いに合っていることを確かめます。結果を受け入れる前に、単位、標本数、欠測値、不確かさを確認します。

表と図は、それを生成したスクリプトと一緒に保管します。[図の準備スキル](/docs/skills/)は、確認済みの結果を原稿用の図に仕上げる助けになります。

[CLI エージェント](/docs/cli-agents/#research-starting-points)では、**再現性チェック**の出発点が、各結果を再現するために何がまだ必要かを尋ねます。コード、データ、ソフトウェアのバージョン、乱数のシード、ビルドの手順です。**図のチェック**は、キャプション、ラベル、軸の単位、読みやすさを確認します。どちらも、エージェントに `research/` へレポートを書かせ、原稿には手を触れさせません。

## ドキュメントの中でコードを実行する

PDF の数値がコードから直接得られるようにするには、レポートを [Quarto または Calepin](/docs/engines/#quarto) で書きます。Quarto は、`.qmd` や `.Rmd` ファイルの中の R、Python、Julia のチャンクを実行し、Calepin は Typst 文書の中のチャンクを実行します。

- コードは、**このプロジェクトでコードを許可**を選ぶまで、プロジェクトごとにオフのままです。コードがオフのとき、Quarto は各チャンクのコードを出力なしで表示し、Calepin はコードを最後に実行したときに保存した結果を表示します。フィルター、ショートコード、`_extensions` フォルダ、レンダリング用スクリプト、インラインの R コードは、オフでもコードを実行するので、それらを使うプロジェクトは、コードを許可するまでコンパイルできません。
- コードがオフで、コンピュータに R がない場合でも、フロントマターのある `.qmd` ファイルはプレビューできます。ただし、フロントマターに `knitr:` キーがある場合は除きます。それ以外の R コードのある文書は、`.Rmd` ファイルを含め、コードがオフでも R が必要です。[cloud.r-project.org](https://cloud.r-project.org/) から R をインストールして、もう一度コンパイルしてください。
- Oleafly には Quarto 1.5 以降が必要です。お使いのものが古い場合、Oleafly は自前のコピーを使うか、**設定 → エンジン → Quarto** からダウンロードするよう求めます。コピーをダウンロードしていない場合、`_quarto.yml` プロジェクトの文書は、代わりにお使いの古い Quarto でビルドされます。
- Python のコードは、プロジェクトに Jupyter がインストールされた `.venv`、`venv`、`env` フォルダがあれば、そのプロジェクト独自の環境で実行され、Calepin はプロジェクトに `.venv` フォルダがあればそれを使います。なければ、**設定 → エンジン → Quarto** の**言語**に一覧された Python で実行されます。
- `pdf` または `beamer` の文書には LaTeX が必要です。TeX がインストールされていない場合は、Oleafly が提案したときに TinyTeX をインストールするか、文書を `format: typst` に切り替えるか、コードを許可したうえで、フロントマターに `pdf-engine: tectonic` を加えて組み込みのエンジンを使います。
- Quarto は、文書と同じ名前の作業用ファイルを隣に書き出します。PDF では `report.tex`、Typst では `report.typ` です。その名前のファイルがすでにある場合、コンパイルは置き換えずに止まり、そのファイルの名前を示します。ファイルの名前を変えるか移動してから、もう一度コンパイルしてください。
- 韓国語、中国語、日本語の文字が PDF から欠けている場合、警告にフォント名が示され、フロントマターに加える 2 行が示されます。そのフォントを指定した `CJKmainfont:` と、`pdf-engine: tectonic` です。そのフォントは組み込みのエンジンに付属するので、両方を加えてください。`pdf-engine: tectonic` は、プロジェクトでコードを許可したあとにだけ機能します。
- ノートブックは最長 1 時間実行できます。それを超えると、Oleafly が停止し、ログに到達したセルが表示されます。そのセルを短くするかキャッシュしてから、もう一度コンパイルしてください。

## 結果を書く

アシスタントに、確認済みの出力だけを使って、結果の段落を下書きさせます。すべての数値を表と照らし合わせ、方法と解釈を分けておきます。

文書をコンパイルし、PDF で、ラベルとキャプションを含む表や図の全体を確認します。
