dimitri/uniplot
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Unicode plotting tool for displaying CSV data directly in your terminal
21 commits 1 branch 0 tags 168 KiB
Find a file
Dimitri Lozeve 6282e80f50 Update build options 
- optimized build
- remove options with good default values (static is deprecated,
  optimize is #t by default)
- lower debug level
2023-09-08 17:49:23 +02:00
images Add documentation 2021-05-01 12:07:55 +02:00
uniplot Fix bug in y-axis labels 2022-10-03 17:53:42 +02:00
.gitignore Update build script to compile library modules independently 2021-10-24 21:47:20 +02:00
build.ss Update build options 2023-09-08 17:49:23 +02:00
gerbil.pkg Initial commit 2021-04-29 19:38:15 +02:00
LICENSE Initial commit 2021-04-29 19:38:15 +02:00
README.org Add documentation 2021-05-01 12:07:55 +02:00
uniplot.ss Fix issue (reversed data) when providing a single column 2021-10-24 11:46:15 +02:00

README.org

Uniplot

Unicode plotting tool for displaying CSV data directly in your terminal.

/dimitri/uniplot/media/commit/6282e80f506469a98b04dfda78036bcec119651e/images/demo.png

(source: Our World in Data)

Features

  • Braille canvas for plotting
  • Line plots
  • Axes and tick labels showing ranges
  • Optional title, x-axis label, and legend
  • Input data loading from a CSV file

Usage

Start from a well-formatted CSV file:

$ head data/annual_co2_emissions.csv
Year,United States,China,France,Germany,Italy,United Kingdom
1750,,,,,,9.350528e6
1751,,,,,,9.350528e6
1752,,,,,,9.354192e6
1753,,,,,,9.354192e6
1754,,,,,,9.357856e6
1755,,,,,,9.36152e6
1756,,,,,,1.0006384e7
1757,,,,,,1.0010048e7
1758,,,,,,1.0013712e7

Uniplot reads the standard input for a CSV file, and its behaviour depends on the number of columns:

  • If there is only one column, it will plot its values against a simple range index.
  • For two or more columns, it will use the first column for the x-axis, and plot the next columns with different colors against it.

You can use a tool like Awk or xsv to select the columns you want to plot:

awk -F, -v OFS=, '{print $1, $4, $5, $6, $7}' data/annual_co2_emissions.csv | uniplot

And you can add a title by giving an argument to uniplot:

awk -F, -v OFS=, '{print $1, $4, $5, $6, $7}' data/annual_co2_emissions.csv | uniplot "Annual CO₂ emissions (kg)"

Build

Install Gerbil Scheme.

Uniplot depends on Fancy for colors and display.

gxpkg install github.com/dlozeve/fancy
gxpkg install github.com/dlozeve/uniplot

Or manually clone Fancy and Uniplot and run ./build.ss in the root directory of each repository.

References