Mathflow
Simplifying Math, Empowering Code.
Overview
Mathflow is a lightweight JavaScript library for evaluating mathematical expressions written in natural mathematical notation. It parses and computes standard arithmetic, trignometric functions, logarithms, and algebraic expressions exactly as you would write them on paper.
Features
- Natural syntax: Write
2x + 3(y - 1) instead of 2*x + 3*(y - 1). Both are supported anyway.
- Step-by-step solutions: Every result comes with the working out, one line per step.
- Mathematical functions: Over a hundred built-ins - trigonometry, logarithms, statistics, combinatorics, special functions and more.
- Variables: Assign and use variables like
x = 5, y = 5x - 1
- Clean & modern syntax: Readable and easy-to-write syntax for mathematical expressions.
- AST-based parsing: Proper order of operations and expression evaluation.
- Lightweight: Focused purely on mathematical computation without bloat.
import { createContext } from '@mathflowjs/mathflow';
const ctx = createContext({ preferences: { angles: 'deg' } });
ctx.solve('x = 5');
ctx.solve('2x^3 + sqrt(25)');
// {
// value: 255,
// solution: [
// '2 * 5 ^ 3 + sqrt(25)',
// '2 * 125 + 5',
// '250 + 5',
// '255'
// ]
// }
Every value is a plain number, so a data set is written variadically:
mean(1, 2, 3), not mean([1, 2, 3]). See TODO.md for the full
function list and for what is deliberately out of scope.
Use Cases
- Formula calculators and mathematical tools.
- Educational applications for learning mathematics.
- Basic scientific computing interfaces.
- Anywhere you need to evaluate user-input mathematical expressions safely.
Documentation
To get started with Mathflow, read the documentation here.
Contributing
Contributions are welcome to make Mathflow even better! Feel free to open issues or submit pull requests.
License
This project is licensed under the MIT License
Copyright © 2024-present, Henry Hale
