igp

igp.rb is an interactive gnuplot program designed for easy 2D plotting of time series data from CSV files.

---

usage:

igp.rb [csv file a] [csv file b] ... etc.

by default, the first variable from [csv file a] is plotted in a new window, and details of all files are shown in the terminal. interactive-mode is established.

examples:

selecting variables for plotting:

a
plot each variable from [csv file a]

a6
plot variable 6 from [csv file a]

vn
plot the next variable in the file

vp
plot the previous variable in the file

a3,5
plot variable 3 from [csv file a], and variable 5 from all csv files

2,3
plot variables 2 and 3 from all csv files

changing the x-axis (time):

t
set the x-axis range to the largest extent of time

tv
set the x-axis range to the overlapping time

ta
set the x-axis range to the start and end times from [csv file a]

>y
set the x-axis to the next full year

3w
set the x-axis to 3 weeks from the current start time

2d
set the x-axis to 2 days from the current start time

6m
set the x-axis to 6 months from the current start time

0.25y
set the x-axis to 0.25 years from the current start time

s2008-6
set the x-axis start time to be June 1, 2008

s2001 e2004
set the x-axis range to be Jan 1, 2001 to Jan 1 2004

>
move one entire time axis forward in time

>>
move two whole time axes forward in time

3<
move 3 whote time axes backward in time

<>
expand time outward

><
shrink time inward

<4>
expand time outward, faster

|>>
retain the start time, but move the end time forward

>|
move the start time forward, but retain the end time

changing the y-axis (data):

y100,450
set the y-axis range from 100 to 450

y-5
set the y-axis lower limit to -5

y,85
set the y-axis upper limit to 85

y
set the y-axis to auto-mode (this will automatically determine the y-axis limits)

recognized options:

-s
toggle :show_cmd

-lw=2
set :linewidth to 2

-style=lp
set :style to linepoints

other:

i
display file info

q
quit the program

do the previous command again

assumptions about the input CSV files:

variable names must be a comma-separated list on a single line in the file,
beginning with the word 'fields,'

the input csv file(s) time format is '%Y-%m-%d %H:%M:%S'

any lines that begin with a non-numeric character are ignored in the input csv file(s)