numbers
Advanced Mathematics Library for JavaScript
npm install numbers
Want to see pretty graphs? Log in now!
8 | downloads in the last day |
119 | downloads in the last week |
249 | downloads in the last month |
Maintainers | |
---|---|
Version | 0.4.0 last updated a year ago |
Keywords | math, mathematics, numbers, statistics |
Repository | git://github.com/sjkaliski/numbers.js (git) |
Homepage | https://github.com/sjkaliski/numbers.js |
Dependencies | None |
Dependents | invoice-generator |
Starred by | rwoody |
numbers.js
Numbers - an advanced mathematics toolkit for JavaScript and Node.js developed by Steve Kaliski, @sjkaliski
Description
Numbers provides a comprehensive set of mathematical tools that currently are not offered in JavaScript. These tools include:
- Basic calculations
- Calculus
- Matrix Operations
- Prime Numbers
- Statistics
- More...
A few things to note before using: JavaScript, like many languages, does not necessarily manage floating points as well as we'd all like it to. For example, if adding decimals, the addition tool won't return the exact value. This is an unfortunate error. Precautions have been made to account for this. After including numbers, you can set an error bound. Anything in this will be considered an "acceptable outcome."
The primary uses cases are client side operations which the DOM will recognize (e.g. 1.1px == 1px). It can be used for data analysis, calculations, etc. on the server as well.
How to use
Numbers is pretty straightforward to use.
With node, simply require it:
var numbers = require('numbers');
For example, if we wanted to estimate the integral of sin(x) from -2 to 4, we could:
Use riemann integrals (with 200 subdivisions)
var numbers = require('numbers');
numbers.calculus.riemann(Math.sin, -2, 4, 200);
Or use adaptive simpson quadrature (with epsilon .0001)
numbers.calculus.adaptiveSimpson(Math.sin, -2, 4, .0001);
User-defined functions can be used too:
var myFunc = function(x) {
return 2*Math.pow(x,2) + 1;
}
numbers.calculus.riemann(myFunc, -2, 4, 200);
numbers.calculus.adaptiveSimpson(myFunc, -2, 4, .0001);
Now say we wanted to run some matrix calculations:
We can add two matrices
var array1 = [0, 1, 2];
var array2 = [3, 4, 5];
numbers.matrix.addition(array1, array2);
We can transpose a matrix
numbers.matrix.transpose(array);
Numbers also includes some basic prime number analysis. We can check if a number is prime:
//basic check
numbers.prime.simple(number);
//elliptic analysis (good for huge numbers)
numbers.prime.elliptic(number);
The statistics tools include mean, median, mode, standard deviation, random sample generator, correlation, confidence intervals, t-test, chi-square, and more.
numbers.statistic.mean(array);
numbers.statistic.median(array);
numbers.statistic.mode(array);
numbers.statistic.standardDev(array);
numbers.statistic.randomSample(lower, upper, n);
numbers.statistic.correlation(array1, array2);
For further documentation, check out our JSDoc
Test
To execute, run:
npm test
Build
To update the public JavaScript, run
make build
This will compile the entire library into a single file accessible at public/numbers.js. It will also minify the file into public/numbers.min.js.
Core Team
- Steve Kaliski - @sjkaliski
- David Byrd - @davidbyrd11
- Ethan Resnick - @studip101
Contributors
In no particular order:
- Ethan aka
altercation
- Hrishikesh Paranjape aka
hrishikeshparanjape
- Greg Leppert aka
leppert
- Lars-Magnus Skog aka
ralphtheninja
- Tim Wood aka
codearachnid
- Miles McCrocklin aka
milroc
- Nate Kohari aka
nkohari
- Eric LaForce aka
elaforc
- Kartik Talwar aka
KartikTalwar
- btmills aka
btmills
- swair shah aka
swairshah
- Jason Hutchinson aka
Zikes
- Philip I. Thomas aka
philipithomas
- Brandon Benvie aka
Benvie
- Larry Battle aka
LarryBattle