tploot-ff.1 - ploot - simple plotting tools | |
git clone git://bitreich.org/ploot git://hg6vgqziawt5s4dj.onion/ploot | |
Log | |
Files | |
Refs | |
Tags | |
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 f… | |
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 [email protected] | |
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. |