pyriemann.utils.tangentspace.transport_logchol

pyriemann.utils.tangentspace.transport_logchol(X, A, B)

Parallel transport for log-Cholesky metric.

The parallel transport of matrices \(\mathbf{X}\) in tangent space from an initial SPD/HPD matrix \(\mathbf{A}\) to a final SPD/HPD matrix \(\mathbf{B}\) for log-Cholesky metric is given in Proposition 7 of [1].

Warning: this function must be applied to matrices \(\mathbf{X}\) already projected in tangent space with a logarithmic map at \(\mathbf{A}\), not to SPD/HPD matrices in manifold.

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

Symmetric/Hermitian matrices in tangent space.

Andarray, shape (n, n)

Initial SPD/HPD matrix.

Bndarray, shape (n, n)

Final SPD/HPD matrix.

Returns:
X_newndarray, shape (…, n, n)

Matrices in tangent space transported from A to B.

See also

transport

Notes

Added in version 0.10.

References

[1]

Riemannian geometry of symmetric positive definite matrices via Cholesky decomposition Z. Lin. SIAM J Matrix Anal Appl, 2019, 40(4), pp. 1353-1370.