|
|
tploot-ff.1 - ploot - simple plotting tools |
|
|
 |
git clone git://bitreich.org/ploot git://hg6vgqziawt5s4dj.onion/ploot (git://bitreich.org) |
|
|
 |
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 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. |
|