What is mathjs?
mathjs is an extensive math library for JavaScript and Node.js. It features a flexible expression parser, a large set of built-in functions, and supports different data types such as numbers, big numbers, complex numbers, fractions, units, and matrices.
What are mathjs's main functionalities?
Basic Arithmetic
Perform basic arithmetic operations like addition, subtraction, multiplication, and division.
const math = require('mathjs');
const sum = math.add(2, 3); // 5
const product = math.multiply(4, 5); // 20
Matrix Operations
Perform operations on matrices such as addition, multiplication, and inversion.
const math = require('mathjs');
const matrix1 = math.matrix([[1, 2], [3, 4]]);
const matrix2 = math.matrix([[5, 6], [7, 8]]);
const result = math.add(matrix1, matrix2); // [[6, 8], [10, 12]]
Complex Numbers
Handle complex numbers and perform arithmetic operations on them.
const math = require('mathjs');
const complex1 = math.complex(2, 3);
const complex2 = math.complex(1, 4);
const sum = math.add(complex1, complex2); // 3 + 7i
Unit Conversions
Convert between different units of measurement.
const math = require('mathjs');
const distance = math.unit(5, 'km');
const convertedDistance = distance.to('mile'); // 3.10685596 mile
Expression Parsing
Parse and evaluate mathematical expressions from strings.
const math = require('mathjs');
const expr = '2 * (3 + 4)';
const result = math.evaluate(expr); // 14
Other packages similar to mathjs
numeric
numeric is a library for numerical computations in JavaScript. It provides functions for matrix operations, solving linear systems, and performing numerical integration. Compared to mathjs, numeric is more focused on numerical methods and less on symbolic computation and unit conversions.
algebrite
algebrite is a JavaScript library for symbolic mathematics. It can perform algebraic operations, calculus, and other symbolic computations. While mathjs also supports some symbolic computation, algebrite is more specialized in this area.
simple-statistics
simple-statistics is a JavaScript library for statistical calculations. It provides functions for descriptive statistics, probability distributions, and regression analysis. Unlike mathjs, which covers a broad range of mathematical functions, simple-statistics is specialized in statistical methods.
http://mathjs.org
Math.js is an extensive math library for JavaScript and Node.js,
compatible with JavaScript's built-in Math library.
Features
- A flexible expression parser.
- Supports numbers, complex numbers, units, strings, arrays*, and
matrices*.
- A large set of built-in functions and constants.
- Easily extensible with new functions and constants.
- Powerful and easy to use.
* Note: arrays and matrices are to be implemented.
Install
Math.js can be installed with npm.
npm install mathjs
Alternatively, the library can be downloaded from github:
math.js, or minified:
math.min.js.
Use
Node.js
Math.js can be loaded in node.js using require
, and similarly in the browser
using require.js.
var math = require('mathjs'),
Complex = math.Complex,
Unit = math.Unit;
var a = math.sin(math.pi / 4);
var b = math.pow(a, 2);
console.log('sin(pi / 4) ^ 2 = ' + math.round(b, 3));
var c = new Complex(3, -4);
var d = math.sqrt(c);
console.log('sqrt(3 - 4i) = ' + d);
var e = math.sqrt(-4);
console.log('sqrt(-4) = ' + e);
var f = new Unit(60, 'deg');
var g = math.cos(f);
console.log('cos(60 deg) = ' + math.round(g, 3));
Browser
Math.js can be loaded as a regular javascript file in the browser:
<!DOCTYPE HTML>
<html>
<head>
<script src="math.js" type="text/javascript"></script>
</head>
<body>
<script type="text/javascript">
var a = math.sqrt(-4);
console.log('sqrt(-4) = ' + a);
</script>
</body>
</html>
Parser
Math.js contains a flexible and easy to use expression parser.
The parser supports all data types, methods and constants available in math.js.
It has a method eval
to evaluate expressions,
and parse
to parse expressions and build a node tree from it.
The parser supports variable and function definitions.
Variables and functions can be manipulated using the methods get
and put
.
The following example code shows how to create and use a parser.
var math = require('mathjs');
var parser = new math.parser.Parser();
var a = parser.eval('sqrt(3^2 + 4^2)');
var d = parser.eval('sqrt(-4)');
var b = parser.eval('2 inch in cm');
var c = parser.eval('cos(45 deg)');
parser.eval('x = 7 / 2');
parser.eval('x + 3');
parser.eval('function f(x, y) = x^y');
parser.eval('f(2, 3)');
var x = parser.get('x');
var f = parser.get('f');
var g = f(3, 2);
parser.put('h', 500);
var i = parser.eval('h / 2');
parser.put('hello', function (name) {
return 'hello, ' + name + '!';
});
parser.eval('hello("user")');
parser.clear();
Data types
Math.js supports both native data types like Number, String, and Array,
as well as advanced data types like Complex and Unit.
Number
The built-in type Number can be used in all methods.
var math = require('mathjs');
var a = math.subtract(7.1, 2.3);
var b = math.round(math.pi, 3);
var c = math.sqrt(new Number(4.41e2));
String
The built-in type String can be used in applicable methods.
var math = require('math.js');
var a = math.add('hello ', 'world');
var b = math.max('A', 'D', 'C');
Complex
Math.js supports complex numbers.
var math = require('math.js'),
Complex = math.Complex;
var a = new Complex(2, 3);
var b = new Complex('4 - 2i');
var c = math.add(a, b);
var d = math.sqrt(-4);
Unit
Math.js supports units.
var math = require('math.js'),
Unit = math.Unit;
var a = new Unit(55, 'cm');
var b = new Unit(0.1, 'm');
var c = math.add(a, b);
var parser = new math.parser.Parser();
var d = parser.eval('2 inch in cm');
Constants
Math.js has the following built-in constants.
- math.E, math.e
- math.I, math.i
- math.LN2
- math.LN10
- math.LOG2E
- math.LOG10E
- math.PI, math.pi
- math.SQRT1_2
- math.SQRT2
Methods
Math.js contains the following methods. The methods support all available data
types (Number, String, Complex, and Unit) where applicable.
Arithmetic
- math.abs(x)
- math.add(x, y)
- math.ceil(x)
- math.cube(x)
- math.divide(x, y)
- math.equal(x)
- math.exp(x)
- math.fix(x)
- math.floor(x)
- math.larger(x, y)
- math.largereq(x, y)
- math.log(x [, base])
- math.log10(x)
- math.mod(x, y)
- math.multiply(x, y)
- math.pow(x, y)
- math.round(x [, n])
- math.sign()
- math.smaller(x, y)
- math.smallereq(x, y)
- math.subtract(x, y)
- math.sqrt(x)
- math.square(x)
- math.unaryminus(x)
- math.unequal(x)
Complex
- math.re(x)
- math.im(x)
- math.arg(x)
- math.conj(x)
Probability
- math.factorial(x)
- math.random()
Statistics
- math.max(a, b, c, ...)
- math.min(a, b, c, ...)
Trigonometry
- math.acos(x)
- math.asin(x)
- math.atan(x)
- math.atan2(y, x)
- math.cos(x)
- math.sin(x)
- math.tan(x)
Units
Utils
- math.help(fn)
- math.import(filename | object, override)
- math.typeof(x)
Extend
The library can easily be extended with functions and variables using the
import
method. The method import
accepts a filename or an object with
functions and variables.
var math = require('mathjs');
math.import({
myvalue: 42,
hello: function (name) {
return 'hello, ' + name + '!';
});
});
var a = math.myvalue * 2;
var b = math.hello('user');
var parser = new math.parser.Parser();
parser.eval('myvalue + 10');
parser.eval('hello("user")');
To import functions from a math library like
numbers.js,
the library must be installed using npm:
npm install numbers
And next, the library can be imported into math.js:
var math = require('mathjs'),
parser = new math.parser.Parser();
math.import('numbers');
math.fibonacci(7);
parser.eval('fibonacci(7)');
Build
First clone the project from github:
git clone git://github.com/josdejong/mathjs.git
The project uses jake as build tool,
which must be installed globally. After jake is installed, the project
dependencies can be downloaded using npm. Then the project can be build by
executing jake in the root of the project.
cd mathjs
sudo npm install -g jake
npm install
jake
When jake is executed, it will generate the library math.js and math.min.js
from the source files, and will test the library.
Roadmap
- Version 0.1.0 (2013-02-18):
- Implement all methods and constants available in the built-in Math library
- Implement data types Complex and Unit
- Version 0.2.0 (2013-02-25):
- Implement Parser, Scope, Node tree
- Implement more methods
- Version 0.3.0:
- Implement Workspace
- Extensive testing
- Build a website
- Version 0.4.0: Implement Arrays and Matrices
- Version 0.5.0: Implement more methods
- ...
License
Copyright (C) 2013 Jos de Jong wjosdejong@gmail.com
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.