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
- You need to hit a key to bring up the the interactive menu. This
key value is then ignored. If you hit the command key you want to bring
up the menu, you still need to enter it again for the menu to read it.
- You can stretch the window to get a larger display. To replot in
the new window, use the r command of the interactive menu.
return to: filter_programs
return to: home_~phil