Tunny Icon
TunnyDocs

The next-gen Grasshopper optimization tool.

Violin Plot

Violin Plot は Box Plot と同じ Value、 Group by、Normalize [0,1] を使い、選択状態は独立しています。 目的関数または数値パラメータを 1 つ選び、Group by = None なら分布を 1 つ表示します。 カテゴリパラメータ、Optuna で明示的に宣言された整数・刻み幅付き数値パラメータで グループ化できます。連続パラメータはグループ化もビン分割もしません。 分布メタデータがない CSV 数値パラメータは Value のみ選択可能で、 CSV のカテゴリパラメータはグループ化に使用できます。

正規化はグループ分割前の Value 列全体の有限な最小値・最大値を使い、 各グループの範囲では正規化しません。定数列はゼロになります。 欠損・非有限の Value や、欠損・非有限のグループ値は、同じ試行の対応を保って除外します。 実際の空文字カテゴリは欠損と区別して (empty string) と表示します。 型の異なるカテゴリのラベルが衝突する場合、チャートと CSV で一貫して区別します。 利用できない Value は最初の目的関数、なければ最初の数値パラメータになり、 利用できない Group by は None になります。

図の読み方

塗りつぶした各バイオリンは、グループ内の Value のガウスカーネル密度推定です。 Y 軸は Value、X 軸のラベルはグループを示します。数値グループは数値順、 カテゴリグループはラベルによる決定的な順序です。 各バイオリンの最大幅は同じで、中央値マーカーを表示します。幅は試行数を表しません。

有限値が 2 件未満のグループや定数グループは推定できず、表示から除外します。 全グループが除外される場合も、除外件数と理由を表示します。 KDE バンド幅が非有限またはゼロの場合も推定できません。 1 件だけのグループや定数グループを表示するには Box Plot を使います。

CSV 出力

表示した各バイオリンのグリッド点ごとに 1 行出力します。列は value、 group_by、scale、group、group_identity、grid、density です。 選択した Value、グループ化パラメータ、ラベル、元スケール/正規化スケールは チャートと一致します。各表示グループは 128 グリッド点で、除外グループは出力しません。 全グループが除外される場合は出力しません。 group は表示ラベル、group_identity はカテゴリの元の型または数値グループ値を保持する識別子です。 CSV の安全なエスケープ後もグループを曖昧なく区別できます。