stripchart(5)

Usage

The script is expected to be called as a CGI script but also works from the command line.

Overview

Stripchart prepares a series of diagrams directly from raw data. It is handy for web pages that need some graphics without too much overhead.

Options

`-i input FILE`	name of input data file (mandatory)
`-o output FILE`	name of output .gif file (default: STDOUT)
`-O output FILE`	name of output .gif file, also dumps to STDOUT
`-f from TIME`	stripchart with data starting at TIME (default: 24 hours ago)
`-t to TIME`	stripchart with data ending at TIME (default: now)
`-r range RANGE`	stripchart data centered around "from" time the size of RANGE (overrides -t)
`-l last LINES`	stripchart last number of LINES in data file (overrides -f and -t and -r)
`-T title TITLE`	title to put on graphic (default: FILE RANGE)
`-x column X`	time or "x" column (default: 2)
`-y column Y`	value or "y" column (default: 3)
`-Y column Y'`	overplot second "y" column (default: none)
`-b baseline VALUE`	overplot baseline of arbitrary value VALUE

-B baseline-avg: overrides -b, it plots baseline of computed average

`-d dump low VALUE`	ignore data less than VALUE
`-D dump high VALUE`	ignore data higher than VALUE

-v verbose: puts verbose runtime output to STDERR

-L log: makes y axis log scale

-c colors "COLORS": set gnuplot colors for graph/axisnts/data (default: "xffffff x000000 xc0c0c0 x00a000 x0000a0 x2020c0" in order: bground, axisnts, grids, pointcolor1,2,3)

-C cgi: output CGI header to STDOUT if being called as CGI

-s stats: turn extra plot stats on (current, avg, min, max)

-j julian times: time columns is in local julian date (legacy stuff)

-V version: print version number and exit

-h help: display this help

Notes

* TIME either unix date, julian date, or civil date in the form:
YYYY:MM:DD:HH:MM (year, month, day, hour, minute)
If you enter something with colons, it assumes it is civil date
If you have a decimal point, it assumes it is julian date
If it is an integer, it assumes it is unix date (epoch seconds)
If it is a negative number, it is in decimal days from current time
(i.e. -2.5 = two and a half days ago)
* All times on command line are assumed to be "local" times
* All times in the data file must be in unix date (epoch seconds)
* RANGE is given in decimal days (i.e. 1.25 = 1 day, 6 hours)
* if LINES == 0, (i.e. -l 0) then the whole data file is read in
* columns (given with -x, -y, -Y flags) start at 1
* titles given with -T can contain the following key words which will
be converted:
FILE - basename of input file
RANGE - pretty civil date range (in local time zone)
the default title is: FILE RANGE