C# math expression library with symbolic computation support
Parse • Evaluate • Differentiate • Simplify • Solve
dotnet add package MathFlow<PackageReference Include="MathFlow" Version="2.1.0" />Install-Package MathFlowusing MathFlow.Core;
var engine = new MathEngine();
// basic stuff
var result = engine.Calculate("2 + 3 * 4"); // returns 14
Console.WriteLine(engine.Calculate("sin(pi/2)")); // 1
// with variables
var vars = new Dictionary<string, double> { ["x"] = 3, ["y"] = 4 };
var answer = engine.Calculate("x^2 + y^2", vars); // 25- Combinatorics Functions: Added binomial coefficients and permutation calculations
- Reorganized Math Functions: GCD, LCM, and factorial moved to dedicated CombinatoricsFunctions class
GCD,LCM, andFactorialfunctions have been moved from their previous location toCombinatoricsFunctionsclass- Update your imports if you were using these functions directly
- Complex Number Support: Full integration with expression parser
- Enhanced Polynomial Factoring: Quadratic, cubic, and special forms
- New ODE Solvers: RungeKutta2 and Adams-Bashforth methods
- Rational Function Integration: Partial fractions and special forms
- Symbolic Integration: Extended support for trigonometric and exponential functions
- Parse mathematical expressions from strings
- Evaluate with variables and custom functions
- Works with standard math notation
- Symbolic differentiation and integration
- Expression simplification and factoring
- Numerical integration & equation solving
- ASCII plotting for function visualization
- Matrix operations & linear algebra
- Arbitrary precision arithmetic
- Complex number arithmetic
| Category | Functions |
|---|---|
| Basic | + - * / ^ % |
| Trigonometric | sin cos tan asin acos atan |
| Hyperbolic | sinh cosh tanh |
| Logarithmic | ln log10 exp |
| Other | sqrt abs floor ceil round sign min max factorial |
| Constants | pi e tau phi |
// First derivative
var derivative = engine.Differentiate("x^3 + 2*x^2 - 5*x + 3", "x");
// gives you: 3*x^2 + 4*x - 5
// Higher order derivatives
var secondDerivative = engine.Differentiate("x^4", "x", order: 2);
// gives you: 12*x^2
var thirdDerivative = engine.Differentiate("sin(x)", "x", order: 2);
// gives you: -sin(x)var simplified = engine.Simplify("x + 2*x + 3*x");
Console.WriteLine(simplified); // 6*x// find root near initial guess
double root = engine.FindRoot("x^2 - 4", 3); // returns 2
// find all roots in range
double[] roots = engine.FindRoots("x^3 - 6*x^2 + 11*x - 6", 0, 4);
// gives [1, 2, 3]double integral = engine.Integrate("x^2", "x", 0, 1);
// returns ~0.333333Display mathematical functions directly in terminal:
// Simple plot
var plot = engine.Plot("sin(x)", -Math.PI, Math.PI);
Console.WriteLine(plot.ToAsciiChart(60, 20));
// Multiple functions
var multiPlot = engine.CreatePlotter()
.AddFunction("sin(x)", -Math.PI, Math.PI, label: "sin")
.AddFunction("cos(x)", -Math.PI, Math.PI, label: "cos");
Console.WriteLine(multiPlot.ToAsciiChart(60, 20));Output:
1.0 ┤ ●●●●●
│ ●● ●●
│ ●● ●●
│ ●● ●●
0.0 ┤●●────────────●●──────────
│ ●● ●
│ ●● ●●
│ ●●●●●●●
-1.0 ┤
└──────────────────────────
-3.14 0.00 3.14
Build expressions programmatically:
var expr1 = engine.Parse("x + 2");
var expr2 = engine.Parse("y - 1");
var combined = expr1 * expr2; // creates (x + 2) * (y - 1)Variable substitution:
var substituted = engine.Substitute("x^2 + y", "x", "sin(t)");
// gives: sin(t)^2 + ystring latex = engine.ToLatex("sqrt(x^2 + y^2)");
// \sqrt{x^{2} + y^{2}}string mathml = engine.ToMathML("x/2");
// outputs MathML formatRegister your own functions:
engine.RegisterFunction("double", args => args[0] * 2);
var result = engine.Calculate("double(5)"); // 10Check the Examples folder for advanced usage:
- Complex numbers
- Vector operations
- Statistical functions
- Linear regression
| Method | Description |
|---|---|
Calculate(expression, variables?) |
Evaluate expression |
Parse(expression) |
Parse to AST |
Simplify(expression) |
Simplify expression |
Differentiate(expression, variable, order?) |
Take derivative (supports higher orders) |
Integrate(expression, variable, a, b) |
Numerical integration |
FindRoot(expression, guess) |
Find root using Newton's method |
FindRoots(expression, start, end) |
Find all roots in range |
Expand(expression) |
Expand expression |
Factor(expression) |
Factor expression (limited) |
Substitute(expression, var, replacement) |
Replace variable |
ToLatex(expression) |
Convert to LaTeX |
ToMathML(expression) |
Convert to MathML |
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Add tests for new features
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- Inspired by various mathematical expression parsers
- Built with passion for mathematics and clean code
Made by Nonanti