Tunny Icon
TunnyDocs

The next-gen Grasshopper optimization tool.

Box Plot

Box Plot と Violin Plot は、1 つの数値 Value を、必要に応じて Group by で分ける同じ分布分析です。 Box Plot は四分位数、ひげ、外れ値を表示します。

操作

  • Value:目的関数または数値パラメータを 1 つ選びます。候補は目的関数、 数値パラメータの順です。Objective: と Parameter: で出所を区別するため、 同名でも選び分けられます。多目的の Study では分析する目的関数を明示的に選択します。
  • Group by:None は選択した Value の箱を 1 つ表示します。カテゴリパラメータ、 または Optuna で整数・刻み幅付き数値として明示的に宣言されたパラメータを選ぶと、 グループごとに箱を表示します。連続パラメータはグループ化も自動ビン分割もしません。 観測値の繰り返しや整数に見える値だけでは、数値パラメータは候補になりません。
  • Normalize [0,1]:グループ分割前に、選択した Value 列全体の有限な最小値・ 最大値で正規化します。定数列はゼロになります。グループ別の正規化ではありません。

Journal と Optuna データベースからは宣言分布の情報を取得します。 DesignExplorer 形式 CSV の数値パラメータにはそのメタデータがないため、Value には選べますが数値 Group by には選べません。カテゴリとして読み込まれた CSV パラメータはグループ化に使用できます。

選択状態はウィジェットごとに独立しています。選択した Value が利用できない場合は、 最初の目的関数、目的関数がなければ最初の数値パラメータになります。 利用できない Group by は None になります。

図の読み方

Y 軸は選択した Value です。グループ化時の X 軸はパラメータとグループのラベルを 示します。数値グループは数値順、カテゴリグループはラベルによる決定的な順序です。 ラベルは必要に応じて傾き、ズームやパンに追従します。

Value が欠損または非有限の行は除外されます。グループ化時は有効なグループ値がない 行も除外され、Value とグループは常に同じ試行の値を使います。実際の空文字カテゴリは (empty string) と表示され、欠損とは区別されます。通常のラベルが同じでも型が異なる カテゴリは、例えば number: 1 と string: "1" のように区別されます。

箱には有限な Value が 1 つ以上必要です。1 件だけのグループや定数グループも表示し、 有限値がないグループは表示しません。滑らかな密度形状を見るには Violin Plot を使います。密度推定には各グループで有限値が 2 件以上あり、すべて同値でないことが必要です。

CSV 出力

表示した箱ごとに要約を 1 行出力します。列は value、group_by、scale、 group、group_identity、n、mean、min、q1、median、q3、max、whisker_low、 whisker_high、n_outliers です。選択列とグループを曖昧なく識別でき、 統計量は表示中の元スケールまたは正規化スケールです。箱が表示されない場合は出力しません。 group は表示ラベル、group_identity はカテゴリの元の型または数値グループ値を保持する識別子です。 CSV の安全なエスケープによってラベルが変わる場合も、グループを区別できます。