5 releases (breaking)
0.5.0 | Feb 12, 2024 |
---|---|
0.4.0 | Nov 3, 2023 |
0.3.0 | Sep 26, 2023 |
0.2.0 | Sep 20, 2023 |
0.1.0 | Jul 12, 2023 |
#339 in Science
198 downloads per month
Used in 3 crates
(via numbat)
4KB
Try online! • Documentation • Tutorial • Syntax reference • Installation • Development
Numbat is a statically typed programming language for scientific computations
with first class support for physical dimensions and units.
Key Features
Click to learn more.
Physical dimensions as types
Numbat has a static type system where physical dimensions like Length
and Time
act as types.
Definitions of constants and functions can optionally contain type annotations that will be statically enforced.
If the types are not specified, they will be inferred (Speed
, Money
and Frequency
in the screenshot).
See this article to learn more about Numbat's type system.
First-class physical units
Numbat is focused on computations with units. Units are therefore treated as first-class citizens. They can be
entered in various ways (km/h
or kilometer/hour
, GiB
or
gibibytes
, °
or degree
, m²
or m^2
).
New units can be introduced on the spot (unit pixel
).
Compatible units can be converted easily using the ->
operator (30 km/h -> mph
, 1 mrad -> degree
, 5 in + 2 ft -> cm
, 27 weeks -> days
).
And unit expressions are simplified using various heuristics (15 km/h * 30 min = 7.5 km
).
Comprehensive standard library
Numbat's standard library comes with a large number of physical dimensions and units (SI, US Customary, Imperial, Nautical, Astronomical, Atomic, Nuclear, …). See this reference page for a complete overview. It also contains a lot of mathematical and physical constants as well as a large range of pre-defined functions.
Strict syntax
Numbat's parser never tries to be "smart" on syntactically incorrect input. This means you will either get a (descriptive) error message, or you can trust the result of your calculation.
Excellent error messages
Numbat aims to provide descriptive and helpful error messages.
Interactive terminal
Numbat has been designed for an interactive use-case with small "one off" computations. Opening the numbat
interpreter
without any arguments starts a REPL with a familiar
readline interface, including all the usual features like a command history, Ctrl-R search or tab completion.
Modular and customizable
The whole system of physical dimensions and units is specified Numbat's standard library, which is
written in the Numbat language itself. It is therefore
easily extensible by providing a init.nbt
file. For example,
a single line (unit bathtub = 150 L
) is usually enough to add a new unit. Users can even choose to write their
own prelude
module, allowing for arbitrary modifications to the unit system.
Assertions
With its static type system, Numbat already enforces correctness of your calculations on a physical dimension level.
But some checks can only be made at runtime. Numbat provides an assert_eq
procedure that allows you to check for
exact equality using assert_eq(12 ft, 1 in)
or approximate equality using assert_eq(c, 300_000 km/s, 1% × c)
.
This can be useful to make sure that intermediate results do not change during a restructuring of your calculation.
Non-features
Numbat is a scientific calculator. It's not a computer algebra system that solves differential equations
or computes intergrals. Try WolframAlpha instead.
There is no graphical user interface with buttons like x²
, 1/x
or DEG/RAD
.
Qalculate! is a fantastic tool that supports both text as well as graphical
input.
Numbat supports a huge range of physical units. If you need something even more comprehensive,
please consider contributing. Or try GNU units.
Installation
See this page for details on how to install the native command-line version of Numbat.
Development
Run Numbat CLI
cargo run -- <numbat args>
Install the CLI version
cargo install -f --path numbat-cli
Run all tests
cargo test
Working on the prelude
If you are working on Numbat's standard library, it is convenient to point
the NUMBAT_MODULES_PATH
environment variable to the numbat/modules/
folder. This way,
you don't have to recompile Numbat to see your changes.
Alternatively, you can create a symlink from ~/.config/numbat/modules
to the numbat/modules/
folder in the repository (see this page
for the standard paths on other operating systems).
Contact us
To contact us, either open a GitHub issue or discussion, or pop into our Discord server.
Dependencies
~1.2–2MB
~33K SLoC