Monthly Downloads: 0
Programming language: JavaScript
License: MIT License
Tags: Number    

Quaternion.js alternatives and similar libraries

Based on the "Number" category.
Alternatively, view Quaternion.js alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Quaternion.js or a related project?

Add another 'Number' Library


Quaternion.js - ℍ in JavaScript

NPM Package Build Status MIT license

Quaternion.js is a well tested JavaScript library for 3D rotations. Quaternions can be used everywhere, from the rotation calculation of your mobile phone over computer games to the rotation of satellites and all by avoiding the Gimbal lock. The library comes with examples to make you get started much quicker without worrying about the math behind.


var Quaternion = require('quaternion');

var q = new Quaternion("99.3+8i");
c.mul(1,2,3,4).div([3,4,1]).sub(7, [1, 2, 3]);

HTML5 Device Orientation

In order to create a HTML element, which always rotates in 3D with your mobile device, all you need is the following snippet. Look at the examples folder for a complete version.

var rad = Math.PI / 180;
window.addEventListener("deviceorientation", function(ev) {

  // Update the rotation object
  var q = Quaternion.fromEuler(ev.alpha * rad, ev.beta * rad, ev.gamma * rad, 'ZXY');

  // Set the CSS style to the element you want to rotate
  elm.style.transform = "matrix3d(" + q.conjugate().toMatrix4() + ")";

}, true);


Any function (see below) as well as the constructor of the Quaternion class parses its input like this.

You can pass either Objects, Doubles or Strings.


Calling the constructor will create a quaternion 1-element.

new Quaternion() // 1 + 0i + 0j + 0k

The typical use case contains all quaternion parameters

new Quaternion(w, x, y, z)


Quaternion as angle and vector. Note: This is not equivalent to Quaternion.fromAxisAngle()!

new Quaternion(w, [x, y, z])

Quaternion as an object (it's ok to leave components out)

new Quaternion({w: w, x: x, y: y, z: z})

Quaternion out of a complex number, e.g. Complex.js.

new Quaternion({re: real, im: imaginary})

Quaternion out of a 4 elements vector

new Quaternion([w, x, y, z])

Augmented Quaternion out of a 3 elements vector

new Quaternion([x, y, z])


new Quaternion(55.4);


new Quaternion('1 - 2i - 3j - 4k')
new Quaternion("123.45");
new Quaternion("15+3i");
new Quaternion("i");


Every stated parameter n in the following list of functions behaves in the same way as the constructor examples above

Note: Calling a method like add() without parameters results in a quaternion with all elements zero, not one!

Quaternion add(n)

Adds two quaternions Q1 and Q2

Quaternion sub(n)

Subtracts a quaternions Q2 from Q1

Quaternion neg()

Calculates the additive inverse, or simply it negates the quaternion

Quaternion norm()

Calculates the length/modulus/magnitude or the norm of a quaternion

Quaternion normSq()

Calculates the squared length/modulus/magnitude or the norm of a quaternion

Quaternion normalize()

Normalizes the quaternion to have |Q| = 1 as long as the norm is not zero. Alternative names are the signum, unit or versor

Quaternion mul(n)

Calculates the Hamilton product of two quaternions. Leaving out the imaginary part results in just scaling the quat.

Note: This function is not commutative, i.e. order matters!

Quaternion scale(s)

Scales a quaternion by a scalar, faster than using multiplication

Quaternion dot()

Calculates the dot product of two quaternions

Quaternion inverse()

Calculates the inverse of a quat for non-normalized quats such that Q-1 * Q = 1 and Q * Q-1 = 1

Quaternion div(n)

Multiplies a quaternion with the inverse of a second quaternion

Quaternion conjugate()

Calculates the conjugate of a quaternion. If the quaternion is normalized, the conjugate is the inverse of the quaternion - but faster.

Quaternion pow(n)

Calculates the power of a quaternion raised to the quaternion n

Quaternion exp()

Calculates the natural exponentiation of the quaternion

Quaternion log()

Calculates the natural logarithm of the quaternion

double real()

Returns the real part of the quaternion

Quaternion imag()

Returns the imaginary part of the quaternion as a 3D vector / array

boolean equals(n)

Checks if two quats are the same

boolean isFinite

Checks if all parts of a quaternion are finite

boolean isNaN

Checks if any of the parts of the quaternion is not a number

String toString()

Gets the Quaternion as a well formatted string

Array toVector()

Gets the actual quaternion as a 4D vector / array

Array toMatrix(2d=false)

Calculates the 3x3 rotation matrix for the current quat as a 9 element array or alternatively as a 2d array

Array toMatrix4(2d=false)

Calculates the homogeneous 4x4 rotation matrix for the current quat as a 16 element array or alternatively as a 2d array

Quaternion clone()

Clones the actual object

Array rotateVector(v)

Rotates a 3 component vector, represented as an array by the current quaternion

Quaternion slerp(q)(pct)

Returns a function to spherically interpolate between two quaternions. Called with a percentage [0-1], the function returns the interpolated Quaternion.

Quaternion.fromAxisAngle(axis, angle)

Gets a quaternion by a rotation given as an axis and angle

Quaternion.fromEuler(Φ, θ, ψ[, order="ZXY"])

Gets a quaternion given three Euler angles. The angles are applied from right to left.

So, order ZXY for example means first rotate around Y by ψ then around X by θ and then around Z by Φ (RotZ(Φ)RotX(θ)RotY(ψ)). The order can take the string value ZXY, XYZ or RPY, YXZ, ZYX or YPR, YZX, XZY.


  • axisAngle([0, 1, 0], x)axisAngle([0, 0, 1], y)axisAngle([1, 0, 0], z) = fromEuler(x, y, z, 'YZX')
  • Mathematica RollPitchYawMatrix[{α,β,γ}] = fromEuler(γ, β, α, 'RPY')

Quaternion.fromBetweenVectors(u, v)

Calculates the quaternion to rotate one vector onto the other


Gets a spherical random number



A quaternion zero instance (additive identity)


A quaternion one instance (multiplicative identity)


An imaginary number i instance


An imaginary number j instance


An imaginary number k instance


A small epsilon value used for equals() comparison in order to circumvent double imprecision.


Installing Quaternion.js is as easy as cloning this repo or use one of the following commands:

bower install quaternion


npm install quaternion

Using Quaternion.js with the browser

<script src="quaternion.js"></script>
    console.log(Quaternion("1 + 2i - 3j + 4k"));

Using Quaternion.js with require.js

<script src="require.js"></script>
function(Quaternion) {
    console.log(Quaternion("1 + 2i - 3j + 4k"));

Coding Style

As every library I publish, Quaternion.js is also built to be as small as possible after compressing it with Google Closure Compiler in advanced mode. Thus the coding style orientates a little on maxing-out the compression rate. Please make sure you keep this style if you plan to extend the library.


If you plan to enhance the library, make sure you add test cases and all the previous tests are passing. You can test the library with

npm test

Copyright and licensing

Copyright (c) 2017, Robert Eisele Dual licensed under the MIT or GPL Version 2 licenses.

*Note that all licence references and agreements mentioned in the Quaternion.js README section above are relevant to that project's source code only.