BYTES-CIRCLE(1)

✨ NAME ✨

bytes-circle — bestie, this shows you byte statistics as an ASCII circle graph 💖 (it's in the General Commands Manual, iykyk, and the command is literally called bytes-circle)

🎀 SYNOPSIS 🎀

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

🦋 DESCRIPTION 🦋

okay so 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. no cap. it's giving data visualization but make it ASCII 💅

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

bytes-circle expects a colour terminal, though other options are available. (translation: it wants that rainbow, but it will survive without 🫶)

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. green = slay, red = not slay, blue = = ghost byte 👻

👑 OPTIONS 👑

• files — One or more files. If no file is indicated, standard input is used. (no file? bestie it'll just read from stdin, no biggie)
• -o {0|1|2|3} — 0=default | 1=no color | 2=numbers | 3=uncoloured numbers
• -b — 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. (monochrome era 😌)
• -B — ('Break') stop processing files on first error encountered.
• -g — ('Global') show summary values for file, when using -[sS].
• -l — List number of bytes counted, from 0 to 255.
• -L — List number of bytes counted, excluding zero valued.
• -Z — List number of bytes counted, but only zero valued.
• -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 (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.
• -v — Show program version and list chars used in coloured circle.
• -h — Show summary of options.
• -f # — ('From') analyze file from # byte on (1 implicit). SI suffixes supported.
• -s # — Slice file in slices of size # bytes. SI suffixes supported.
• -S # — Slice file in # slices. SI suffixes supported.
• -t # — ('To') analyze file until # byte. SI suffixes supported.
• -T # — ('To') analyze this # bytes from -f. SI suffixes supported.
• -z {0-255} — 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. (double the circle, double the vibe 🔥)

Note about SI suffixes: use one of kmgtpe (powers of 10), KMGTPE (powers of 2), and prefixes '0x' (hexadecimal number) and '0' (octal number). lowercase = base 10, uppercase = base 2, and the 0x / 0 prefixes are hex and octal respectively. don't mix them up bestie 🫶

💜 AUTHOR 💜

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

okay that's the whole page bestie, you ate that 🎀 version 3.1, dated August 2, 2021, from the General Commands Manual — go forth and graph those bytes, you absolute icon 💅✨🦋