xdem.coreg.matrix_from_translations_rotations

xdem.coreg.matrix_from_translations_rotations#

xdem.coreg.matrix_from_translations_rotations(t1=0.0, t2=0.0, t3=0.0, alpha1=0.0, alpha2=0.0, alpha3=0.0, use_degrees=True)[source]#

Build rigid affine matrix based on 3 translations (unit of coordinates) and 3 rotations (degrees or radians).

The euler rotations use the extrinsic convention.

Parameters:

  • t1 (float) – Translation in the X (west-east) direction (unit of coordinates).

  • t2 (float) – Translation in the Y (south-north) direction (unit of coordinates).

  • t3 (float) – Translation in the Z (vertical) direction (unit of DEM).

  • alpha1 (float) – Rotation around the X (west-east) direction.

  • alpha2 (float) – Rotation around the Y (south-north) direction.

  • alpha3 (float) – Rotation around the Z (vertical) direction.

  • use_degrees (bool) – Whether to use degrees for input rotations, otherwise radians.

Raises:

ValueError – If the given translation or rotations contained invalid values.

Return type:

ndarray[tuple[Any, ...], dtype[floating[Any]]]

Returns:

Rigid affine matrix of transformation.