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.
Math.js is an extensive JavaScript math library, compatible with JavaScripts
standard Math library.
Features:
- A flexible expression parser.
- Support for real and complex values, 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.
Website: http://mathjs.org
Install
Math.js can be installed via 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 via require, and similarly in the browser
using require.js.
var math = require('mathjs'),
Complex = math.type.Complex,
Unit = math.type.Unit;
// use methods and types available in the math object
var a = math.sin(math.pi / 4);
var b = math.pow(a, 2);
console.log('sin(pi / 4) ^ 2 = ' + math.round(b, 3)); // 'sin(pi / 4) ^ 2 = 0.5'
var c = new Complex(3, -4);
var d = math.sqrt(c);
console.log('sqrt(3 - 4i) = ' + d); // 'sqrt(3 - 4i) = 2 - i'
var e = math.sqrt(-4);
console.log('sqrt(-4) = ' + e); // 'sqrt(-4) = 2i'
var f = new Unit(60, 'deg');
var g = math.cos(f);
console.log('cos(60 deg) = ' + math.round(g, 3)); // 'cos(60 deg) = 0.5'
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">
// the math object is available here
var a = math.sqrt(-4);
console.log('sqrt(-4) = ' + a); // 'sqrt(-4) = 2i'
// ...
</script>
</body>
</html>
Parser
The expression parser is not yet implemented. Coming soon...
API
The math.js library contains the following data types, methods and constants.
Data types
- Number
- String
- math.type.Complex
- math.type.Unit
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
Arithmetic
- math.abs(x)
- math.add(x, y)
- math.ceil(x)
- math.divide(x, y)
- math.exp(x)
- math.fix(x)
- math.floor(x)
- math.larger(x, y)
- math.log(x)
- math.multiply(x, y)
- math.pow(x, y)
- math.round(x [, n])
- math.smaller(x, y)
- math.subtract(x, y)
- math.sqrt(x)
- math.unaryminus(x)
Probability
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
Build
To clone the project from github:
git clone git://github.com/josdejong/mathjs.git
The project uses jake as build tool,
and 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 projects root.
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.
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.