/barg

Script to create ASCII bar graphs from CSV data

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

barg(1)                                                            barg(1)



NAME
       barg - create simple ASCII bar graphs from CSV data


SYNOPSIS
       barg [OPTIONS]


DESCRIPTION
       barg  processes  data in CSV format an outputs simple bar graphs as
       ASCII graphics. The option -b COLUMNO specifies which column number
       contains  the  (numerical)  data  used  to draw the bars. barg will
       determine the maximum value of this column and will scale all  bars
       relatively  to  this  maximum.  It is also possible to print a text
       next to each bar with the -l COLUMNO option. In this  case  COLUMNO
       can  be  the  number  of a column, either containing some arbitrary
       string (like a label for this bar) or the same column used for  the
       -b option to print the numeric value. The -b COLUMNO and -l COLUMNO
       options can  be  used  multiple  times  and  the  output  of  these
       labels/bars will be in the order as the options were specified.


OPTIONS
       -a     autodetect  columns for labels and bars (each column will be
              used either as label-bar-combination if it's numerical or as
              label otherwise) -a cannot be used in combination with -b or
              -l


       -b COLUMNO
              use data from column number COLUMNO (starting at 0) to  draw
              a bar


       -l COLUMNO
              use  string  from  column  number COLUMNO (starting at 0) to
              print a label


       -c BARCHAR
              use BARCHAR instead of "|" to draw the bars.  BARCHAR  be  a
              single character.


       -d DELIMITER
              use DELIMITER instead of Tab as field delimiter when reading
              data


       -f INPUTFILE
              read data from INPUTFILE instead of STDIN


       -w WIDTH
              Don't use automatically determined terminal width  to  scale
              the graphs but limit the output width to WIDTH characters.


EXAMPLES
       You   can   find   examples  on  how  to  use  barg  in  the  wiki:
       https://github.com/stefanschramm/barg/wiki


AUTHOR
       Stefan Schramm <mail@stefanschramm.net>




                                APRIL 2011                         barg(1)