math-figure-generator

前提条件

• 図の種類、ソース資料、対象とする主張が明確になっていること。
• タイプ 3 の主張は人間が確認済みであること。
• 投稿用の図には、最終版として確定したエビデンスを使用すること。

参照資料

要求されたチャートに必要なものだけを読み込みます。

• references/chart-patterns.md
• references/color-systems.md
• references/layout-guide.md
• references/render-check.md

ワークフロー

1. ソースファイルと、プロットする変数・単位を正確に確認します。
2. 主張を伝えるために必要な、最小限のチャート形式を選びます。
3. 決定論的なコードを使って生成します。matplotlib を推奨します。
4. 編集可能なソースコードと、要求された出力形式で保存します。
5. 共通の色、タイポグラフィ、サイズ、ラベルの規則を適用します。
6. 最終出力をレンダリングし、目視で確認します。
7. クリッピング、重なり、判読しにくいテキスト、誤解を招く軸、凡例、空のパネル、ソースと主張の不一致を確認します。
8. レンダリングのチェックに合格するまで修正を繰り返します。

出力先

• タイプ 1/2 の探索：results/Qx/experiments/roundN/figures/
• タイプ 3/4 の投稿：paper/figures/

一貫性のある説明的なファイル名を使用します。タイプ 1 の診断用図を論文ディレクトリにコピーしないでください。

図の要件

• 該当する場合、ラベルに単位を含めます。
• キャプションには、何を示しているか、またエビデンスに裏付けられた結論を、因果関係を誇張せずに記載します。
• ベースラインは視覚的に区別できるようにしますが、誇張はしません。
• 主張に不確実性が含まれる場合は、不確実性を示します。
• タイプ 3 のラスター出力は 300 dpi 以上とします。互換性がある場合はベクター出力を優先します。
• アクセシビリティとグレースケールでの識別性を考慮します。

ルール

• プロットした値を捏造したり、手作業で変更したりしないでください。
• 集中度、不確実性、または否定的な結果が見えにくくなるチャート形式を使用しないでください。
• 誤解を招くような軸の切り詰めをしないでください。
• 装飾目的の 3D 効果を付けないでください。
• コードを実行しただけで、レンダリングの確認が済んだとみなさないでください。
• 診断用と論文用の役割を分けてください。

検証

• ソース、主張、タイプ、対象セクションが一致していること。
• レンダリングの目視確認に合格していること。
• 論文に掲載する最終サイズでテキストが読みやすいこと。
• 凡例、色、マーカー、軸、単位、キャプションに一貫性があること。
• 最終出力のパスが存在し、図の計画に記録されていること。