データをもとに書く
分析の入力、スクリプト、表、原稿の結果を、つながったまま保ちます。
結果の段落は、その裏にある計算が近くにあるほうが信頼しやすくなります。研究プロジェクトを使って、分析の手順とその出力を、原稿のそばに置いておきます。
プロジェクトを設定する
「プロジェクトを設定する」セクション再現可能な分析のひな形を選びます。データのフォルダをリンクすると、調査ツールが、元の測定値を論文の中に移さずに読み取れます。
分析を頼む前に、列の意味、単位、除外した項目を記録しておきます。
アシスタントに範囲を決めた仕事を任せる
「アシスタントに範囲を決めた仕事を任せる」セクション/oleafly-data-analysis か、分析の調査タスクを使います。
リンクした Data フォルダの測定値を読んでください。analysis-plan.md の方法で、2 つの条件を比べてください。スクリプトと、単位付きの表と、除外した項目を説明するメモを保存してください。入力データは変更しないでください。
分析スクリプトには、該当するローカルの実行環境とライブラリが必要です。アシスタントにそれらの要件を確認させ、作業を再実行する方法を保存させてください。
出力を確認する
「出力を確認する」セクションスクリプトを読み、選ばれたデータと方法が問いに合っていることを確かめます。結果を受け入れる前に、単位、標本数、欠測値、不確かさを確認します。
表と図は、それを生成したスクリプトと一緒に保管します。図の準備スキルは、確認済みの結果を原稿用の図に仕上げる助けになります。
CLI エージェントでは、再現性チェックの出発点が、各結果を再現するために何がまだ必要かを尋ねます。コード、データ、ソフトウェアのバージョン、乱数のシード、ビルドの手順です。図のチェックは、キャプション、ラベル、軸の単位、読みやすさを確認します。どちらも、エージェントに research/ へレポートを書かせ、原稿には手を触れさせません。
ドキュメントの中でコードを実行する
「ドキュメントの中でコードを実行する」セクションPDF の数値がコードから直接得られるようにするには、レポートを Quarto または Calepin で書きます。Quarto は、.qmd や .Rmd ファイルの中の R、Python、Julia のチャンクを実行し、Calepin は Typst 文書の中のチャンクを実行します。
- コードは、このプロジェクトでコードを許可を選ぶまで、プロジェクトごとにオフのままです。コードがオフのとき、Quarto は各チャンクのコードを出力なしで表示し、Calepin はコードを最後に実行したときに保存した結果を表示します。フィルター、ショートコード、
_extensionsフォルダ、レンダリング用スクリプト、インラインの R コードは、オフでもコードを実行するので、それらを使うプロジェクトは、コードを許可するまでコンパイルできません。 - コードがオフで、コンピュータに R がない場合でも、フロントマターのある
.qmdファイルはプレビューできます。ただし、フロントマターにknitr:キーがある場合は除きます。それ以外の R コードのある文書は、.Rmdファイルを含め、コードがオフでも R が必要です。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 で、ラベルとキャプションを含む表や図の全体を確認します。