frites.core.mi_nd_gg#

frites.core.mi_nd_gg(x, y, mvaxis=None, traxis=- 1, biascorrect=True, demeaned=False, shape_checking=True)[source]#

Multi-dimentional MI between two Gaussian variables in bits.

Parameters
x, ynumpy:array_like

Arrays to consider for computing the Mutual Information. The two input variables x and y should have the same shape except on the mvaxis (if needed).

mvaxispython:int | python:None

Spatial location of the axis to consider if multi-variate analysis is needed

traxispython:int | -1

Spatial location of the trial axis. By default the last axis is considered

biascorrectbool | python:True

Specifies whether bias correction should be applied to the estimated MI

demeanedbool | python:False

Specifies whether the input data already has zero mean (true if it has been copula-normalized)

shape_checkingbool | python:True

Perform a reshape and check that x and y shapes are consistents. For high performances and to avoid extensive memory usage, it’s better to already have x and y with a shape of (…, mvaxis, traxis) and to set this parameter to False

Returns
minumpy:array_like

The mutual information with the same shape as x and y, without the mvaxis and traxis