SecondOrderZeroOneDecomposition

class probly.quantification.decomposition.zero_one.SecondOrderZeroOneDecomposition(distribution: SecondOrderDistributionLike)[source]

Bases: AdditiveDecomposition, Generic

Zero-one proper scoring rule decomposition of second-order uncertainty.

The components are defined for a second-order categorical distribution Q with Bayesian model average theta_bar = E_{theta ~ Q}[theta]:

  • Total uncertainty: 1 - max_k theta_bar_k.

  • Aleatoric uncertainty: E_{theta ~ Q}[1 - max_k theta_k].

  • Epistemic uncertainty: E_{theta ~ Q}[max_k theta_k - theta_{argmax_k theta_bar_k}].

The decomposition is additive: total == aleatoric + epistemic.

property aleatoric: AU

The aleatoric uncertainty of the decomposition.

canonical_notion[source]

alias of TotalUncertainty

property components: list[type[Notion]]

The components of the decomposition.

distribution: SecondOrderDistributionLike
property epistemic: EU

The epistemic uncertainty of the decomposition.

get(k[, d]) → D[k] if k in D, else d.  d defaults to None.
get_canonical() → Notion[source]

Return the canonical notion of the decomposition.

get_notion(notion: type[N]) → N[source]

Return the component corresponding to the given notion.

items() → a set-like object providing a view on D's items
keys() → a set-like object providing a view on D's keys
property total: TU

The total uncertainty of the decomposition.

values() → an object providing a view on D's values