ploot-feed.1 - 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
---
ploot-feed.1 (1575B)
---
1 .Dd $Mdocdate: August 08 2018$
2 .Dt PLOOT-FEED 1
3 .Os
4 .
5 .
6 .Sh NAME
7 .
8 .Nm ploot-feed
9 .Nd plot a continuous stream of data from standard input.
10 .
11 .
12 .Sh SYNOPSIS
13 .
14 .Nm ploot-feed
15 .Op Fl w Ar width
16 .Ar maxval...
17 .
18 .
19 .Sh DESCRIPTION
20 .
21 The
22 .Nm
23 utility plots a text chart of tsv values coming from stdin in real time.
24 .
25 .Bl -tag -width 6n
26 .
27 .It Ar width
28 is the width of the plot in characters.
29 .
30 .It Ar maxval
31 is a list of argument that specify the maximum value for each column.
32 If the input tsv have 5 columns in addition of the timestamp, there must
33 be 5 maxval arguments.
34 .
35 .El
36 .
37 .Pp
38 The input format is documented in the
39 .Xr ploot-tsv 7
40 manual page.
41 .
42 .
43 .Sh EXIT STATUS
44 .Ex -std
45 .
46 .
47 .Sh EXAMPLES
48 .
49 .Bd -literal -offset indent
50 $ cat <<EOF >sample.txt
51 epoch free_memory process_count
52 1533752053 16.3 45
53 1533752054 18.7 42
54 1533752055 40.1 39
55 1533752056 40.1 39
56 EOF
57 $ ploot-feed -w 80 1 1 <sample.txt
58 .Ed
59 .
60 .
61 .Sh SEE ALSO
62 .
63 .Xr ploot-braille 1 ,
64 .Xr ploot-farbfeld 1 ,
65 .Xr ploot-text 1 ,
66 .Xr ploot-tsv 5
67 .
68 .
69 .Sh HISTORY
70 .
71 .Nm
72 earned its author a bitreich.org medal of misspelled program name.
73 .
74 .Pp
75 .Nm
76 is developped at
77 .Bl -ohang
78 .It
79 .Lk gopher://bitreich.org/1/scm/ploot/ "Bitreich project index"
80 .It
81 .Lk git://bitreich.org/1/ploot/ "Bitreich public repo"
82 .El
83 .
84 .
85 .Sh AUTHORS
86 .
87 .An Josuah Demangeon
88 .Aq Mt me@josuah.net
89 .
90 .
91 .Sh BUGS
92 .
93 .Nm
94 does not make any math on the input: if the timestamps are not at regular
95 interval, ploot will still print one output line every 4 lines read,
96 regardless of the time interval.
97 .
98 .Pp
99 However, the timestamp printed on the left is always exact.