VectiGuide
Installation
# with yarn
yarn add vecti
# or npm
npm install vecti# with yarn
yarn add vecti
# or npm
npm install vectiUsage
TIP
Vectors have two properties, x and y, representing their components. Since vectors are entirely immutable, they are read-only.
To use Vecti, add the following import to your TypeScript file.
Instances of the Vector class can be created by using either its constructor or the static method of. The latter accepts a number array of length 2, with the first element being the x-axis component and the second element being the y-axis component.
const a = new Vector(42, 7)
console.log(a) // == Vector { x: 42, y: 7 }
const b = Vector.of([42, 7])
console.log(b) // == Vector { x: 42, y: 7 }const a = new Vector(42, 7)
console.log(a) // == Vector { x: 42, y: 7 }
const b = Vector.of([42, 7])
console.log(b) // == Vector { x: 42, y: 7 }Addition
Two vectors can be added using the add method.
const a = new Vector(0, 1)
const b = new Vector(1, 0)
const c = a.add(b)
console.log(c) // == Vector { x: 1, y: 1 }const a = new Vector(0, 1)
const b = new Vector(1, 0)
const c = a.add(b)
console.log(c) // == Vector { x: 1, y: 1 }Subtraction
Two vectors can be subtracted using the subtract method. The parameter is the subtrahend and the instance is the minuend.
const a = new Vector(2, 1)
const b = new Vector(1, 0)
const c = a.subtract(b)
console.log(c) // == Vector { x: 1, y: 0 }const a = new Vector(2, 1)
const b = new Vector(1, 0)
const c = a.subtract(b)
console.log(c) // == Vector { x: 1, y: 0 }Multiplication
Vectors can be multiplied by scalars using the multiply method.
const a = new Vector(1, 0)
const b = a.multiply(2)
console.log(b) // == Vector { x: 2, y: 0 }const a = new Vector(1, 0)
const b = a.multiply(2)
console.log(b) // == Vector { x: 2, y: 0 }Division
Vectors can be divided by scalars using the divide method. The parameter is the divisor and the instance is the dividend.
const a = new Vector(4, 2)
const b = a.divide(2)
console.log(b) // == Vector { x: 2, y: 1 }const a = new Vector(4, 2)
const b = a.divide(2)
console.log(b) // == Vector { x: 2, y: 1 }Dot product
The dot product of two vectors can be calculated using the dot method.
const a = new Vector(2, 3)
const b = new Vector(1, 3)
const c = a.dot(b)
console.log(c) // == 11const a = new Vector(2, 3)
const b = new Vector(1, 3)
const c = a.dot(b)
console.log(c) // == 11Cross product
The cross product of two vectors can be calculated using the cross method. The cross product of two vectors a and b is defined as a.x * b.y - a.y * b.x.
const a = new Vector(2, 1)
const b = new Vector(1, 3)
const c = a.cross(b)
console.log(c) // == 5const a = new Vector(2, 1)
const b = new Vector(1, 3)
const c = a.cross(b)
console.log(c) // == 5Hadamard product
The Hadamard product of two vectors can be calculated using the hadamard method.
const a = new Vector(2, 1)
const b = new Vector(1, 3)
const c = a.hadamard(b)
console.log(c) // == Vector { x: 2, y: 3 }const a = new Vector(2, 1)
const b = new Vector(1, 3)
const c = a.hadamard(b)
console.log(c) // == Vector { x: 2, y: 3 }Length
The length of a vector can be calculated using the length method.
TIP
Length is defined as the L2 norm.
const a = new Vector(1, 0)
console.log(a.length()) // == 1
const b = new Vector(-3, 4)
console.log(b.length()) // == 5const a = new Vector(1, 0)
console.log(a.length()) // == 1
const b = new Vector(-3, 4)
console.log(b.length()) // == 5Normalization
A normalized version of a vector can be calculated using the normalize method. The resulting vector will have a length of 1.
const a = new Vector(2, 0)
console.log(a.length()) // == 2
const b = a.normalize()
console.log(b) // == Vector { x: 1, y: 0 }
console.log(b.length()) // == 1const a = new Vector(2, 0)
console.log(a.length()) // == 2
const b = a.normalize()
console.log(b) // == Vector { x: 1, y: 0 }
console.log(b.length()) // == 1Rotation
Vectors can be rotated by radians or degrees using the methods rotateByRadians and rotateByDegrees respectively.
WARNING
Due to the rotation using Math.sin and Math.cos, rounding errors can occur. Notice that in the example below, the resulting x-component is 6.123233995736766e-17 and not 0 as expected.
const a = new Vector(1, 0)
console.log(a.rotateByDegrees(90)) // == Vector { x: 6.123233995736766e-17, y: 1 }
console.log(a.rotateByRadians(Math.PI / 2)) // == Vector { x: 6.123233995736766e-17, y: 1 }const a = new Vector(1, 0)
console.log(a.rotateByDegrees(90)) // == Vector { x: 6.123233995736766e-17, y: 1 }
console.log(a.rotateByRadians(Math.PI / 2)) // == Vector { x: 6.123233995736766e-17, y: 1 }Chaining
Vecti encourages chaining methods to achieve readable and concise calculations.
import { Vector } from 'vecti'
const vector = new Vector(-5, 0)
.normalize()
.rotateByDegrees(180)
.add(Vector.of([0, 1]))
.multiply(42)
console.log(vector) // == Vector { x: 42, y: 41.99999999999999 }import { Vector } from 'vecti'
const vector = new Vector(-5, 0)
.normalize()
.rotateByDegrees(180)
.add(Vector.of([0, 1]))
.multiply(42)
console.log(vector) // == Vector { x: 42, y: 41.99999999999999 }