# arian/Array.Math

Add all kind of mathematical methods to the Array Native
JavaScript
Fetching latest commitâ€¦
Cannot retrieve the latest commit at this time.
 Failed to load latest commit information. Source Specs Tests .gitignore .gitmodules README.md package.yml screenshot.png

# Array.Math

Array.Math is a collection of calculation with arrays. You can do all kind of things with arrays. You can see them as data for statistic analysis, you can see them as vectors and matrices for linear algebra, or just use them for calculus like add, subtract and products or more advanced calculus with sequences.

The next steps are Vectors and Matrices. The aim is to be able to calculate eigenvalues and eigenvectors from a given Matrix. Singular Value Decomposition would be nice as well. To do this, JavaScript needs to be extended so it can handle Complex numbers, this can be found in Complex.js

To be sure all the methods work as expected, there is a Specs folder that contains some tests.

## How to use

### Array:toNumbers

Transforms each value of the array to a number.

``````#JS
['1', '13', '300'].toNumbers(); // [1, 13, 300]
``````

### Array:sortNumbers

Sorts an array as numbers. The sort method usually transforms each value to a string and lexically compares the values. This will result that '10' will before '2'. This is a quick method to fix that.

``````#JS
[99, 2, 4, 40, 10].sortNumbers(); [2, 4, 10, 40, 99]
``````

### Array:sum

Sum all the entities of the array

``````#JS
[2, 5, 1, 6].sum(); // 14
[2, 5, 2, 7, 7, 12, 8].sum([start], [length])
``````

### Array:product

Get the product of the array and a number or an array with the same size

``````#JS
[2, 5, 6, 2].product(3); // [6, 15, 18, 6]
[2, 5, 6, 2].product([3, 7, 1, 5]); // [5, 12, 7, 7]
``````

### Array:quotient

Get the quotient of the array and a number or an array with the same size

``````#JS
[9, 12, 15].quotient(3) // [3, 4, 5]
[9, 12, 15].quotient(3, 4, 5) // [3, 3, 3]
``````

### Array:power

Get the power of each entity in the array

``````#JS
[3, 6, 2].power(3) // [27, 216, 8]
[2, 2, 2].power([3, 4, 5]) // [8, 16, 32]
``````

Add a number to each entity in the array

``````#JS
[2, 5, 1].add(4) // [6, 9, 5]
[2, 5, 1].add([1, 2, 3]) // [3, 7, 4]
``````

### Array:subtract

Subtract a number to each entity of the array

``````#JS
[6, 9, 5].subtract(4) // [2, 5, 1]
[2, 7, 4].subtract([1, 2, 3]) // [1, 5, 1]
``````

### Array:count

Count the number of entities in the array

``````#JS
[1, 3 , 56, 3, 56].count() // 5
``````

### Array.range

Fill the array with a range of numbers

``````#JS
[].range(2, 5) // [2, 3, 4, 5]
[].range(1, 8, 2) // [1, 3, 5, 7]
``````

### Array:sequence

Create a sequence

``````#JS
//A function with a return
[].sequence(function(n){
return Math.pow(-1, n);
}, [start], [length]);

// A recursive function without a return
// Fibonacci
[1, 1].sequence(function(n){
this[n + 2] = this[n] + this[n + 1];
}, [start], [length]);
``````

### Array:median

Find the median of a array of numbers

``````#JS
[1, 5, 2, 8, 7].median() // 5
[1, 5, 2, 8, 7, 2].median() // 3.5
``````

### Array:variance

Find the variance of an array of numbers

``````#JS
[3, 7, 7, 19].variance() // 36'
``````

### Array:stdDeviation

Find the standard deviation

``````#JS
[3, 7, 7, 19].stdDeviation() // 6
``````

### Array:transpose

Transpose the matrix (swap the rows and columns)

``````#JS
[ [1, 2, 3], [4, 5, 6], [7, 8, 9] ].transpose() // [ [1, 4, 7], [2, 5, 8], [3, 6, 9] ]
``````

### Array:dot

Find the dot product between two vectors

``````#JS
[1, 2, 3].dot([4, 5, 6]) // 32
``````

### Array:cross

Find the cross product between two vectors.

Tip, if you use this in combination with Array.vectorLength(), you will find the magnitude of the vector

``````#JS
[1, 2, 3].cross([4, 5, 6]) // [-3, 6, -6]

// Find the torque about A with arm r and force F
// M = r x A
var M = [1, 2, 1].cross([100, 145, 106]); // [67, -6, 6]
var Mmagnitude = M.vectorLenght(); // 67.53517601961218
``````

### Array:projection

Find the projection of the array on a certain vector For example: you have a vector in a certain direction, and you want to know the vector projected on another vector, for example the vector that describes the x- and the y-axis. This is usefull when you want to devide vector in components (for force analysis).

Tip, if you use this in combination with Array.vectorLength(), you will find the magnitude of the vector

``````#JS
[3, 3].projection([2, 0]) // [3,0]

// Find the force along the x-axis in this 3d space
[600, 263, 768].projection([1, 0, 0]); // [600, 0, 0]

// Find the force along the line in the xy-area with slope 0.5
[600, 235, 267].projection([1, 0.5, 1]);
``````

### Array:determinant

Find the determinant of a square matrix

``````#JS
[[4, 6], [3, 5]].determinant() // 2
[[5, 6, 4], [6, 3, 7], [5, 4, 2]].determinant() // 64
[[5, 3, 2, 2], [9, 5, 2, 9], [6, 8, 9, 4], [0, 6, 3, 4]].determinant() // -692
``````

### Array:vectorLength

Find the vector of a vector

``````#JS
[3, 6, 2].vectorLength() // 7

// Find the magnitude of the force [150, 300, 100] in the 3d space
[150, 300, 100].vectorLength();
``````

### Array:normalize

Get the normalized vector, so that the vector length is 1

``````#JS
[8, 6].normalize() // [4/5, 3/5]
``````

### Array:angle

Find the angle between two vectors

``````#JS
[3, 7, 1].angle([3, 3, 6]) / Math.PI // 0.2798476073884561 pi
``````

### Array.slope()

Get the slope between two points (2d only, there isn't really such thing as a 3d slope)

``````#JS
[3, 4].slope([5, 8]) // 2
``````

### Array:distance()

Get the distance between two points (more-dimensional)

``````#JS
[4, 1].distance([7, 5]) // 5
``````
Something went wrong with that request. Please try again.