A command line graphing utility written in Rust.
Rust
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
examples
src
Cargo.lock
Cargo.toml
README.md
screenshot.png

README.md

Fireplace

A no-nonsense command-line graphing utility written in Rust. About as useful as a video of a fireplace. Fireplace Screenshot

Features

  • Fixed, linear scaling based on a user-determined lower and upper bound
  • Variable, linear scaling (by default) that adjusts to show the visible minimum and maximum values
  • Graphs containing negative and positive numbers
  • Customizable titles

Upcoming Features

  • Logarithmic scales

Prerequesites

To build, you'll need a recent build of Rust and ncurses development files.

Installation

git clone https://github.com/jswrenn/fireplace.git
cd fireplace
cargo build

Usage

To graph with fireplace, all you need is some numbers. By default, fireplace will choose variable scaling.

T=0.0
while true;
do
    echo "scale=5;s($T)" | bc -l;
    T=$T+0.1;
    sleep 0.1;
done | ./target/fireplace

If you have an input range in mind, fixed scales can be specifies with --fixed or `-f``. You must additionally specify an upper bound, and optionally, a lower bound on the graph. If fixed scalign is chosen without a specified lower bound, zero is used instead. Fixed bounds can be used, for example, to limit the above graph to just positive values:

T=0.0
while true;
do
    echo "scale=5;s($T)" | bc -l;
    T=$T+0.1;
    sleep 0.1;
done | ./target/fireplace --fixed --lower 0.0 --upper 1.0