gaitmap.utils.rotations.find_signed_3d_angle

gaitmap.utils.rotations.find_signed_3d_angle(v1: ndarray, v2: ndarray, rotation_axis: ndarray) → float | ndarray

Find the signed angle (in rad) between two 3D vectors.

Signed means that the angle varies between -180 and 180 deg (or rather -pi and pi) This implementation uses acrtan2 to calculate the angle.

Parameters:

v1

2D or 3D vector or series of vectors

v2

2D or 3D vector or series of vectors

rotation_axis

Axis the rotation is performed around. The direction of this axis also indicates the sign of the angle