pyriemann.utils.tangentspace.transport

pyriemann.utils.tangentspace.transport(X, A, B, metric='riemann')

Parallel transport.

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}\), according to a metric.

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)

Matrices in tangent space.

Andarray, shape (n, n)

Initial SPD/HPD matrix.

Bndarray, shape (n, n)

Final SPD/HPD matrix.

metricstring | callable, default=”riemann”

Metric used for parallel transport, can be: “euclid”, “logeuclid”, “riemann”, or a callable function.

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

Matrices in tangent space transported from A to B.

Notes

Added in version 0.10.