Eqdraw

eqdraw is a simple yet powerful command-line tool that lets you visualize mathematical functions directly in your terminal using Unicode characters.

⚙️ Install

You'll need Rust and Cargo installed on your system. Then, run the following command:

cargo install eqdraw

🚀 Quick Usage

Using eqdraw is straightforward. Here are a few examples:

1. Plot a single equation:

eqdraw -q "y=x^2"

2. Plot multiple equations on the same graph:

eqdraw -q "y=sin(x)" -q "y=cos(x)"

3. Customize the view range:

Focus on a specific part of the graph by defining the min/max values for the axes.

eqdraw -q "y=tan(x)" --xmin -3.14 --xmax 3.14 --ymin -2 --ymax 2

📝 Equation Syntax

Equations must follow the format y=<expression_in_x>.

Operators

| Operator | Description | | :--- | :--- | | + | Addition | | - | Subtraction | | * | Multiplication | | / | Division | | ^ | Power |

Constants

| Name | Value | | :--- | :--- | | pi | The mathematical constant Pi (π ≈ 3.14159) | | e | Euler's number (e ≈ 2.71828) |

Functions

| Function | Description | | :--- | :--- | | sqrt(x) | The square root of x | | exp(x) | e raised to the power of x | | pow(b, e)| b raised to the power of e | | root(x, n)| The nth root of x | | abs(x) | The absolute value of x | | sin(x), cos(x), tan(x) | Basic trigonometric functions | | cot(x), sec(x), csc(x) | Cotangent, secant, cosecant | | asin(x), acos(x), atan(x) | Inverse trigonometric functions (arcsin, etc.) | | acot(x), asec(x), acsc(x) | Arccotangent, arcsecant, arccosecant | | sinh(x), cosh(x), tanh(x) | Hyperbolic functions | | coth(x), sech(x), csch(x) | Hyperbolic cotangent, secant, cosecant | | asinh(x), acosh(x), atanh(x)| Inverse hyperbolic functions (arsinh, etc.) | | acoth(x), asech(x), acsch(x)| Inverse hyperbolic cotangent, secant, cosecant | | ln(x) | The natural logarithm of x (base e) | | log(x) | The base-10 logarithm of x | | logb(x, b)| The logarithm of x with base b | | floor(x)| Rounds x down to the nearest integer | | ceil(x) | Rounds x up to the nearest integer | | round(x)| Rounds x to the nearest integer |

🔧 Command-line Options

| Option | Alias | Description | | :--- | :--- | :--- | | ----queries <equation> | -q | The equation to plot. Can be used multiple times. | | --xmin <XMIN> | | Minimum value for the x-axis. | | --xmax <XMAX> | | Maximum value for the x-axis. | | --ymin <YMIN> | | Minimum value for the y-axis. | | --ymax <YMAX> | | Maximum value for the y-axis. | | --help | -h | Show the help message. | | --version | -V | Show the version information. |

💡 Inspiration

This project was inspired by the fantastic Python library plotille by Tammo Ippen.

🤝 Contributing

Contributions are welcome! If you have an idea for an improvement or a bug fix, please open an Issue or a Pull Request on the repository.