Skip to main content

Data visualization in the terminal

Project description

Data visualization in the terminal.

Install

From PyPI:

easy_install viz

From source:

git clone https://github.com/chbrown/viz.git
cd viz
python setup.py install

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

Commands

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 google.com | 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:

8519086.0

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 godaddy.com | head -100 | sed -n 's/.*time=\(.*\) ms/\1/p' | viz points

Example result:

[+156.298000]
   ▃▃ ▁▃          ▁ ▁▁ ▁    ▁  ▁▁▁▂ ▃▂ ▉▂              ▁ ▁▁      ▁▂▁       ▁  ▁          ▁      ▁
[+70.593000]

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

Dependencies:

  • numpy

License

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.

Source Distribution

viz-0.0.5.tar.gz (7.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page