tploot-ff.1 - ploot - simple plotting tools
 (HTM) 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.