.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "BRAILLEGRAPH 1"
.TH BRAILLEGRAPH 1 "2017-03-30" "" "braillegraph"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
braillegraph \- a simple histogram tool that produces text output
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBbraillegraph\fR <\fIdata series\fR
.PP
\&\fBpsql\fR \fB\-At\fR \fB\-c\fR 'select ...' \fB|\fR\fBbraillegraph\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBbraillegraph\fR takes a single data series and plots them abusing the
Braille range (U+2800..U+28FF).  It is able to display two values per a
horizontal character, thus a plain text mail can hold an X range up to ~150
data points.  The vertical resolution is 4/character, thus a reasonable Y
range is up to 80ish.
.PP
By default, no scaling is done at all — one dot is exactly one data point
horizontally, a value of 1 vertically.
.PP
Input is given as one non-negative integer per line.
.SH "EXAMPLE"
.IX Header "EXAMPLE"
.Vb 8
\& psql bugs \-A \-t \-c "
\& select
\&     count(case when arch=\*(Aqamd64 (x86_64)\*(Aq then 1 else null end)
\&     *80/count(*)
\& from (select arch, date_trunc(\*(Aqmonth\*(Aq, timestamp) as month from si) m
\& group by month
\& order by month
\& "|braillegraph
.Ve
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-h\fR, \fB\-\-horizontal\fR" 4
.IX Item "-h, --horizontal"
Horizontal layout.  The Y axis is left-to-right, X axis is top-to-bottom.
.IP "\fB\-m\fR, \fB\-\-max\fR \fInumber\fR" 4
.IX Item "-m, --max number"
Force the target range of the data.  Normally, the histogram will be
auto-sized based on the largest value in the input; this option sets the max
to a fixed value.  It will result either in empty space on the graph or in
values over the limit being hard-capped.
.Sp
You typically want this option when comparing multiple histograms, or when
continuously updating the display.
.IP "\fB\-y\fR, \fB\-\-y\-scale\fR \fInumber\fR" 4
.IX Item "-y, --y-scale number"
Scale the data so that the graph takes a given size (measured in dots)
instead of varying on the data given.  The size in characters is ¼
the dot size on a vertical graph, ½ on horizontal.
.SH "CAVEATS"
.IX Header "CAVEATS"
Versions of FreeFont older than end of 2016 make any Braille glyphs (both
for legitimate uses and for \fBbrailleimg\fR) totally unreadable at pixel sizes
commonly found in computer displays — ie, anything but HiDPI and/or very
large text sizes.  Alas, this font is commonly configured as primary
fallback in default setups shipped by distributions.
.SH "AUTHOR"
.IX Header "AUTHOR"
Adam Borowski <kilobyte@angband.pl>