Package Exports
- vector-object
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vector-object) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Vector Object
This is a n-dimensional vector implementation in javascript. A vector can be created using javascript objects, with the object keys as the components. It is useful for cases like word vector calculations. For example, calculating the cosine similarity of two word vectors.
Installation
npm install vector-object
And then import the Vector class
const Vector = require('vector-object');Major Change Log
1.1.0
The vector operations now would update the instance itself, rather than creating a new vector object. It is for better performance so less objects are created during the calculations. This is a NON-COMPATIBLE change. If you are using versions < 1.1.0, you may need rewrite a bit your code. Sorry for that 🙏🏼
Usage
- constructor
- clone()
- toObject()
- getComponents()
- get(component)
- set(component, value)
- isEqual(vector)
- getDistance(vector)
- getLength()
- getDotProduct(vector)
- getCosineSimilarity(vector)
- normalize()
- add(vector)
- subtract(vector)
- multiply(c)
- divide(c)
- chainability
constructor
create a new vector object
const a = new Vector({ x: 1, y: 2, z: 3 });clone()
return a copy of the vector object
const a = new Vector({ x: 1, y: 2, z: 3 });
const b = a.clone();
console.log(b); // return { x: 1, y: 2, z: 3 }toObject()
return an json object of the vector
const a = new Vector({ x: 1, y: 2, z: 3 });
console.log(a.toObject()); // return { x: 1, y: 2, z: 3 }getComponents()
return array of the components in the vector object
const a = new Vector({ react: 5, angular: 2, vue: 2, marko: 1 });
console.log(a.getComponents()); // return ['react', 'angular', 'vue', 'marko']get(component)
return the value of the component in the vector object
const a = new Vector({ react: 5, angular: 2, vue: 2, marko: 1 });
console.log(a.get('react')); // return 5
console.log(a.get('nextjs')); // return undefinedset(component, value)
set the value of the component in the vector object
const a = new Vector({ react: 5, angular: 2, vue: 2, marko: 1 });
a.set('react', 10);
console.log(a); // return { react: 10, angular: 2, vue: 2, marko: 1 }isEqual(vector)
return a boolean value if the input vector is same as itself
const a = new Vector({ a: 1, b: 2, c: 3 });
const b = new Vector({ a: 1, b: 2, c: 3 });
const c = new Vector({ a: 1, b: 2 });
console.log(a.isEqual(b)); // return true
console.log(a.isEqual(c)); // return false
console.log(c.isEqual(a)); // return falsegetDistance(vector)
return the distance between the target vector and the vector object
const a = new Vector({ a: 1, b: 2, c: 3 });
const b = new Vector({ b: 2, c: 1, d: 2 });
const distance = a.getDistance(b);
console.log(distance); // return 3getLength()
return the length of the vector object
const a = new Vector({ a: 3, b: 4 });
const length = a.getLength();
console.log(length); // return 5getDotProduct(vector)
return the dot product of the input vector and the vector object
const a = new Vector({ a: 1, b: 2, c: 1 });
const b = new Vector({ b: 2, c: 2 });
const dotProduct = a.getDotProduct(b);
console.log(dotProduct); // return 6getCosineSimilarity(vector)
return the cosine similarity (range from 0 to 1, the larger the more similar between the two vectors) of the input vector and the vector object
const a = new Vector({ ant: 1, bird: 2, cat: 3 });
const b = new Vector({ bird: 2, cat: 2, dog: 2 });
const similarityAA = a.getCosineSimilarity(a);
const similarityAB = a.getCosineSimilarity(b);
console.log(similarityAA); // return 1
console.log(similarityAB); // return 0.6236095644623236normalize()
normalized the vector and return itself
const a = new Vector({ a: 3, b: 4 });
a.normalize();
console.log(a); // return { a: 0.6, b: 0.8 }add(vector)
perform additional with the input vector and return itself
const a = new Vector({ a: 1, b: 2 });
const b = new Vector({ b: 1, c: 2 });
a.add(b);
console.log(a); // return { a: 1, b: 3, c: 2 }subtract(vector)
perform subtraction with the input vector and return itself
const a = new Vector({ a: 1, b: 2 });
const b = new Vector({ b: 1, c: 2 });
console.log(a); // return { a: 1, b: 0, c: -2 }multiply(c)
perform multiplication with the input vector and return itself
const a = new Vector({ a: 1, b: 2, c: 1 });
a.multiply(10);
console.log(a); // return { a: 10, b: 20, c: 10 }divide(c)
perform division with the input vector and return itself
const a = new Vector({ a: 1, b: 2, c: 1 });
console.log(a); // return { a: 0.1, b: 0.2, c: 0.1 }chainability
The vector calculation methods are chainable so you can write your expression in the following way:
const a = new Vector({ a: 1, b: 2, c: 1 });
const b = new Vector({ a: 2, b: 1 });
const c = new Vector({ a: 2, b: 1 });
const v = a.clone().add(b).subtract(c).normalize();Test
npm install
npm run test