hoi.metrics.InfoTopo#

class hoi.metrics.InfoTopo(x, y=None, verbose=None)[source]#

Topological Information.

The multivariate mutual information \(I_{k}\) quantify the variability/randomness and the statistical dependences between variables is defined by :

\[I_{k}(X_{1}; ...; X_{k}) = \sum_{i=1}^{k} (-1)^{i - 1} \sum_{ I\subset[k];card(I)=i} H_{i}(X_{I})\]

Warning

\(I_{k}(X_{1}; ...; X_{k}) > 0 \Rightarrow Redundancy\)
\(I_{k}(X_{1}; ...; X_{k}) < 0 \Rightarrow Synergy\)

Parameters:

xarray_like: Standard NumPy arrays of shape (n_samples, n_features) or (n_samples, n_features, n_variables)

References

Baudot et al., 2019 [4]; Tapia et al., 2018 [22]

Attributes:

entropies: Entropies of shape (n_mult,)
multiplets: Indices of the multiplets of shape (n_mult, maxsize).
order: Order of each multiplet of shape (n_mult,).
undersampling: Under-sampling threshold.

Methods

`compute_entropies`([method, minsize, ...])	Compute entropies for all multiplets.
`fit`([minsize, maxsize, method])	Compute Topological Information.
`get_combinations`(minsize[, maxsize, astype])	Get combinations of features.

__iter__()#: Iteration over orders.

compute_entropies(method='gcmi', minsize=1, maxsize=None, fill_value=-1, **kwargs)#

Compute entropies for all multiplets.

Parameters:

method{‘gcmi’, ‘binning’, ‘knn’, ‘kernel}

Name of the method to compute entropy. Use either :

‘gcmi’: gaussian copula entropy [default]. See hoi.core.entropy_gcmi()

‘binning’: binning-based estimator of entropy. Note that to use this estimator, the data have be to discretized. See hoi.core.entropy_bin()

‘knn’: k-nearest neighbor estimator. See hoi.core.entropy_knn()

‘kernel’: kernel-based estimator of entropy see hoi.core.entropy_kernel()

minsizeint, optional

Minimum size of the multiplets. Default is 1.

maxsizeint, optional

Maximum size of the multiplets. Default is None.

fill_valueint, optional

Value to fill the multiplet indices with. Default is -1.

kwargsdict, optional

Additional arguments to pass to the entropy function.

Returns:

h_xarray_like: Entropies of shape (n_mult, n_variables)
h_idxarray_like: Indices of the multiplets of shape (n_mult, maxsize)
orderarray_like: Order of each multiplet of shape (n_mult,)

property entropies#: Entropies of shape (n_mult,)

fit(minsize=1, maxsize=None, method='gcmi', **kwargs)[source]#

Compute Topological Information.

Parameters:

minsize, maxsizeint | 2, None

Minimum and maximum size of the multiplets

method{‘gcmi’, ‘binning’, ‘knn’, ‘kernel}

Name of the method to compute entropy. Use either :

‘gcmi’: gaussian copula entropy [default]. See hoi.core.entropy_gcmi()

‘binning’: binning-based estimator of entropy. Note that to use this estimator, the data have be to discretized. See hoi.core.entropy_bin()

‘knn’: k-nearest neighbor estimator. See hoi.core.entropy_knn()

‘kernel’: kernel-based estimator of entropy see hoi.core.entropy_kernel()

kwargsdict | {}

Additional arguments are sent to each entropy function

Returns:

hoiarray_like: The NumPy array containing values of higher-rder interactions of shape (n_multiplets, n_variables)

get_combinations(minsize, maxsize=None, astype='jax')#

Get combinations of features.

Parameters:

minsizeint: Minimum size of the multiplets
maxsizeint | None: Maximum size of the multiplets. If None, minsize is used.
astype{‘jax’, ‘numpy’, ‘iterator’}: Specify the output type. Use either ‘jax’ get the data as a jax array [default], ‘numpy’ for NumPy array or ‘iterator’.

Returns:

combinationsarray_like: Combinations of features.

property multiplets#

Indices of the multiplets of shape (n_mult, maxsize).

By convention, we used -1 to indicate that a feature has been ignored.

property order#: Order of each multiplet of shape (n_mult,).

property undersampling#: Under-sampling threshold.

Examples using `hoi.metrics.InfoTopo`#

Metrics example 1

hoi.metrics.InfoTopo#

Examples using hoi.metrics.InfoTopo#

Examples using `hoi.metrics.InfoTopo`#