# Module: tfg.geometry.transformation.quaternion

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/graphics/blob/master/tensorflow_graphics/geometry/transformation/quaternion.py) |

This module implements TensorFlow quaternion utility functions.

A quaternion is written as \\(q = xi + yj + zk + w\\), where \\(i,j,k\\) forms the
three bases of the imaginary part. The functions implemented in this file
use the Hamilton convention where \\(i\^2 = j\^2 = k\^2 = ijk = -1\\). A quaternion
is stored in a 4-D vector \\(\[x, y, z, w\]\^T\\).

More details about Hamiltonian quaternions can be found on [this page.](https://en.wikipedia.org/wiki/Quaternion)

> [!NOTE]
> **Note:** Some of the functions expect normalized quaternions as inputs where \\(x\^2 + y\^2 + z\^2 + w\^2 = 1\\).

## Functions

[`between_two_vectors_3d(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/between_two_vectors_3d): Computes quaternion over the shortest arc between two vectors.

[`conjugate(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/conjugate): Computes the conjugate of a quaternion.

[`from_axis_angle(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/from_axis_angle): Converts an axis-angle representation to a quaternion.

[`from_euler(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/from_euler): Converts an Euler angle representation to a quaternion.

[`from_euler_with_small_angles_approximation(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/from_euler_with_small_angles_approximation): Converts small Euler angles to quaternions.

[`from_rotation_matrix(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/from_rotation_matrix): Converts a rotation matrix representation to a quaternion.

[`inverse(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/inverse): Computes the inverse of a quaternion.

[`is_normalized(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/is_normalized): Determines if quaternion is normalized quaternion or not.

[`multiply(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/multiply): Multiplies two quaternions.

[`normalize(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/normalize): Normalizes a quaternion.

[`normalized_random_uniform(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/normalized_random_uniform): Random normalized quaternion following a uniform distribution law on SO(3).

[`normalized_random_uniform_initializer(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/normalized_random_uniform_initializer): Random unit quaternion initializer.

[`relative_angle(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/relative_angle): Computes the unsigned relative rotation angle between 2 unit quaternions.

[`rotate(...)`](https://www.tensorflow.org/graphics/api_docs/python/tfg/geometry/transformation/quaternion/rotate): Rotates a point using a quaternion.