pyriemann.geometry.mean.mean_cheap

pyriemann.geometry.mean.mean_cheap(X, *, tol=1e-07, maxiter=50, sample_weight=None)[source]

Cheap mean of SPD/HPD matrices.

Cheap mean is computed as described in [1].

Parameters:
Xndarray, shape (…, n_matrices, n, n)

Set of SPD/HPD matrices.

tolfloat, default=1e-7

Tolerance to stop the gradient descent.

maxiterint, default=50

Maximum number of iterations.

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

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

Returns:
Mndarray, shape (n, n)

Cheap mean.

See also

gmean

Notes

Added in version 0.12.

References

[1]

A note on computing matrix geometric means D. Bini and B. Iannazzo. Advances in Computational Mathematics. 2011