#math #calculator #evaluator

kalk

A math evaluator library that supports user-defined functions, variables and units, and can handle fairly ambiguous syntax

25 releases (9 stable)

1.4.3 Feb 22, 2021
1.4.2 Jan 4, 2021
1.3.0 Dec 28, 2020
0.2.3 Dec 9, 2020
0.1.11 Jun 14, 2020

#66 in Math

Download history 7/week @ 2020-11-13 4/week @ 2020-11-20 22/week @ 2020-11-27 70/week @ 2020-12-04 100/week @ 2020-12-11 18/week @ 2020-12-18 35/week @ 2020-12-25 116/week @ 2021-01-01 24/week @ 2021-01-08 43/week @ 2021-01-15 5/week @ 2021-01-22 7/week @ 2021-01-29 19/week @ 2021-02-05 345/week @ 2021-02-12 55/week @ 2021-02-19 14/week @ 2021-02-26

278 downloads per month
Used in kalk_cli

MIT and LGPL-3.0+

110KB
3K SLoC

kalk

Kalk is a math parser library that supports user-defined variables and functions. An example of what it can parse:

f(x, y) = sum(1, 3, (2sin4/x!)^y) + cos(n deg)
a = 3
f(a, 2)

>> 1.1899401098014355

Features

  • Operators: +, -, *, /, !
  • Groups: (), ⌈⌉, ⌋⌊
  • Pre-defined functions and constants
  • User-defined functions and variables. f(x, y) = xy, x = 5
  • Understands fairly ambiguous syntax. Eg. 2sin50 + 2xy
  • Syntax highlighting
  • Special-symbol completion on tab. Eg. write sqrt and press tab. It will be turned into .

Rust Usage

use kalk::parser;
let mut parser_context = parser::Context::new();
let precision = 53;
let result = parser::eval(&mut parser_context, "5*3", precision).unwrap().unwrap();
assert_eq!(result.to_f64(), 15f64);

Using f64 instead of rug::Float

The cargo feature rug enables rug, and is used by default. If you disalbe this, kalk will use f64 instead, making it more portable.

Compiling

Make sure you have diffutils gcc make and m4 installed.

JavaScript Usage

const kalk = await import("@paddim8/kalk");
const context = new kalk.Context();
console.log(context.evaluate("2pi + 3").toScientificNotation().toString());

Dependencies

~17MB
~438K SLoC