Tunny Icon
TunnyDocs

The next-gen Grasshopper optimization tool.

外部ツールの最適化

Tunny Dashboard は内蔵 Rust サンプラーで探索を行い、プロセス定義を通して外部ツールを評価します。 Dashboard 自体に Python や Optuna は不要です。評価ツールに必要な実行環境だけを用意してください。

ツール定義と実行設定

New Tool… で定義を作成するか、Optimize Tool… から保存済みの定義 JSON を開きます。 定義にはパラメータ、コマンド、入力形式、目的・制約の抽出方法、任意の前後処理を指定します。 変更のない定義形式、具体例、リトライ、タイムアウト、実行時の詳しい注意点については プロセス連携ガイドを参照してください。

Tool Optimization で変数範囲・精度、順序付きの目的方向、サンプラーとシード、 出力 Journal の保存先と Study 名を設定します。Random は評価数、NSGA-II は集団サイズと世代数を指定します。 Run で実行し、進捗オーバーレイの Cancel で中止できます。 評価エラーは FAIL として記録され、最適化全体は継続します。Journal 書き込みエラーでは実行を中止します。

実行時の注意点

  • シェルは自動起動しません: コマンドは OS のプロセスとして直接起動します。 Windows のバッチファイルは Program に cmd.exe、引数に /C とスクリプトパスを指定してください。 スクリプトには python や sh などのインタープリタを明示してください。
  • Working dir: 空欄なら定義 JSON のある場所ではなく、Dashboard のカレントディレクトリを使います。 Working dir 自体が相対パスの場合も Dashboard のカレントディレクトリが基準です。 入力テンプレートと抽出対象の出力ファイルの相対パスは、本体コマンドの Working dir を基準に解決します。 場所を確実に指定したい場合は絶対パスを使ってください。
  • 出力値: 有限の数値を抽出する必要があります。NaN、無限大、欠損値、単位付きの文字列はトライアル失敗になります。 数値部分だけを取得する抽出方法を指定してください。制約は c <= 0 で実行可能とみなし、 制約違反は評価失敗とは区別して記録します。
  • プロセス連携の制限: 選べる手法は Random と NSGA-II のみです。抽出対象は目的と制約であり、 トライアルごとのユーザー属性の抽出には対応しません。BO 手法については Grasshopper の最適化を参照してください。

並列評価とファイル競合: トライアルは並列に評価されます。Input file template などで固定の入力・出力パスを共有すると、トライアル間でファイル競合が起こります。 ツールのファイル処理を並列評価に安全な作りにしてください。Dashboard がトライアルごとに 別のディレクトリへ自動隔離することはありません。

既存 Study へ新しい結果を追加する

同じ Journal 内の Study 名が衝突すると、デフォルトではエラーになります。 既存 Study へ追加するときだけ、Output の Add results to existing Study (if present) を有効にしてください。 デフォルトは OFF です。同名 Study がなければ新規作成します。

目的の数と、順序付きの Minimize/Maximize 方向が既存 Study と一致しない場合、評価前にエラーになります。 保存済みの方向を暗黙に採用せず、要求を修正してください。現在の定義のラベルが異なっても、 既存の目的名とトライアル記録は変更しません。Journal 全体の ID と Study 内の番号は継続します。

これは記録先の再利用であり、履歴を利用した最適化の再開ではありません。 各実行は新しい最適化として開始し、既存履歴を初期評価、モデル学習、集団、候補の重複排除に使いません。 予算・進捗・成功/失敗数は今回追加する評価だけを数え、履歴の合計は含みません。

同じ Journal への書き込みは準備処理を含め直列化してください。追記準備では、検出できる不正参照、 壊れた・不完全なレコード、Study 削除などの未対応操作を拒否し、修復や採番のやり直しは行いません。 Optuna が正常に残す、拒否された同名作成試行は受け入れ、Study ID を消費しません。 形式上正しい別 Study への誤参照は判別できない場合があります。ファイルシステムのトランザクションや並行 writer の保証はありません。