Home

Awesome

bashplotlib

plotting in the terminal

<img src="examples/img/basichist.png">

what is it?

bashplotlib is a python package and command line tool for making basic plots in the terminal. It's a quick way to visualize data when you don't have a GUI. It's written in pure python and can quickly be installed anywhere using pip.

installation

install with pip

$ pip install bashplotlib

install from source

$ git clone git@github.com:glamp/bashplotlib.git
$ cd bashplotlib
$ python setup.py install

Either method will install the bashplotlib python package and will also add <code>hist</code> and <code>scatter</code> to your python scripts folder. This folder should be on your path (add it if it's not).

features

usage

command line

<code>hist</code> takes input from either stdin or specified using the -f parameter. Input should be a single column of numbers. <img src="examples/img/histhelp.png"> <code>scatter</code> takes x and y coordinates as input form either a comma delimited file using -f or from 2 different files using -x and -y. <img src="examples/img/scatterhelp.png">

in python

If you want to use bashplotlib from python, just import histogram and scatterplot.

from bashplotlib.scatterplot import plot_scatter
<img src="examples/img/scatterplothelp.png">
from bashplotlib.histogram import plot_hist
<img src="examples/img/histogramhelp.png">

examples

$ scatter --file data/texas.txt --pch .
<img src="examples/img/texas.png">
$ hist --file data/exp.txt
<img src="examples/img/histogram.png">
$ scatter -x data/x_test.txt -y data/y_test.txt
<img src="examples/img/scatter.png">

todo