NAME
stripchart - draws diagrams from data with PHP
SYNOPSIS
The script is expected to be called as a CGI script but also works from the command line.
DESCRIPTION
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
AUTHORS
Matt Lebofsky