PHPackages components/mathjs - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. components/mathjs ActiveComponent[Utility & Helpers](/categories/utility) components/mathjs ================= Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser with support for symbolic computation, comes with a large set of built-in functions and constants, and offers an integrated solution to work with different data types like numbers, big numbers, complex numbers, fractions, units, and matrices. v5.10.3(7y ago)15.0k3.8k↓50%1.3k[45 PRs](https://github.com/josdejong/mathjs/pulls)Apache-2.0JavaScriptCI passing Since Apr 8Pushed 1mo ago216 watchersCompare [ Source](https://github.com/josdejong/mathjs)[ Packagist](https://packagist.org/packages/components/mathjs)[ Docs](https://mathjs.org)[ RSS](/packages/components-mathjs/feed)WikiDiscussions develop Synced 1mo ago READMEChangelogDependenciesVersions (118)Used By (0) [![math.js](https://raw.githubusercontent.com/josdejong/mathjs/develop/misc/img/mathjs.svg)](https://raw.githubusercontent.com/josdejong/mathjs/develop/misc/img/mathjs.svg) Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser with support for symbolic computation, comes with a large set of built-in functions and constants, and offers an integrated solution to work with different data types like numbers, big numbers, complex numbers, fractions, units, and matrices. Powerful and easy to use. [![Version](https://camo.githubusercontent.com/bef12d27091883999848cbe1bf5fcc75aaf3077071f9030d28e75c815ea23ae7/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f6d6174686a732e737667)](https://www.npmjs.com/package/mathjs)[![Downloads](https://camo.githubusercontent.com/44303e57e62113a7a39d0529acb24a70a4ad4966577e2a6bceddeaab5142e3a0/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f646d2f6d6174686a732e737667)](https://www.npmjs.com/package/mathjs)[![Build Status](https://github.com/josdejong/mathjs/workflows/Node.js%20CI/badge.svg)](https://github.com/josdejong/mathjs/actions)[![Maintenance](https://camo.githubusercontent.com/eb3f3ffb1347bd1add4ab6d623131eaf8677d02e07107bad3ee7e7825d60e421/68747470733a2f2f696d672e736869656c64732e696f2f6d61696e74656e616e63652f7965732f323032362e737667)](https://github.com/josdejong/mathjs/graphs/commit-activity)[![License](https://camo.githubusercontent.com/5316b60ae65149b7eba726098fe80c7c730c50e6e834b5f3928914d12b724da6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a6f7364656a6f6e672f6d6174686a732e737667)](https://github.com/josdejong/mathjs/blob/master/LICENSE)[![FOSSA Status](https://camo.githubusercontent.com/328f7e6bc503178a2c6f7cd91a8b150a793a8e58c547c54bfc60947ff03610c6/68747470733a2f2f6170702e666f7373612e696f2f6170692f70726f6a656374732f6769742532426769746875622e636f6d2532466a6f7364656a6f6e672532466d6174686a732e7376673f747970653d736869656c64)](https://app.fossa.io/projects/git%2Bgithub.com%2Fjosdejong%2Fmathjs?ref=badge_shield)[![Codecov](https://camo.githubusercontent.com/9d0f2f4e20e75cf5f52f6e9a8a79477cf09fa8e413714bc2e64319b960c3f472/68747470733a2f2f636f6465636f762e696f2f67682f6a6f7364656a6f6e672f6d6174686a732f6272616e63682f646576656c6f702f67726170682f62616467652e737667)](https://codecov.io/gh/josdejong/mathjs)[![Github Sponsor](https://camo.githubusercontent.com/05b4f5c93f53f5ace3aa6ffdf2078bd8d06ee5560f0118ffc1781489c79d9a00/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73706f6e736f72732f6a6f7364656a6f6e67)](https://github.com/sponsors/josdejong) Features -------- [](#features) - Supports numbers, bignumbers, bigints, complex numbers, fractions, units, strings, arrays, and matrices. - Is compatible with JavaScript's built-in Math library. - Contains a flexible expression parser. - Does symbolic computation. - Comes with a large set of built-in functions and constants. - Can be used as a command line application as well. - Runs on any JavaScript engine. - Is easily extensible. - Open source. Usage ----- [](#usage) Math.js can be used in both node.js and in the browser. Install math.js using [npm](https://www.npmjs.com/package/mathjs): ``` npm install mathjs ``` Or download mathjs via one of the CDN's listed on the downloads page: [https://mathjs.org/download.html](https://mathjs.org/download.html#download) Math.js can be used similar to JavaScript's built-in Math library. Besides that, math.js can evaluate [expressions](https://mathjs.org/docs/expressions/index.html)and supports [chained operations](https://mathjs.org/docs/core/chaining.html). ``` import { atan2, chain, derivative, e, evaluate, log, pi, pow, round, sqrt } from 'mathjs' // functions and constants round(e, 3) // 2.718 atan2(3, -3) / pi // 0.75 log(10000, 10) // 4 sqrt(-4) // 2i pow([[-1, 2], [3, 1]], 2) // [[7, 0], [0, 7]] derivative('x^2 + x', 'x') // 2 * x + 1 // expressions evaluate('12 / (2.3 + 0.7)') // 4 evaluate('12.7 cm to inch') // 5 inch evaluate('sin(45 deg) ^ 2') // 0.5 evaluate('9 / 3 + 2i') // 3 + 2i evaluate('det([-1, 2; 3, 1])') // -7 // chaining chain(3) .add(4) .multiply(2) .done() // 14 ``` See the [Getting Started](https://mathjs.org/docs/getting_started.html) for a more detailed tutorial. Browser support --------------- [](#browser-support) Math.js works on any [ES2020](https://262.ecma-international.org/11.0/) compatible JavaScript engine, including node.js, Chrome, Firefox, Safari, and Edge. Documentation ------------- [](#documentation) - [Getting Started](https://mathjs.org/docs/getting_started.html) - [Examples](https://mathjs.org/examples/index.html) - [Overview](https://mathjs.org/docs/index.html) - [History](https://mathjs.org/history.html) Build ----- [](#build) First clone the project from github: ``` git clone git@github.com:josdejong/mathjs.git cd mathjs ``` Install the project dependencies: ``` npm install ``` Then, the project can be build by executing the build script via npm: ``` npm run build ``` This will build ESM output, CommonJS output, and the bundle math.js from the source files and put them in the folder lib. Develop ------- [](#develop) When developing new features for mathjs, it is good to be aware of the following background information. ### Code [](#code) The code of `mathjs` is written in ES modules, and requires all files to have a real, relative path, meaning the files must have a `*.js` extension. Please configure adding file extensions on auto import in your IDE. ### Architecture [](#architecture) What mathjs tries to achieve is to offer an environment where you can do calculations with mixed data types, like multiplying a regular `number` with a `Complex` number or a `BigNumber`, and work with all of those in matrices. Mathjs also allows to add a new data type with little effort. The solution that mathjs uses has two main ingredients: - **Typed functions**. All functions are created using [`typed-function`](https://github.com/josdejong/typed-function/). This makes it easier to (dynamically) create and extend a single function with new data types, automatically do type conversions on function inputs, etc. So, if you create function multiply for two `number`s, you can extend it with support for multiplying your own data type, say `MyDecimal`. If you define a conversion from `MyDecimal` to `number`, the typed-function will automatically allow you to multiply a `MyDecimal` with a `number`. - **Dependency injection**. When we have a function `multiply` with support for `MyDecimal`, thanks to the dependency injection, other functions using `multiply` under the hood, like `prod`, will automatically support `MyDecimal` too. This also works the other way around: if you don't need the heavyweight `multiply` (which supports BigNumbers, matrices, etc), and you just need a plain and simple number support, you can use a lightweight implementation of `multiply` just for numbers, and inject that in `prod` and other functions. At the lowest level, mathjs has immutable factory functions which create immutable functions. The core function `math.create(...)` creates a new instance having functions created from all passed factory functions. A mathjs instance is a collection of created functions. It contains a function like `math.import` to allow extending the instance with new functions, which can then be used in the expression parser. ### Implementing a new function [](#implementing-a-new-function) A common case is to implement a new function. This involves the following steps: - Implement the function in the right category, for example `./src/function/arithmetic/myNewFunction.js`, where you can replace `arithmetic` with the proper category, and `myNewFunction` with the name of the new function. Add the new function to the index files `./src/factoriesAny.js` and possibly `./src/factoriesNumber.js`. - Write documentation on the function in the source code comment of `myNewFunction.js`. This documentation is used to auto generate documentation on the website. It should include a History section with one line, indicating the upcoming version number in which the function will be created. - Write embedded documentation for the new function in `./src/expression/embeddedDocs/function/arithmetic/myNewFunction.js`. Add the new documentation to the index file `./src/expression/embeddedDocs/embeddedDocs.js`. - Write unit tests for the function in `./test/unit-tests/function/arithmetic/myNewFunction.test.js`. - Write the necessary TypeScript definitions for the new function in `./types/index.d.ts`, and write tests for it in `./test/typescript-tests/testTypes.ts`. This is described in [./types/EXPLANATION.md](./types/EXPLANATION.md) -- make sure to read that page, as Typescript definitions must be added in *multiple* places in the code. - Ensure the code style is ok by running `npm run lint` (run `npm run format` to fix the code style automatically). ### Build scripts [](#build-scripts) The build script currently generates two types of output: - **any**, generate entry points to create full versions of all functions - **number**: generating and entry points to create lightweight functions just supporting `number` For each function, an object is generated containing the factory functions of all dependencies of the function. This allows to just load a specific set of functions, and not load or bundle any other functionality. So for example, to just create function `add` you can do `math.create(addDependencies)`. Test ---- [](#test) To execute tests for the library, install the project dependencies once: ``` npm install ``` Then, the tests can be executed: ``` npm test ``` To test the type definitions: ``` npm run test:types ``` Additionally, the tests can be run on FireFox using [headless mode](https://developer.mozilla.org/en-US/Firefox/Headless_mode): ``` npm run test:browser ``` To run the tests remotely on LambdaTest, first set the environment variables `LT_USERNAME` and `LT_ACCESS_KEY` with your username and access key and then execute: ``` npm run test:lambdatest ``` You can separately run the code linter, though it is also executed with `npm test`: ``` npm run lint ``` To automatically fix linting issue, run: ``` npm run format ``` To test code coverage of the tests: ``` npm run coverage ``` To see the coverage results, open the generated report in your browser: ``` ./coverage/lcov-report/index.html ``` ### Continuous integration testing [](#continuous-integration-testing) Continuous integration tests are run on [GitHub Actions](https://github.com/josdejong/mathjs/actions) and [TestMu AI](https://www.testmuai.com/?utm_medium=sponsor&utm_source=mathjs) (formerly LambdaTest) every time a commit is pushed to GitHub. GitHub Actions runs the tests for different versions of node.js, and TestMu AI runs the tests on all major browsers. [![TestMu AI](https://camo.githubusercontent.com/205d7b6b2299cf034024dff8059086c96c13f78e744531e2bb4cfbe8d379609f/68747470733a2f2f7261772e6769746875622e636f6d2f6a6f7364656a6f6e672f6d6174686a732f646576656c6f702f6d6973632f746573746d752d61692e737667)](https://www.testmuai.com/?utm_medium=sponsor&utm_source=mathjs) Thanks, GitHub Actions and TestMu AI for the generous free hosting of this open source project! License ------- [](#license) mathjs is published under the Apache 2.0 license: ``` Copyright (C) 2013-2026 Jos de Jong 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 https://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. ``` mathjs contains a JavaScript port of the [CSparse](https://github.com/DrTimothyAldenDavis/SuiteSparse/tree/dev/CSparse/Source) library, published under the LGPL-2.1+ license: ``` CSparse: a Concise Sparse matrix package. Copyright (c) 2006, Timothy A. Davis. http://www.suitesparse.com -------------------------------------------------------------------------------- CSparse is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. CSparse is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this Module; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA ``` ### Health Score 62 — FairBetter than 99% of packages Maintenance58 Moderate activity, may be stable Popularity57 Moderate usage in the ecosystem Community40 Growing community involvement Maturity80 Battle-tested with a long release history Bus Factor1 Top contributor holds 72.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~12 days Recently: every ~3 days Total 118 Last Release 2554d ago Major Versions v3.20.1 → v4.0.0-rc.12018-02-04 v3.20.2 → v4.0.0-rc.22018-02-21 v4.4.2 → v5.0.02018-06-16 v5.9.0 → v6.0.0-beta.02019-04-30 v5.10.3 → v6.0.0-beta.22019-05-21 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/568626?v=4)[Jos de Jong](/maintainers/josdejong)[@josdejong](https://github.com/josdejong) --- Top Contributors [![josdejong](https://avatars.githubusercontent.com/u/568626?v=4)](https://github.com/josdejong "josdejong (3678 commits)")[![rjbaucells](https://avatars.githubusercontent.com/u/1074987?v=4)](https://github.com/rjbaucells "rjbaucells (309 commits)")[![FSMaxB](https://avatars.githubusercontent.com/u/4294942?v=4)](https://github.com/FSMaxB "FSMaxB (178 commits)")[![greenkeeper[bot]](https://avatars.githubusercontent.com/in/505?v=4)](https://github.com/greenkeeper[bot] "greenkeeper[bot] (178 commits)")[![ericman314](https://avatars.githubusercontent.com/u/6345617?v=4)](https://github.com/ericman314 "ericman314 (120 commits)")[![harrysarson](https://avatars.githubusercontent.com/u/16308754?v=4)](https://github.com/harrysarson "harrysarson (103 commits)")[![BigFav](https://avatars.githubusercontent.com/u/2354042?v=4)](https://github.com/BigFav "BigFav (76 commits)")[![dvd101x](https://avatars.githubusercontent.com/u/16261897?v=4)](https://github.com/dvd101x "dvd101x (54 commits)")[![gwhitney](https://avatars.githubusercontent.com/u/3825429?v=4)](https://github.com/gwhitney "gwhitney (50 commits)")[![mattvague](https://avatars.githubusercontent.com/u/64985?v=4)](https://github.com/mattvague "mattvague (40 commits)")[![sebpiq](https://avatars.githubusercontent.com/u/299835?v=4)](https://github.com/sebpiq "sebpiq (33 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (25 commits)")[![SzechuanSage](https://avatars.githubusercontent.com/u/3319499?v=4)](https://github.com/SzechuanSage "SzechuanSage (22 commits)")[![patgrasso](https://avatars.githubusercontent.com/u/5988045?v=4)](https://github.com/patgrasso "patgrasso (19 commits)")[![Veeloxfire](https://avatars.githubusercontent.com/u/58116051?v=4)](https://github.com/Veeloxfire "Veeloxfire (18 commits)")[![guillermobox](https://avatars.githubusercontent.com/u/281797?v=4)](https://github.com/guillermobox "guillermobox (18 commits)")[![tetslee](https://avatars.githubusercontent.com/u/11746123?v=4)](https://github.com/tetslee "tetslee (18 commits)")[![morsecodist](https://avatars.githubusercontent.com/u/24242714?v=4)](https://github.com/morsecodist "morsecodist (17 commits)")[![ThomasBrierley](https://avatars.githubusercontent.com/u/12444321?v=4)](https://github.com/ThomasBrierley "ThomasBrierley (15 commits)")[![daniel-levin](https://avatars.githubusercontent.com/u/910254?v=4)](https://github.com/daniel-levin "daniel-levin (15 commits)") --- Tags bignumberscomplex-numbersexpression-evaluatorjavascriptmathmatricesunits ### Embed Badge ![Health badge](/badges/components-mathjs/health.svg) ``` [![Health](https://phpackages.com/badges/components-mathjs/health.svg)](https://phpackages.com/packages/components-mathjs) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)