Scroll to navigation

BYTES-CIRCLE(1) General Commands Manual BYTES-CIRCLE(1)


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


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


bytes-circle is a program that shows statistics about bytes contained in a file, as an ASCII circle graph of deviations from mean in standard deviation (sigma) fraction 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.


One or more files. If no file is indicated, standard input is used.
0=default | 1=no color | 2=numbers | 3=uncoloured numbers
No color (Black & white). 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.
('Break') stop processing files on first error encountered.
('Global') show summary values for file, when using `-[sS]`.
List number of bytes counted, from 0 to 255.
List number of bytes counted, excluding zero valued.
List number of bytes counted, but only zero valued.
Use Numbers. In this case, coloured numbers are used to represent values from 0 to 9/4*sigma.
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.
Use Uncoloured numbers (equivalent to `-b -n`). 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.
Show program version and list chars used in coloured circle.
Show summary of options.
('From') analyze file from # byte on (1 implicit). SI suffixes supported.
Slice file in slices of size # bytes. SI suffixes supported.
Slice file in # slices. SI suffixes supported.
('To') analyze file until # byte. SI suffixes supported.
('To') analyze this # bytes from `-f`. SI suffixes supported.
Show 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.


This program was written by Roberto S. Galende <> and is copyrighted under the GPL, version 3 or later.

August 2, 2021 3.1