quick-draw: a cli plotting tool

qd is a command line tool to quickly make plots from csv and json files or streams. It is built on top of the pandas and plotly libraries.

qd can be installed via pip install qd-plot. It requires Python 3.7+.

Make a quick plot using the first columns available and display the output in a gui (default web browser).

cat data/trig.json | qd --gui

By default qd reads data from stdin and writes image bytes to stdout, however it also accepts input and output files as arguments, as well as the --gui option shown above.

qd -i data/trig.json -o trig.png

All the cli functionality available can be seen via the --help option.

qd --help

Since qd writes to stdout by default, the images can be displayed right in the terminal window if using a compatible terminal, such as iTerm2 with imgcat:

cat data/trig.json | qd | imgcat

Plot the mean values in some bins specifying the x and y columns.

cat data/trig.json | qd -x x -y sin,cos --mean --gui

Plot the 95th percentile values in 20 bins

cat data/trig.json | qd -x x -y sin --quant -q 95 --nbins 20 --gui

Make a histogram from two sets of data using 20 bins.

cat data/dists.csv | qd -x gauss,expo --hist -n20 --gui

Clone this repo from github and in a virtual environment do the following:

pip install .  # installs qd based on local code changes
pip install -r requirements-dev.txt  # installs extra packages for dev and testing

Tests can be run via:

pytest -n4