Skip to main content

Data visualization in the terminal

Project description

Data visualization in the terminal.


From PyPI:

easy_install viz

From source:

git clone
cd viz
python install

The CLI entry point is viz, which should be installed on your PATH.


viz hist

Read floats from stdin and plot as a single line histogram.

Example: ping google every 100ms (0.1s) and plot the first 50 response times you get back:

ping -i 0.1 | head -50 | sed -n 's/.*time=\(.*\) ms/\1/p' | viz hist

Example result (which should fit your terminal width automatically):

26.1390000[▁      ▁▁  ▁▁▂▂ ▉ ▂▂ ▃ ▂▁▂ ▁ ▁▁      ▁   ▁                                    ]39.5580000

viz total

Read floats from stdin and sum them. No graphics, but useful because awk '{sum+=$1}END{print sum} is too long.

Example: count the bytes used by the current directory and its children.

find . -ls | tr -s ' ' | cut -d ' ' -f 7 | viz total

Example result:


Compare to du:

echo $[$(du -sk . | cut -f 1) * 1024]
> 8531968

viz points

Read floats from stdin, plot on a single line from left to right with as much granularity as the terminal will allow. Otherwise, bin incrementally and plot the arithmetic mean of each bin.

Example: ping some really awful website every 100ms, plot the first 100 successful responses (takes about 10s).

ping -i 0.1 | head -100 | sed -n 's/.*time=\(.*\) ms/\1/p' | viz points

Example result:

   ▃▃ ▁▃          ▁ ▁▁ ▁    ▁  ▁▁▁▂ ▃▂ ▉▂              ▁ ▁▁      ▁▂▁       ▁  ▁          ▁      ▁

The top line is the maximum, the bottom is the minimum. The other values are scaled linearly between those extremes.


  • numpy


Copyright (c) 2013 Christopher Brown. MIT Licensed.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
viz-0.0.5.tar.gz (7.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page