Tunny Icon
TunnyDocs

The next-gen Grasshopper optimization tool.

Rank Plot 2D/3D

概要

Rank Plot 2D は 2 つのパラメータを X/Y 軸に、Rank Plot 3D は 3 つの パラメータを X/Y/Z 軸に表示します。各点は COMPLETE トライアルを表し、目的関数の 生値ではなく、選択した目的関数の ランク百分位(0 = 最良、1 = 最悪)で色付け されます。2D ではパラメータのペアを、3D では第 3 のパラメータを含む組み合わせを 調べられます。

3D キャンバスは、他の 3D 散布図と同様にセレクター下の残りのチャート領域全体を使い、 ウィジェットのサイズ変更に追従します。縦向きの Best/Worst 凡例はプロット横に領域を確保せず、キャンバス右端の内側に重ねて表示します。

コントロール

項目 Rank Plot 2D Rank Plot 3D
パラメータ X/Y。初期値は最初の 2 パラメータ X/Y/Z。初期値は最初の 3 パラメータ
軸の選択 各軸のパラメータを選択 互いに異なる 3 パラメータを選択。他の軸で使用中のパラメータは候補に出ません
必要な入力 2 パラメータ以上、1 目的関数以上 3 パラメータ以上、1 目的関数以上
目的関数 多目的 Study では色付けに使う目的関数を選択 同左

軸は目的関数ではなくパラメータの値です。カテゴリパラメータは、他の散布図と同じ 数値エンコーディングを使います。選択した座標のいずれかが欠損または非有限値 (NaN、正負の無限大)である点は表示しません。

ランクと色

両チャートは、座標の除外や表示サンプルとは独立に、全 COMPLETE トライアルの 選択した目的関数列から同じ方法でランクを計算します。

  • 有限の目的関数値を、最小化/最大化の方向に従って最良から最悪へ並べます。
  • 同じ値には、0 始まりの順位の平均を割り当てます。
  • 有限値が複数ある場合、その平均を「有限値の数 − 1」で割ります。有限値が 1 つ だけの場合はランク 0 です。
  • 欠損や非有限の目的関数値(NaN、+Infinity、-Infinity)はランク 1(最悪)です。 このようなトライアルも、選択した座標がすべて有限なら表示されます。

両チャートは選択中のカラーマップを共有します。Best(ランク 0)は凡例上端の カラーマップ高端、Worst(ランク 1)は凡例下端の低端の色を使います。軸の パラメータを変えても目的関数のランクは変わりません。ランクによる色付けは生値の 外れ値の影響を抑えますが、同順位の点は同じ色になることがあります。

操作

ナビゲーションは チャートの操作方法 に従います。2D はホイール/矩形ズーム、右ドラッグでパン、ダブルクリックで リセットします。3D は右ドラッグで回転、中ドラッグまたは Shift + 右ドラッグで パン、ホイールでズームします。

表示された点をホバーすると、トライアル番号、選択した X/Y(3D は Z も)の パラメータ値、選択した目的関数値、ランク百分位を表示します。点を左クリック すると、共通の Trial Detail モーダルが開き、Rank Percentile、パラメータ値・ 目的関数値、添付アーティファクトを確認できます。

Rank Plot 3D は利用可能な点から決定的にサンプリングし、最大 1,500 点を表示します。 ホバーとクリックの対象は表示された点です。サンプリングでランクは変わりません。

CSV エクスポート

CSV は全 COMPLETE トライアル行を出力します。座標が欠損/非有限の行や、3D の 表示サンプル外の行も含みます。列は trial_id、選択した X/Y パラメータ名 (3D は Z も)、選択した目的関数名、rank_percentile です。欠損/非有限の数値は 空欄になりますが、非有限の目的関数値のランクは 1 です。ファイル名は rank_plot_2d.csv と rank_plot_3d.csv です。

読み方

Best 色の点が多い領域は、有望なパラメータの組み合わせを示唆します。色が混在 する場合は、他のパラメータや相互作用も関係している可能性があります。軸を変え、 3D を回転して重なった点を分離したり、 Importance Chart を確認したりします。 これらは観測結果の表示であり、フィットした曲面や因果関係の証明ではありません。