https://github.com/minsithu/num-engine
a statistics package in javascript
https://github.com/minsithu/num-engine
Last synced: 9 months ago
JSON representation
a statistics package in javascript
- Host: GitHub
- URL: https://github.com/minsithu/num-engine
- Owner: MinSiThu
- License: mit
- Created: 2019-12-05T15:05:29.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-12-09T11:34:45.000Z (almost 6 years ago)
- Last Synced: 2025-02-09T08:47:22.086Z (10 months ago)
- Language: JavaScript
- Size: 20.5 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# num-engine
a statistics package in javascript
- lightweight, only 5.83kb
- easy to use
- both browser & node.js
- fast and efficient
# Installation
```
npm install --save num-engine
```
```html
```
```js
//in node.js
let NumEngine = require("num-engine");
let numEngine = new NumEngine([1,2,3,4,5]);
//in browsers
let numEngine = new NumEngine([1,2,3,4,5]);
```
# Documentation
## Quick Start
```js
let NumEngine = require("num-engine"); //browsers don't need this
let numEngine = new NumEngine([1,2,3,4,5],{
sorted:true //default is false
}); // config object is optional
```
*{sorted:true}* should be added for sorted array arguments to improve performance.
# Methods
## sum
return the summation value of the array items
```js
let numEngine = new NumEngine([1,2,3,4,5]);
let result = numEngine.sum(); // 15
```
## product
return the product of array items
```js
let numEngine = new NumEngine([1,2,3,4,5]);
let result = numEngine.product();
```
## min
return the minimal value of array items
```js
let numEngine = new NumEngine([1,2,3,4,5],{sorted:true});
let result = numEngine.min();
```
## max
return the maximum value of array items
```js
let numEngine = new NumEngine([1,2,3,4,5],{sorted:true});
let result = numEngine.max();
```
## mean
return the mean of array items
```js
let numEngine = new NumEngine([1,2,3,4,5],{sorted:true});
let result = numEngine.mean();
```
## gemoerticMean
return the geometric mean of array items
```js
let numEngine = new NumEngine([1,2,3,4,5]);
let result = numEngine.geometricMean();
```
## mode
return mode of array items
```js
let numEngine = new NumEngine([1,2,3,4,5]);
let result = numEngine.mode();
```
## sort
sort the current array in **ascending order** and also return the sorted array
```js
let numEngine = new NumEngine([1,2,3,4,5]);
let result = numEngine.sort();
```
## reverseSort
sort the current array in **descending order** and also return the sorted array
```js
let numEngine = new NumEngine([1,2,3,4,5]);
let result = numEngine.reverseSort();
```
## shuffle
shuffle the current array and also return the shuffled array
```js
let numEngine = new NumEngine([1,2,3,4,5]);
let result = numEngine.shuffle();
```
## median
return the median of aray items
```js
let numEngine = new NumEngine([1,2,3,4,5]);
let result = numEngine.median();
```
## chunk(chunkSize:*number*)
divides the array into sub arrays with **chunkSize length**
```js
let numEngine = new NumEngine([1,2,3,4,5,6]);
let result = numEngine.chunk(2);
/* result is [
[1,2],[3,4],[5,6]
]
*/
```
## **static** differentiate(f:*Function*)
return the 1st ordered differentiated function of given function
```js
NumEngine.differentiate(function(){
return Math.pow(2,2);
})
```
## **static** generateRandomInt(lowerLimit:*number*,upperLimit:*number*)
return a random integer
```js
NumEngine.generateRandomInt(1,10);
```
## **static** generateRandomFloat(lowerLimit:*number*,upperLimit:*number*)
return a random float number
```js
NumEngine.generateRandomFloat(1,10);
```
## **static** generateRandomIntArray(count:*number*,lowerLimit:*number*,upperLimit:*number*)
return a random integer number array
```js
NumEngine.generateRandomIntArray(5,1,10);
```
## **static** generateRandomFloatArray(count:*number*,lowerLimit:*number*,upperLimit:*number*)
return a random float number array
```js
NumEngine.generateRandomFloatArray(5,1,10);
```
## variance
return the variance of the given array
```js
let numEngine = new NumEngine([1,2,3,4,5,6]);
let result = numEngine.variance();
```
## standardDeviation
return the standard deviation of the given array
```js
let numEngine = new NumEngine([1,2,3,4,5,6]);
let result = numEngine.standardDeviation();
```
## **static** factorial(startNumber:*number*)
return the factorial value of a number
```js
NumEngine.factorial(5);
```
## extent
return the min and max value of array items
```js
let numEngine = new NumEngine([1,2,3,4,5,6]);
let result = numEngine.extent(); //[1,6]
```