対応ストレージ形式
対応形式
Tunny Dashboard は、以下のデータソースを変換なしで直接読み込めます。
| 形式 | 拡張子 / 指定 | 説明 |
|---|---|---|
| Optuna Journal ファイル | .log |
Optuna の JournalStorage が出力する追記型の操作ログファイルです。 |
| Optuna SQLite データベース | .db / .sqlite / .sqlite3 |
Optuna の RDBStorage が SQLite で出力したファイルです。 |
| Optuna RDB 接続 URL | — | Optuna の RDBStorage の PostgreSQL / MySQL バックエンドは URL で読み込みます(例: postgresql://user:pass@host:5432/db や mysql://user:pass@host:3306/db)。 |
| DesignExplorer 形式 CSV | *.csv |
DesignExplorer アプリケーションが出力する CSV 形式です。1 行が 1 トライアルで、in:<name> はパラメーター列、out:<name> は目的関数列です。任意の img 列にはアーティファクトの相対パスを指定します。 |
サーバーデータベースへの接続は PostgreSQL と MySQL のみ対応しています。
補足
- ファイルは読み取り専用で開くため、他の場所で実行中の最適化に属するデータベースも安全に閲覧できます。
- 手動の Reload は、Journal、SQLite、PostgreSQL / MySQL に対応しています。ボタンを押すと、開いているストレージを再読み込みし、新しいトライアルを必要なときに取得できます。
- DesignExplorer 形式 CSV は、最適化方向とパラメーター範囲をユーザーが確認して読み込む、一度限りのインポートです。Reload には対応していません。
最適化中の読み込み
SQLite、PostgreSQL、MySQL から 1 つの Study を読み込む際は、関連するメタデータ、 トライアルデータ、ユーザー属性、制約、中間値を、データベースの単一の整合した スナップショットから取得します。読み取り中に別のプロセスが変更をコミットしても、 異なる時点のデータが混在しません。読み取りトランザクションはデータ取得中だけ維持され、 テーブルへの変換や分析の前に終了します。結果の閲覧中は維持されません。
スナップショットは最初のデータ読み取り時に確立され、Open や Reload を押した瞬間とは限りません。その後の書き込みと自動同期する機能ではありません。 後から加わった変更を取得するには Reload を使用します。各 Study は独立して読み込まれ、複数の Study を同一時点のスナップショットとして取得するわけではありません。
MySQL でこの整合性が対象とするのは、InnoDB テーブルを使う通常の Optuna データベースです。他のストレージエンジンや混在構成への保証ではありません。 読み取り専用であっても、取得中にデータベースへの書き込みや保守処理が待機しないことを 保証するものではありません。
記録された値と目的関数名
Journal の読み込みでは、目的関数値、中間値、ユーザー属性に記録された数値の
Infinity、-Infinity、NaN を保持します。入れ子の属性も対象です。読み込んだ
元データでは、これらを明示的な null や値の欠落と区別します。"Infinity"
のような引用符付きの文字列は文字列のままです。CSV
でも、数値のユーザー属性と推論された列では inf、-inf、NaN
などの非有限値を保持します。
値を保持することは、すべてのグラフや数値計算手法が無限大の入力に対応することを
意味しません。手法ごとの有限値フィルタリングや分析方針は従来どおりです。
JSON のみの出力では非有限数を忠実に表現できず、null
に正規化される場合があるため、元データに null
が記録されていた、あるいは値が欠落していたとは判断できません。この Journal
の動作は、すべてのデータベースバックエンドが非有限値のユーザー属性を
受け付けることを意味しません。
Journal の後方に指標名が記録されている場合は、目的関数の既存ラベルを置き換えます。 目的関数列を重複して追加したり、パラメーター列の順序を変えたりはしません。 同じラベルの目的関数が複数あっても、目的関数インデックスに従って別々の値を保持します。 ラベルだけで目的関数を識別するわけではありません。
多目的レポートの候補
レポートでは、COMPLETE
のトライアルからすべての目的関数値が有限の行を選んだ後に、
各目的関数の最小化・最大化の方向に従って非劣判定を行います。いずれかの目的関数値に
Infinity、-Infinity、NaN を含むトライアルは、この比較に参加しません。
読み込んだ元データには、記録された値を保持します。
- 制約のない Study: 有限値の行の中で非劣の集合が、レポートの前面になります。
- すべての目的関数値が有限で、Feasible と確認された行がある制約付き Study: その行だけを対象に前面を求めます。Infeasible や Feasibility unverified のトライアルは、制約充足を確認した前面には入りません。
- すべての目的関数値が有限で、Feasible と確認された行がない制約付き Study: 有限値の行の中で、目的関数値だけによる非劣候補を使用します。Feasible と確認されたトライアルが存在しても、それぞれに少なくとも 1 つの非有限の目的関数値があれば、このフォールバックを使用します。
- すべての目的関数値が有限の行がない場合: 前面の候補はありません。
フォールバックの項目には Objective-only candidates (not a verified feasible Pareto front) と表示され、各トライアルの実際の制約充足状態を保持します。 この場合、レポートの制約充足を確認した前面の件数はゼロです。フォールバックの選択は Study の Feasible と確認されたトライアル数を変更しません。非有限の目的関数値を持つ Feasible なトライアルも Feasible の件数に含まれ、フォールバック候補によって その件数が増えることはありません。ここでの非劣性は、レポートが選んだ有限値の集合に 対するものであり、記録された全トライアルに対するものではありません。 これはレポートの候補選択のルールであり、すべてのグラフや分析手法に共通する 有限値の入力方針ではありません。