pyriemann.utils.mean.mean_harmonic

pyriemann.utils.mean.mean_harmonic(X=None, sample_weight=None, covmats=None)

Harmonic mean of invertible matrices.

\[\mathbf{M} = \left( \sum_i w_i \ {\mathbf{X}_i}^{-1} \right)^{-1}\]
Parameters:
Xndarray, shape (n_matrices, n, n)

Set of invertible matrices.

sample_weightNone | ndarray, shape (n_matrices,), default=None

Weights for each matrix. If None, it uses equal weights.

Returns:
Mndarray, shape (n, n)

Harmonic mean.

See also

mean_covariance