Artifact Animation
追加と再生
Widgets → Artifacts / Data の Artifact Animation をキャンバスへ ドラッグします。Artifact Gallery とは別のウィジェットです。複数配置すると、 異なるアーティファクト番号や表示設定を比較できます。設定は各インスタンスで独立します。
Artifacts ツールバーボタン、または --artifact <directory> で
アーティファクトを読み込みます。ローカル Journal では、明示的なルート指定が
なければ隣接する artifacts/ ディレクトリが自動検出されます。対象は現在の Study
の完了 Trial のビューのみです。同じ Journal の別 Study は含みません。
キャンバス上の選択範囲は再生や解析のフィルターになりません。 再生・出力は Study
の読み込み完了後に利用できます。
Artifact # は、各 Trial の既存エントリのゼロ始まりの番号です。
画像形式の判定より先に番号を選びます。例えば 1 は、画像以外を除いた後の 「2
番目の画像」ではありません。読み取り可能な PNG、JPG、JPEG のみがフレームに
なります。拡張子のない Optuna のファイルは元のファイル名や MIME メタデータで
識別します。欠落、読み取り不能、CSV、GIF、WEBP はスキップします。
対象フレームがない場合は、その旨を表示します。
| 操作 | 動作 |
|---|---|
| Play / Pause | 再生と一時停止。一時停止時は表示フレームを保持します。 |
| Previous / Next | 利用可能な画像フレームを 1 枚ずつ移動します。 |
| Frame スライダー | フレームへ移動します。ラベルは Study 内の Trial 番号です。 |
| Display duration | 対数スライダーまたは数値入力で、通常再生と GIF 共通の表示時間を指定します。20〜10000 ms、10 ms 刻み、既定330 ms。FPS は計算された参考表示で、編集できません。 |
| Loop | 最後から先頭へ戻るか、最後で停止するかを選びます。 |
Frame skip はウィジェットのプレビューと GIF 出力で共通です。0
は全対象画像、 1 は2枚ごと、というように、先頭から N + 1
枚ごとに選択します。最後の対象画像は
必ず含め、通常の間引きで含まれなければ重複なく1枚追加します。設定の上限は対象画像数で
制限します。Play/Pause、Previous/Next、Frame スライダー、Loop
はすべてこの選択列を
使用します。表示される選択枚数と1周の推定時間にも末尾の追加を含めます。
目標秒数や自動調整はありません。
Skip を変更しても現在の画像が選択列に残る場合は保持します。外れる場合は、現在位置 以前で最も近い選択画像へ戻ります。準備処理を安全に切り替え、新しい選択列を出力にも 使用します。飛ばした画像やアーティファクトのない Trial の観測結果は、同期チャートの 解析から除外しません。
順序は Study 内の Trial 番号の昇順です。Journal 全体の ID やファイル名では ありません。番号はゼロ始まりのまま振り直しません。失敗・枝刈り Trial や画像のない Trial によって番号が飛ぶことがあります。Study 切替、再読み込み、アーティファクトの 再スキャンではフレーム一覧を再構築し、安全に再生状態をリセットします。 画像や解析の準備に時間がかかる場合は、古い結果を表示せず準備を待ちます。
画像は表示サイズ・倍率に合わせて準備し、Animation ウィジェット全体で共有する 256 MiB の推定保持画像・テクスチャ・先読みリソース予算内で再利用します。 これはアプリ全体のメモリ上限ではありません。再生中は後続フレーム、一時停止中は 近隣フレームを先読みし、シーク時は新しい位置を優先します。キャッシュから除外した 画像は再読み込みすることがあります。Gallery のキャッシュとは独立しています。 同じファイルを上書きした場合は再読み込み・再スキャンで更新してください。 通知のないファイル変更がすぐに反映される保証はありません。
表示設定
Presentation を開いて設定します。
- Trial number: 実際の Study 内 Trial 番号を画像に重ねて表示します。
- Objective values / Parameter values: 選択した目的関数値・パラメーター値を
画像の隣に表示します。Select … メニューで表示する名前を選びます。
欠落値や非有限値は
—と表示します。 - Pareto 2D: 目的関数が 2 個以上の場合に利用できます。X/Y の目的関数を 選択します。この 2 軸は全目的関数による解析の投影です。
- Optimization History: 選択した目的関数の履歴を表示します。
画像は元の縦横比を維持し、余白で調整します。引き伸ばしや切り抜きはしません。 チャートは画像の隣に配置し、両方有効なら縦に積みます。幅が狭い場合は画像の下へ 配置します。無効な表示項目の領域は予約しません。選択した値やチャートが読めるように ウィジェットをリサイズしてください。埋め込みチャートの軸は固定で、通常の パン・ズーム操作はありません。
同期チャートの読み方
Trial t のフレームでは、Study 内番号が t 以下の観測結果だけを表示します。 アーティファクトのない Trial の結果も含みます。未来の結果は描画しません。 現在の Trial は、そのチャートで有効なデータがある場合に強調表示します。 軸範囲は Study 全体に基づいて固定し、フレームごとの尺度の変動を防ぎます。 軸範囲に未来の値が含まれても、未来の点を表示するわけではありません。
パレート順位・フロントは表示 Trial までの結果から求めます。最終 Study の フロントではありません。支配関係は、表示が 2 軸でも、最小化・最大化の方向を 考慮した 全目的関数で判定します。後の Trial に支配されると点はフロントから 外れ、前へシークすると当時のフロントに戻ります。目的関数の欠落値・非有限値を 含む Trial はパレート解析から除外します。制約付き Study のフロントには確認済みの Feasible のみが入ります。Infeasible と Feasibility unverified は 別カテゴリーとして表示します。
履歴は実際の Study 内 Trial 番号と、選択した目的関数の有限値を使用し、 同じ実行可能性カテゴリーを区別します。Best Value は目的関数だけを基準にした 累積最小・最大値で、有限な Infeasible・Feasibility unverified の結果も含みます。 確認済みの実行可能な結果だけの最良値ではありません。
GIF 出力
Export GIF で保存先を選びます。現在の停止・シーク位置に関係なく、 最初の選択フレームから出力します。Frame skip で指定した、ウィジェットの通常再生と 同じ時系列の選択列を出力します。先頭と最後の対象画像を含み、末尾は重複させません。 出力前に Play や Frame スライダーでその列を確認できます。
間引いたフレームでも、チャートは その Trial 番号以下の全観測を含みます。 飛ばした画像やアーティファクトのない Trial の結果も除外しません。 Display duration は通常再生と共通の GIF フレーム間隔を正確なミリ秒で指定し、 Loop は繰り返しを指定します。
出力中は開始したウィジェットの再生・設定変更が一時停止します。Study、 アーティファクト一覧、選択値、軸、テーマ、表示設定のスナップショットを、 保護された固定サイズの表示領域で、通常表示と同じコンテンツ描画を使って出力します。 GIF に含まれるのは画像と有効な値・注記・チャートです。再生ボタン、設定、 周囲のキャンバスや別パネルは含みません。元画像の大きさが違っても出力サイズは一定です。
進捗表示と Cancel は応答を維持します。Escape でもキャンセルできます。 全フレームの確認後は Finalizing GIF… を表示し、完成ファイルを確定する短い間は キャンセルを無効にします。 完了・キャンセル・エラーのどの場合も元の再生・設定状態へ戻ります。 エンコードはバックグラウンドで 1 フレームずつ実行し、全フレームのキャプチャと エンコードが成功した場合のみ保存先を置き換えます。必要な画像を準備できない 場合は、スナップショットのフレーム列を黙って変更せず出力を中止します。 既にキャッシュした画像は、元ファイルの変更後も利用されることがあります。
キャプチャ中はウィンドウサイズやディスプレイ倍率を変更しないでください。 保護領域にコンテンツが収まらない場合は、ウィジェットをリサイズするかキャンバスを ズームアウトして再試行してください。キャプチャ失敗、タイムアウト、書き込みエラーは ウィジェットと GIF export error ダイアログに表示します。
GIF はパレット形式のため色が量子化されることがあります。フレーム間隔の精度は GIF の 10 ミリ秒単位で、指定する表示時間も同じ刻みです。入力は PNG/JPEG のみで、 GIF/WEBP アニメーションや MP4/動画出力には対応しません。