 |
ploot.1: added the man page - ploot - simple plotting tools |
 |
git clone git://bitreich.org/ploot git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65… |
 |
Log |
|
Files |
|
Refs |
|
Tags |
|
README |
|
LICENSE |
|
--- |
|
commit ce36f2cd7e693f28c0d43aa0af168d42ef4f0547 |
|
parent 6c194ce4e4df4e4020a7b1997c3e1d063cc7c4b1 |
|
Author: Josuah Demangeon <[email protected]> |
|
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(-) |
|
--- |
|
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 |
|
|
|
+.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. |
