tploot-ff.1 - ploot - simple plotting tools
HTML git clone git://bitreich.org/ploot git://hg6vgqziawt5s4dj.onion/ploot
DIR Log
DIR Files
DIR Refs
DIR Tags
DIR README
---
tploot-ff.1 (1666B)
---
1 .Dd $Mdocdate: August 08 2018$
2 .Dt PLOOT-FF 1
3 .Os
4 .
5 .
6 .Sh NAME
7 .
8 .Nm ploot-ff
9 .Nd produce a farbfeld image of csv input
10 .
11 .
12 .Sh SYNOPSIS
13 .
14 .Nm ploot-ff
15 .Op Fl t Ar title
16 .Op Fl u Ar unit
17 .Ar colors...
18 .
19 .
20 .Sh DESCRIPTION
21 .
22 The
23 .Nm
24 utility plots an image in the farbfeld format out of csv values coming from stdin.
25 .
26 .Bl -tag -width 6n
27 .
28 .It Fl t
29 Set the title of the plot printed at the top left corner.
30 .
31 .It Fl u
32 Set the unit description printed at the top right corner.
33 .
34 .It Ar colors
35 List of argument that specify the color for each column.
36 If the input csv have 5 columns in addition of the timestamp, there must
37 be 5 maxval arguments.
38 Colors available are red, orange, yellow, green, cyan and blue.
39 .
40 .El
41 .
42 .Pp
43 The input format is documented in the
44 .Xr ploot-csv 7
45 manual page.
46 .
47 .
48 .Sh EXIT STATUS
49 .Ex -std
50 .
51 .
52 .Sh EXAMPLES
53 .
54 .Bd -literal -offset indent
55 $ cat <<EOF >sample.txt
56 epoch,used_memory,free_memory
57 1533752053,160,401
58 1533752054,180,381
59 1533752055,301,260
60 1533752056,303,258
61 EOF
62 $ ploot-ff -t demo -u MB red yellow <sample.txt
63 .Ed
64 .
65 .
66 .Sh SEE ALSO
67 .
68 .Xr ploot-ff 1 ,
69 .Xr ploot-csv 7
70 .
71 .Pp
72 The
73 .Xr farbfeld 7
74 image format:
75 .Lk https://tools.suckless.org/farbfeld/
76 .
77 .
78 .Sh HISTORY
79 .
80 .Nm
81 earned its author a bitreich.org medal of misspelled program name.
82 .
83 .Pp
84 .Nm
85 was written at
86 .Lk gopher://bitreich.org/1/scm/ploot/ "Bitreich"
87 .
88 .
89 .Sh AUTHORS
90 .
91 .An Josuah Demangeon
92 .Aq Mt mail@josuah.net
93 .
94 .
95 .Sh BUGS
96 .
97 .Nm
98 does not make any math on the input: if the timestamps are not at regular
99 interval, ploot will still print one output line every 4 lines read,
100 regardless of the time interval.
101 .
102 .Pp
103 However, the timestamp printed on the left is always exact.