---
name: "stripchart"
section: "5"
platform: "linux"
package: "boinc-cgi-stripchart"
version: "7.0.27+dfsg-5"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/stripchart/5"
---

# stripchart(5)

draws diagrams from data with PHP

## 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