Sibson Mutual Information
Sibson (or \(\alpha\)-) mutual information generalizes Shannon mutual information. At \(\alpha = 1\) it equals Shannon MI; at \(\alpha = \infty\) it equals maximal leakage from \(X\) to \(Y\).
The measure is asymmetric in \((X, Y)\): the first argument is the source whose marginal \(P(x)\) appears in the sum.
In [1]: from dit.other import sibson_mutual_information, maximal_leakage
In [2]: from dit.example_dists import Xor
In [3]: from dit import Distribution
In [4]: d = Distribution(["00", "11"], [0.5, 0.5])
In [5]: sibson_mutual_information(d, [0], [1], 2)
Out[5]: 1.0000000000000002
In [6]: maximal_leakage(d, [0], [1])
Out[6]: 1.0
Conditional variants
Two conditional Sibson measures from Esposito et al. (2021) are provided:
sibson_conditional_mutual_information_y_given_z— minimizes over \(Q_{Y|Z}\); reduces to unconditional Sibson MI when \(Z\) is constant.sibson_conditional_mutual_information_z— minimizes over \(Q_Z\); symmetric in \(X\) and \(Y\).
- sibson_mutual_information(dist, rvs_X, rvs_Y, order)[source]
Compute the Sibson mutual information of order
order.This is asymmetric in
(X, Y):rvs_Xis the source variable whose marginal appears in the definition (Wu et al., Verdu).- Parameters:
- Returns:
I_a – Sibson mutual information in bits.
- Return type:
- Raises:
ValueError – If
orderis not positive.
- sibson_mutual_information_pmf(p_xy, order)[source]
Compute the Sibson mutual information of order
order.- Parameters:
p_xy (array_like, shape (n_x, n_y)) – Joint PMF with axis 0 indexing
Xand axis 1 indexingY.order (float > 0) – The order
alpha. Use1for Shannon MI andnumpy.inffor maximal leakage.
- Returns:
I_a – Sibson mutual information in bits.
- Return type:
- Raises:
ValueError – If
orderis not positive.
- maximal_leakage(dist, rvs_X, rvs_Y)[source]
Maximal leakage from
XtoY.Equivalent to Sibson mutual information of order infinity.
- sibson_conditional_mutual_information_y_given_z(dist, rvs_X, rvs_Y, rvs_Z, order)[source]
Conditional Sibson MI minimizing over
Q_{Y|Z}(Esposito et al., Def. 3).Reduces to unconditional Sibson MI when
Zis constant (Esposito et al., Def. 3).- Parameters:
- Returns:
I_a – Conditional Sibson mutual information in bits.
- Return type: