mrredbeard / numbers.js

Advanced Mathematics Library ready for standard JavaScript use forked from https://github.com/numbers/numbers.js

numbers.js Forked from http://github.com/sjkaliski/numbers.js compiled/bundled ready for use

Numbers - an advanced mathematics toolkit for JavaScript.

Changed just enough of the original library to get it to work in html out of the box ES5 compliant.

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.

See example

For example, if we wanted to estimate the integral of sin(x) from -2 to 4, we could:

Use Riemann integrals (with 200 subdivisions)

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);

When working with vectors, treat them like single row matrices:

var vector1 = [[1, 0, 0]];

Numbers also includes some basic prime number analysis. We can check if a number is prime:

// basic check
numbers.prime.simple(number);

// Miller-Rabin primality test
numbers.prime.millerRabin(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 numbers.github.io

Core Team

• Steve Kaliski - @stevekaliski
• David Byrd - @thebyrd
• Ethan Resnick - @studip101
• Dakota St. Laurent - @SaintDako
• Kartik Talwar - @KartikTalwar

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
• btmills aka btmills
• swair shah aka swairshah
• Jason Hutchinson aka Zikes
• Philip I. Thomas aka philipithomas
• Brandon Benvie aka Benvie
• Larry Battle aka LarryBattle