HORIZON HASKELLDocslts/ghc-10.0.x8fef28d2026-11-02Search packagesCtrl K
Theme: |

GHC 10.0.0.20260917 · lts/ghc-10.0.x · 8fef28d · 2026-11-02

Modulenumeric-prelude-0.4.4Haskell98

Number.Quaternion

Quaternions

Contents
  1. Cartesian form
  2. Conversions
  3. Operations
Synopsis

Cartesian form

datadata T a

Quaternions could be defined based on Complex numbers. However quaternions are often considered as real part and three imaginary parts.

Instances12Sqr, Eq, Read, Show, C, …
  • C TDefined in numeric-prelude-0.4.4 · Number.Quaternion
  • C a b => C a (T b)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • C a b => C a (T b)Defined in numeric-prelude-0.4.4 · Number.Quaternion

    The (*>) method can't replace scale because it requires the Algebra.Module constraint

  • (C a, Sqr a b) => C a (T b)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • Sqr a b => Sqr a (T b)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • Eq a => Eq (T a)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • Read a => Read (T a)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • Show a => Show (T a)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • C a => C (T a)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • C a => C (T a)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • C a => C (T a)Defined in numeric-prelude-0.4.4 · Number.Quaternion
  • C a => C (T a)Defined in numeric-prelude-0.4.4 · Number.Quaternion
value(+::) :: a -> (a, a, a) -> T a

Construct a quaternion from real and imaginary part.

Conversions

valuetoComplexMatrix :: C a => T a -> Array (Int, Int) (T a)

Map a quaternion to complex valued 2x2 matrix, such that quaternion addition and multiplication is mapped to matrix addition and multiplication. The determinant of the matrix equals the squared quaternion norm (normSqr). Since complex numbers can be turned into real (orthogonal) matrices, a quaternion could also be converted into a real matrix.

Operations

valuescale :: C a => a -> T a -> T a

Scale a quaternion by a real number.

valuenormSqr :: C a => T a -> a

the same as NormedEuc.normSqr but with a simpler type class constraint

valuesimilarity :: C a => T a -> T a -> T a

similarity mapping as needed for rotating 3D vectors

It holds similarity (cos(a/2) +:: scaleImag (sin(a/2)) v) (0 +:: x) == (0 +:: y) where y results from rotating x around the axis v by the angle a.

valueslerp
  1. :: C a
  2. => a

    For 0 return vector v, for 1 return vector w

  3. -> (a, a, a)

    vector v, must be normalized

  4. -> (a, a, a)

    vector w, must be normalized

  5. -> (a, a, a)

Spherical Linear Interpolation

Can be generalized to any transcendent Hilbert space. In fact, we should also include the real part in the interpolation.