lorenz-cli

Crates.iolorenz-cli
lib.rslorenz-cli
version0.1.1
created_at2025-03-30 21:38:16.542242+00
updated_at2025-03-30 22:32:25.598866+00
descriptionPlots lorenz attractor in terminal.
homepage
repositoryhttps://github.com/dhruvkjain/lorenz-cli
max_upload_size
id1612775
size25,088
Dhruv Jain (dhruvkjain)

documentation

https://docs.rs/lorenz-cli

README

Lorenz Attractor Terminal Plotter

github crates.io docs.rs

This project visualizes the Lorenz Attractor in the terminal using Ratatui. The attractor is dynamically plotted in real-time, allowing users to choose different projection axes.

Features

  • Real-time plotting of the Lorenz Attractor
  • Supports different 2D projections (XY, XZ, YZ)
  • Dynamically adjusts the graph bounds
  • Animated rendering using terminal graphics
  • Exit the visualization anytime by pressing 'q' or Esc

Installation

1. Install Rust (if not already installed)

Ensure you have Rust installed. If not, install it using:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then restart your terminal and verify the installation:

rustc --version
cargo --version

2. Installing from Crates.io

You can install crate directly too from:

cargo install lorenz-cli

Run it:

lorenz-cli xz

Example Output

image

(Rendered using Braille characters in Ratatui)

Development

1. Install Rust (if not already installed)

Ensure you have Rust installed. If not, install it using:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then restart your terminal and verify the installation:

rustc --version
cargo --version

2. Clone the Repository

git clone https://github.com/dhruvkjain/lorenz-cli.git
cd lorenz-cli

3. Build the Project

cargo build --release

4. Run the Lorenz Attractor

To run with the default projection (XY):

cargo run --release

Or specify an axis:

cargo run --release -- xz  # Options: xy, xz, yz

License

This project is licensed under the MIT License.

Author

Dhruv Jain

Commit count: 8

cargo fmt