mathjs

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.

README

http://mathjs.org

Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser and offers an integrated solution to work with numbers, big numbers, complex numbers, units, and matrices. Powerful and easy to use.

Features

• Supports numbers, big numbers, complex numbers, units, strings, arrays, and matrices.
• Is compatible with JavaScript's built-in Math library.
• Contains a flexible expression parser.
• Supports chained operations.
• Comes with a large set of built-in functions and constants.
• Has no dependencies. Runs on any JavaScript engine.
• Can be used as a command line application as well.
• Is easily extensible.

Usage

Math.js can be installed using npm or bower, or by downloading the library. The library can be used in both node.js and in the browser. See the Getting Started for a more detailed tutorial. To install math.js using npm:

npm install mathjs

Math.js can be used similar to JavaScript's built-in Math library. Besides that, math.js can evaluate expressions and supports chained operations.

// load math.js and create an instance
var mathjs = require('mathjs'),
    math = mathjs();

// functions and constants
math.round(math.e, 3);            // 2.718
math.atan2(3, -3) / math.pi;      // 0.75
math.log(1000, 10);               // 3
math.sqrt(-4);                    // 2i
math.pow([[-1, 2], [3, 1]], 2);   // [[7, 0], [0, 7]]

// expressions
math.eval('12 / (2.3 + 0.7)');    // 4
math.eval('5.08 cm in inch');     // 2 inch
math.eval('sin(45 deg) ^ 2');     // 0.5
math.eval('9 / 3 + 2i');          // 3 + 2i
math.eval('det([-1, 2; 3, 1])');  // -7

// chained operations
math.select(3)
    .add(4)
    .multiply(2)
    .done(); // 14

Documentation

• Getting Started
• Examples
• Overview
• History

Build

First clone the project from github:

git clone git://github.com/josdejong/mathjs.git
cd mathjs

The project uses jake as build tool. To be able to run jake from the command line, jake must be installed globally:

sudo npm install -g jake

Install the project dependencies:

npm install

Then, the project can be build by executing jake in the root of the project:

jake

This will build the library math.js and math.min.js from the source files and put them in the folder dist.

Test

To execute tests for the library, install the project dependencies once:

npm install

Then, the tests can be executed:

npm test

License

Copyright (C) 2013 Jos de Jong [e-mail]

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.

Changelog

2013-12-12, version 0.17.0

• Renamed and flattened configuration settings:
  • number.defaultType is now number.
  • number.precision is now decimals.
  • matrix.defaultType is now matrix.
• Function multiply now consistently outputs a complex number on complex input.
• Fixed mod and in not working as function (only as operator).
• Fixed support for old browsers (IE8 and older), compatible when using es5-shim.
• Fixed support for Java's ScriptEngine.