stripchart(5) 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