NAME

corstripch - interim correlator total power stripchart plotter

SYNTAX

corstripch {-c -f filename -h -m numpnts  -s -v1 min max -v2 min max} 

ARGS

-c                    use calfile as default file (instead of corfile)
-f     filename  file to plot. Default is /share/olcor/corfile (online file).
-h                    print help message
-m   npnts       number of time points to display at once. def: 600.
-r                    if on observer2, display on current screen.
-s                    subtract running mean before display
-v1 min max   set min, max plot values for upper plot
-v2 min max   set min ,max plot values for lower display

DESCRIPTION

    corstripch will make a stripchart recording of the total power by subcorrelator (sbc).   By default
it reads the online file "/share/olcor/corfile". If the -c option is used, it read "/share/olcor/calfile" which
is the default calibration file. The -f option lets you specify another file.

One window with two plot frames are created:

top frame       : total power vs time for each sbc in the file.
bottom frame: Polarization difference (PolA-PolB) for each sbc.

All plots are linear in power.

The user can specify various options when starting corstripch. After starting, a small menu can be
brought up by hitting any key on the keyboard. This menu contains:

command       function
q                     to quit
r                     rewind file
v1  min max   new min,max for top    window (no commas)
v2  min max   new min,max for bottom window (no commas)
blank line       ..continue

Entering one of the keys on the left will perform the described function and then go back to plotting.
This is mainly handy for quitting, changing the vertical scales, rewinding the file, or just stopping the plotting to
look at something interesting.

If the user is running from observer2 then  the window will appear on the upper right display screen.
If you want it on the observer2 screen use the -r option. All other users will have the window appear
on their current screen.

By default 600 points are plotted (this can be changed with the -m npnts option at startup). As new
points become available, they are plotted on the right side while the old points fall off the left. When
the program reaches the end of the file, it waits for more data to become available. To exit hit a
key for the interactive menu, and then q to quit.

The vertical scale of the plots  auto scales to the current  min,max values. You can set a fixed vertical
scale with the v1 and v2 options (or from the interactive menu). To look at small changes, the -s option
is useful. It removes a running mean (of the displayed points) before plotting the data.

RELATED PROGRAMS

    corstripch is a macro that processes the arguments and then calls corstripch.idl which is an idl
program. 

EXAMPLES

corstripch -f /share/olcor/corfile.01oct11.x111.1 -m 1000 -v1 .5 1.5
... plotting starts
--> user hits space bar bringing up interactive menu:
command function
q to quit
r rewind file
v1 min max new min,max for top window (no commas)
v2 min max new min,max for bottom window (no commas)
blank line ..continue
--> v2 -.2 .2
... continues plotting
... when end of file hit
--> user hits space bar
command function
q to quit
r rewind file
v1 min max new min,max for top window (no commas)
v2 min max new min,max for bottom window (no commas)
blank line ..continue
--> q .. to quit

FILES

/pkg/aosoft/common/bin/corstripch  - the macro that drives the program
/pkg/aosoft/common/etc/corstripch.idl - idl code that is executed.

ARCHITECTURES

    corstripch macro will run on any machine that has idl.

SEE ALSO

NOTES 

return to: filter_programs
return to: home_~phil