Skip to content

A JavaScript class for 2D/3D Cartesian coordinate system manipulation

License

Notifications You must be signed in to change notification settings

DanIsraelMalta/CoordSysJS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

CoordSys

Methods:

* coordinateSystem - create a local coordinate system relative to
                     global coordinate system (0, 0, 0)
* toLocal          - transforms a set of points (x, y, z) from global coordinate system
                     to local coordinate system
* toGlobal         - transforms a set of points (x, y, z) from local coordinate system
                     to global coordinate system

Properties:

* origin           - a 1x3 array defining coordinate system offset (X, Y, Z)
                     from global coordinate systemLanguage
* rotation         - a 3x3 transformation (rotation) matrix defining local coordinate system
                     axes relative to global coordinate system

Notes:

* When constructing a coordinate system using unit vectors (as oppose to Euler angles),
  CoordSys tests to see if these vectors are appropriate to define roataion matrix by:
  1) checking that they are unit vectors
  2) checking that the rotation matrix is orthogonal
  Since this process is time consuming, the user is advised to construct a coordinates
  system using Euler angles or removing the above tests by using the 'fast' method.
* When using the 'fast' method to construct a local coordinate system using Euler angles,
  then the worst accuracy of the trigonometric approximation is 3e-3, but they are at least
  twice faster then javascript builtin standard trigonometric functions.

Example:

An airplane is flying thru the air. Its true air speed is 86 knots, with 4 degrees angle of attack and 2 degrees side slip angle. its pitch is 12 degrees, bank angle is 35 degrees and it is headed on bearing 125 degrees. what is its air speed in body and earth (inertial) coordinate system?

// information
var airSpeed = 86,
    alpha = 4,
    beta = 2,
    pitch = 12,
    roll = 35,
    yaw = 125;

// define a coordinate system in which airplane body is global and measurements are local
var bodyWindCS = new coordinateSystem([0, 0, 0], alpha, 0, beta);

// airspeed in body coordinate system 
var airspeedBody = bodyWindCS.toGlobal([86, 0, 0]);

// define airplane body coordinate system relative to earth (inertial)
var bodyEarthCS = new coordinateSystem([0, 0, 0], pitch, roll ,yaw);

// airspeed in earth coordinate system
var airspeedEarth = bodyEarthCS.toGlobal(airspeedBody);

About

A JavaScript class for 2D/3D Cartesian coordinate system manipulation

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published