meridian-result-visualization

Meridian の結果可視化

学習済みの Meridian モデルを読み込み、標準的な可視化レポートを生成するためのスキルです。

基本的なワークフロー

対話式チェックポイントのルール

このワークフローでは、重要な対話式チェックポイントが複数回あります。各チェックポイントでは、必ず次の操作を行ってください。

1. 現在提案されている設定、レポートのパス、スクリプトのパス、またはステータスをユーザーに提示し、承認を求めます。
2. 利用可能なユーザー対話ツール（例：ask_question）を使って、準備ができているかユーザーに尋ねます。質問は複数選択式にしてください。チャットに直接テキストを送信してはいけません。
3. ユーザーの返答を待ってから次に進みます。
   • 必須: 最初のプロンプトの指示にかかわらず、すべてのチェックポイントで必ず一時停止してください（ユーザーの依頼に「自律的に実行」「直接実行」「自律的に修正」などの表現が含まれている場合も同様です）。最初の依頼によって、これらの対話式チェックポイントを省略することはできません。
   • 注: チェックポイントでユーザーが「進めてください」「最善と思う方法で実行してください」などの一般的な承認を返した場合は、提案したデフォルト設定で進めてください。

---

1. 初期設定

• シリアライズ済みモデルファイルのパスをユーザーに尋ねます（デフォルトはmeridian_model.binpbです）。
• 次の出力パスをユーザーに尋ねます。
  • モデル結果サマリーレポート（デフォルトはresults_summary.htmlです）。
• 生成する Python スクリプトの希望パスをユーザーに尋ねます。
• レポートのオプション設定（例：結果サマリーの日付範囲）があれば、ユーザーに尋ねます。
• 重要な対話式チェックポイント: 収集したパスと設定をユーザーに提示し、モデルを読み込む前に確認を得ます。

2. モデル読み込みコードの追加

• meridian_serde.load_meridian()を使用してモデルを読み込みます。
• コードテンプレートについてはload_model.mdを参照してください。
• 重要な対話式チェックポイント: モデル読み込みパスの設定と提案する Python コードスニペットをユーザーに提示し、ヘルスチェックの指定に進む前に承認を得ます。

3. モデリング後のヘルスチェックコードの追加（任意）

• reviewer.ModelReviewerを使用してヘルスチェックを実行し、結果を HTML に保存します。
• 小規模／テストモデル: MCMC のドロー数が2未満のモデル（例：R-hat の計算に2サンプル以上が必要なテストモデルやモックモデル）では、ValueErrorを捕捉するか、R-hat の計算を適切にスキップして、ヘルスチェックレポートを問題なく生成します。
• コードテンプレートについてはhealth_check.mdを参照してください。
• 重要な対話式チェックポイント: 提案するヘルスチェックレポートのパスとコードスニペットをユーザーに提示し、結果サマリーの設定に進む前に承認を得ます。

4. モデル結果サマリーコードの追加

• summarizer.Summarizerを使用して HTML の結果サマリーを生成し、ユーザーが指定した設定（例：日付範囲）を適用します。
  • 日付範囲の自動調整: ユーザー指定の日付範囲がモデルの時間座標の範囲外にある場合は、モデルの実際の座標に一致するように日付範囲を切り詰めるか調整します。
  • エラー対処のヒント: sample_priorに関するエラーが発生した場合は、正常に生成できるように、要件を回避または修正します（たとえば、sample_prior=Falseを設定するか、必要なパラメーターを渡します）。
• コードテンプレートについてはresults_summary.mdを参照してください。
• 重要な対話式チェックポイント: 結果サマリーに使用する日付範囲、出力パスの設定、コードスニペットをユーザーに提示し、スクリプトの生成と実行に進む前に承認を得ます。

5. 実行前チェックポイント

• 重要な対話式チェックポイント: 最終的なレポートのパスとスクリプトのパスをユーザーに提示し、結果生成スクリプトを今すぐ実行してよいか、最終確認を求めます。

6. 実行とスクリプトの設定

• 作成した Python スクリプトを、ユーザーが指定したパスに書き込みます。ファイル書き込みツールで書き込んだファイルの確認をユーザーに求められる場合でも、確認を求めないでください。実行前チェックポイントですでに承認を求めているため、追加のプロンプトを表示するとワークフローが一時停止します。
• google-meridian がインストールされている環境の Python インタープリターでスクリプトを実行します。ユーザーが指定したインタープリターがあればそれを使います。指定がない場合は、仮想環境がすでに有効（VIRTUAL_ENV または CONDA_PREFIX が設定済み）なら python3 を使います。そうでなければ、プロジェクトディレクトリに仮想環境（.venv/ または venv/。例：.venv/bin/python3）があればそれを使い、いずれにも該当しない場合は python3 を使います。import meridian が失敗した場合は、マシン内を検索したり、ユーザーに確認せずパッケージをインストールしたりせずに、代わりにどの環境を使うかユーザーに尋ねてください。
• 重大：タスクの最後に、生成されたレポート、スクリプト、出力ディレクトリを削除しないでください。これらはユーザーが求めた納品物であり、保持する必要があります。