daisy/README.md

65 lines
1.9 KiB
Markdown
Raw Normal View History

2023-03-25 21:38:59 -07:00
![](./misc/banner.png)
2023-04-06 10:39:36 -07:00
A high-precision scientific calculator with support for units, derivatives, and more.
Many features are missing, this is still under development.
2023-08-01 20:14:03 -07:00
# 📦 Installation
- **Arch:** `yay -S daisy`
- **Debian:** coming soon
From source: `cargo build --release` \
Binary will be in `target/release/daisy`
# 📹 Screenshot
2023-08-01 14:25:43 -07:00
![](https://betalupi.com/static/git/daisy.png)
2023-04-06 10:39:36 -07:00
2023-08-01 20:14:03 -07:00
# 🛠️ Features
2023-08-01 11:02:34 -07:00
- Open-source
2023-04-06 10:39:36 -07:00
- Extremely high precision
2023-08-01 11:02:34 -07:00
- Uses a rational datatype when possible, and a high-precision float when not.
- Pretty printing in prompt (with special substitutions)
- Supports many physical units, with metric and binary prefixes
- Supports exponential notation
- Clear syntax, parsed input is always re-printed as a sanity check.
- Useful, detailed error messages
2023-08-01 20:14:03 -07:00
# 📑 Usage
2023-08-01 11:02:34 -07:00
All documentation is built into the prompt. Use the `help` command to view it.
## Evaluate expressions:
- Basic math: ``103 / 2 * 43``
- Functions: ``sqrt(1.4^3 + 4) * sin(pi / 4)``
- Scientific notation: ``1.2e12 * 1e-5``
## Physical units
- Unit operations: ``2 day + 1 hour``
- Unit conversion: ``2 day + 1 hour to minutes``
- Compound units: ``10 m/s to mph``
- Conversion errors: ``1 liter to volt``
## Varables
- Previous answer: `ans + 2`
- Variable assignment: `a = 143`
2023-08-01 20:14:03 -07:00
# 🌹 Additional Notes
2023-08-01 11:02:34 -07:00
## Unit Conversion
The conversion operator `to` converts its left argument to the *unit* of its right argument, ignoring its value. For example, `5m to mi` and `5m to 10mi` are identical.
## Multiplication Order
2023-08-02 09:38:58 -07:00
Implicit multiplication has a higher priority than division. `pi/2 radians` will parse as `pi/(2 radians)`. Type `(pi/2) radians` or `pi/2 * radians` to get 90 degrees.
2023-08-01 11:02:34 -07:00
## Inline Assignment
The assignment operator `=` returns its value, and can thus be used inside of an expression. For example, `(a = 2) + 2` assigns `a` to `2` and returns `4`. This only works for variable assignment.