NAME

       bytes-circle - Show byte statistics as an ASCII circle graph

SYNOPSIS

       bytes-circle [-o {0|1|2|3}] [-Bbnruh] [-z {0-255}] files...

DESCRIPTION

       bytes-circle  is a program that shows statistics about bytes contained in a file as an ASCII circle graph
       of deviations from mean in sigma increments.

       By default, byte 0 is at the center of the circle and next bytes until 256 are situated  counterclockwise
       around the center.

       bytes-circle expects a colour terminal, though other options are available.

       The  ASCII  art  produced  uses  this  char  array  to  represent  increment values of 1/4*sigma from the
       statistic's mean:
          . , - ~ + * o O # @

       This ranges from zero (.) on the left, to 9/4*sigma (@) on the right.  If value is zero or over the  mean
       the  char  is  printed  green.  If it is below the mean, it's printed red. A (blue) '=' char represents a
       byte value that doesn't appear in the file.

OPTIONS

       files  One or more files. If no file is indicated, standard input is used.

       -o {0|1|2|3}
              1=no color | 2=numbers | 3=uncoloured numbers

       -B     Stop processing files on first error encountered.

       -b     No color. In this case, ASCII art is adjusted so the zero sigma is at  the  middle  of  the  chars
              array (char '*'). Increments are 1/2*sigma.

       -n     Use numbers. In this case, coloured numbers are used to represent values from 0 to 9/4*sigma.

       -r     Restrict  statistics to the byte values that appear in the file, not to the 256 default. This only
              makes a difference if there are byte values that do not appear in the file.

       -u     Use uncoloured numbers. In this case, numbers are used to represent positive deviations from 0  to
              9/4*sigma,  and  letters  are  used  to  represent  negative  deviations  from  'a'  (-0)  to  'i'
              (-9/4)*sigma.

       -h     Show summary of options.

       -z {0-255}
              Shows a second circle centered on indicated byte bucket. A zero value is  equivalent  to  127  for
              ease of use. This way a second view of the statistics is available for data disaggregation.

AUTHOR

       This program was written by Roberto S. Galende <roberto.s.galende@gmail.com> and is copyrighted under the
       GPL, version 3 or later.

                                                December 5, 2016                                 BYTES-CIRCLE(1)