pub fn composite_confidence(probabilities: &[f64]) -> Result<f64>Expand description
確率分布から、正規化エントロピーと Top-Margin を統合した複合確信度スコア $S_{\text{confidence}} \in [0.0, 1.0]$ を算出する。
§数理仕様
$$S_{\text{confidence}} = (1.0 - H_{\text{norm}}(p)) \times M(p)$$
- 分布全体が鋭利であり(平坦度 $H_{\text{norm}}$ が小)、かつ第1位と第2位の差分(マージン $M(p)$)が明瞭な場合にのみ 高い確信度を出力する。
- $K=1$ の特異点では $1.0$ を返却する。
- 同率タイブレーク時はマージンが $0.0$ となるため、複合確信度も厳密に $0.0$ に収束する。
- 戻り値は
[0.0, 1.0]の閉区間にクランプされる。
§引数
probabilities: 各候補の確率分布スライス(f64)。
§戻り値
- 成功時は
[0.0, 1.0]にクランプされた複合確信度スコア、不正時はCoreError::MathError。