ploot.1: added the man page - ploot - simple plotting tools
HTML git clone git://bitreich.org/ploot git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/ploot
DIR Log
DIR Files
DIR Refs
DIR Tags
DIR README
DIR LICENSE
---
DIR commit ce36f2cd7e693f28c0d43aa0af168d42ef4f0547
DIR parent 6c194ce4e4df4e4020a7b1997c3e1d063cc7c4b1
HTML Author: Josuah Demangeon <mail@josuah.net>
Date: Fri, 16 Feb 2018 12:57:48 +0100
ploot.1: added the man page
Diffstat:
A ploot.1 | 94 +++++++++++++++++++++++++++++++
1 file changed, 94 insertions(+), 0 deletions(-)
---
DIR diff --git a/ploot.1 b/ploot.1
@@ -0,0 +1,94 @@
+.Dd $Mdocdate: February 15 2018$
+.Dt PLOOT 1
+.Os
+.
+.
+.Sh NAME
+.
+.Nm ploot
+.Nd plain text plotting tool
+.
+.
+.Sh SYNOPSIS
+.
+.Nm
+.Op Fl h Ar height
+.Op Fl o Ar offset
+.Op Fl t Ar title
+.
+.
+.Sh DESCRIPTION
+.
+The
+.Nm
+utility reads decimal values from stdin and print a plain text graph
+of the values to stdout.
+The values are separated by blanks or newlines, and can be either a plain
+list or a time serie
+.Po
+if the
+.Fl o
+flag is set
+.Pc
+.
+.Bl -tag -width 6n
+.
+.It Fl h Ar height
+Sets the height of the plot in characters.
+.
+.It Fl o Ar offset
+Read data as time series: the input alternates UNIX epoch and value
+to be plotted.
+The time stamps are assumed to be at an interval of
+.Ar offset .
+.
+.It Fl t Ar title
+Print
+.Ar title
+centered at the bottom of the graph.
+.
+.El
+.
+.
+.Sh EXIT STATUS
+.
+.Ex -std
+.
+.
+.Sh EXAMPLES
+.
+.Bd -literal
+% awk 'BEGIN { for (i=0; i<60; i++) print sin(i/3)+1 }' | ploot -h 10 -t List
+
+ | .... .... ....
+ 1.5963 -| ::::::. ::::::. .:::::: .:
+ |.::::::::. .::::::::. .::::::::. .::
+ 0.7982 -|::::::::::: .::::::::::. .::::::::::. ::::
+ |::::::::::::. ::::::::::::::. .:::::::::::::: .:::::
+ 0 -+------------------------------------------------------------
+ List
+.Ed
+.
+.Bd -literal
+% ploot -h 8 -o 200 -t 'Time series'
+1518780448 12 1518780643 13 1518780848 31 1518781028 19 1518781291 23
+1518781423 20 1518781687 10 1518781819 13 1518782215 22 1518782412 11
+1518782632 18 1518782822 11 1518783039 16 1518783235 21 1518783499 21
+1518786629 30 1518786812 28 1518787012 11 1518787202 11 1518787433 11
+1518787629 10 1518788042 16 1518788333 29 1518788494 26 1518788633 12
+1518788821 28 1518789072 11 1518789201 11 1518789421 11 1518789630 11
+
+ 31.000 -| : .. . .
+ | : .. . .. :: :: :
+ 15.500 -|..:::: . : : ::: :: :::.:
+ |:::::::: ::::::: :::::: :::::::::
+ 0 -+--------x-------xxxxxxxxxxxxxxx------x---------
+ 12:27 12:50 13:14 13:37 14:00 14:24 14:47
+ 2018/02/16 2018/02/16
+ Time series
+.Ed
+.
+.Pp
+The
+.Sq x
+symbols on the horizontal axis represent a lack of data for that interval.