jinko-task-cmaes

CMA-ES キャリブレーションタスク

確定済みのキャリブレーション仕様を実行します。目的、制約、パラメーターの事前分布、最適化オプション、受け入れ基準を独自に作成しないでください。

前提条件： このスキルには、初期化済みの jinko-sdk 接続と、metadata.requires_sdk の範囲を満たす SDK が必要です。jinko-sdk-setup スキル（../jinko-sdk-setup/SKILL.md）を実行し、そのチェックに合格してから先に進んでください。セッションコードは一度しか交換できないため、このスキル独自の SDK プロセスを開始する前に、もう一度 get_session_code を呼び出してください。このスキルが見つからない場合は、novainsilico/jinko-skills からインストールしてください。

入力

以下が必要です。

• モデル SID
• 物理的な上下限を持つパラメーター事前分布
• seed、thresholdWeightedScore、numberOfIterations、populationSize
• 少なくとも 1 つの適合度ソース：キャリブレーション対応データテーブル、および／または目的を含む高度な出力セット
• 仕様で必要となるプロトコル、シンプルな出力セット、高度な出力セット、フォルダー、名前

定量的なエビデンスがキャリブレーション対応テーブルにまだ変換されていない場合は、jinko-task-extract-data-table を使用してください。jinko-data-table、jinko-output-set、jinko-model、jinko-protocol は、それぞれの Jinkō オブジェクトの操作にのみ使用してください。

ワークフロー

1. すべての入力を、意図された SID とスナップショットに解決します。不足または曖昧な入力は推測せず、提示してください。
2. jinko-calibration-cmaes と同梱の作成スクリプトを使用します。適用する前にドライランの出力を確認してください。パラメーターのエンコーディング、適合度テーブルの適格性、境界のスケーリング、作成、作成後の健全性チェックはスクリプトが担当します。エラーが発生した場合は停止し、警告を提示してください。
3. 作成されたキャリブレーションの SID、リビジョン、スナップショット、URL、有効なオプションを返し、確認を求めてください。
4. 低レベルの実行スクリプトを使用して、起動前の健全性チェック、起動、終端状態になるまでの待機を行います。終端状態のスナップショットを再起動しないでください。意図した変更に対して新しいスナップショットが作成されるよう、構成を作成または更新してください。
5. 低レベルの検査インターフェースを使用して、最終ステータス、停止理由、パフォーマンス、結果の概要、目的の重みを収集します。また、利用可能な場合は optimizationWeightedScore の降順で最初に並ぶ患者を収集してください。患者ごとのスカラー値、時系列、エラー、拡張データテーブルは、結果メタデータに必要なセレクターが含まれている場合にのみ取得してください。

返す内容

以下を返してください。

• キャリブレーションの SID、リビジョン、スナップショット、URL
• 有効な入力参照、事前分布、最適化オプション
• 健全性に関する警告、終端ステータス、停止理由、パフォーマンス
• 対応する結果ペイロードと最良患者の識別情報。後続の結果呼び出しに必要なイテレーションとシナリオアームも含めてください。
• 要求された出力のうち利用できないものについての簡潔な説明

返された API ペイロードに必要なデータが実際に含まれていない限り、個別の実行 ID、収束分析、スコア推移曲線、最良患者のパラメーター値、パラメーター事後分布、シミュレーションとデータの比較プロットがあると主張しないでください。デフォルトでは、ペイロードが対応するプロットを Jinkō のプロットスタイル（jinko.plotting。jinko-trial、references/trial-plots.md を参照）で描画してください。