.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.4.
.TH STRIPCHART "5" "November 2002"	2.21
.SH NAME
stripchart \- draws diagrams from data with PHP
.SH SYNOPSIS
The script is expected to be called as a CGI script but also
works from the command line.
.SH 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.

.SH OPTIONS
.TP 
\fB\-i\fP input FILE
name of input data file (mandatory)
.TP 
\fB\-o\fP output FILE
name of output .gif file (default: STDOUT)
.TP 
\fB\-O\fP output FILE
name of output .gif file, also dumps to STDOUT
.TP 
\fB\-f\fP from TIME
stripchart with data starting at TIME (default: 24 hours ago)
.TP 
\fB\-t\fP to TIME
stripchart with data ending at TIME (default: now)
.TP 
\fB\-r\fP range RANGE
stripchart data centered around "from" time the size of RANGE (overrides \-t)
.TP 
\fB\-l\fP last LINES
stripchart last number of LINES in data file (overrides \-f and \-t and \-r)
.TP 
\fB\-T\fP title TITLE
title to put on graphic (default: FILE RANGE)
.TP 
\fB\-x\fP column X
time or "x" column (default: 2)
.TP 
\fB\-y\fP column Y
value or "y" column (default: 3)
.TP 
\fB\-Y\fP column Y'
overplot second "y" column (default: none)
.TP 
\fB\-b\fP baseline VALUE
overplot baseline of arbitrary value VALUE
.TP 
\fB\-B\fP baseline-avg
overrides \-b, it plots baseline of computed average
.TP 
\fB\-d\fP dump low VALUE
ignore data less than VALUE
.TP 
\fB\-D\fP dump high VALUE
ignore data higher than VALUE
.TP 
\fB\-v\fP verbose
puts verbose runtime output to STDERR
.TP 
\fB\-L\fP log
makes y axis log scale
.TP 
\fB\-c\fP colors "COLORS"
set gnuplot colors for graph/axis\fonts/data (default: "xffffff x000000 xc0c0c0 x00a000 x0000a0 x2020c0" in order: bground, axis\fonts, grids, pointcolor1,2,3)
.TP 
\fB\-C\fP cgi
output CGI header to STDOUT if being called as CGI
.TP 
\fB\-s\fP stats
turn extra plot stats on (current, avg, min, max)
.TP 
\fB\-j\fP julian times
time columns is in local julian date (legacy stuff)
.TP 
\fB\-V\fP version
print version number and exit
.TP 
\fB\-h\fP help
display this help 

.SH 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
.SH AUTHORS

Matt Lebofsky