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
の安全なエスケープ後もグループを曖昧なく区別できます。
- 理論: バイオリンプロット