Online monitoring of the telescope and system

aug,2007

Monitor programs
Dumping monitor and data files.
History

Online monitoring displays of the telescope are now available from Linux and Solaris computers on AOnet. The displays use the online information that is sent out over the local ethernet once a second (multi cast data in computer lingo) or data that is written to a file. Some of the routines are text based (tcl/Tk) while others generate graphics (via idl). There are options that allow you to change how the program appears. Since all of the displays are X based, you can send the output to any x display (via the DISPLAY environment variable).

Running the programs:

logon (or slogin) to a Linux or Solaris machine on AO net.

Solaris: It will not work on the "pointing" computer in the control room (since it isn't on aonet).
Linux: The scripts are in /pkg/aosoft/common/bin. The executables have been compiled for the i386 fedora version (i'll get to the 64 bit version one of these days). If the routines are not found on your computer, make sure your path includes:

/pkg/aosoft/common/bin and /pkg/aosoft/fedora4/i386/bin.

Example:
monpnt
montel
montie
montie 8

Available monitor programs:

Text Based Progs	Options	OS	Monitor Function	Notes
monallsm	kill	L,S	start monpnt,monif,montel, and montie. Use smaller fonts.	1.
monif	all	L,S	The upstairs and downstairs IF/LO	2.
monpnt	all	L,S	The requested pointing positions, errors, etc.
monrcv	pos,fg,bg,font,kill	L,S	The dewar temperatures, voltages, and currents. source: /share/megs/phil/svn/pdev/aosoft/src/rcvMonGet.c see also rcvMonProgN.c
monrcvtemp	pos,fg,bg,font,kill	L,S	The dewar temperatures. source: /share/megs/phil/svn/pdev/aosoft/src/rcvMonGet.c
montel	all	L,S	The azimuth, gregorian, and carriage house system
montie	all	L,S	A summary of the 3 tiedowns.
montie 12,4,or 8	all	L,S	A more detailed monitoring of an individual tiedown.
montur	all	L,S	The turret floor in the gregorian receiver room.
plattemp	none	L	print platform temperature then exit: dayNum:174 tm:14:40:10 temp:79.35
Graphic Programs
monplthght	kill , yymmdd	L,S	Monitor the platform height using the distomats (idl). The default is to monitor the current day. If a date is entered (eg 050709 ,yymmdd) then that day will be plotted.
monmottq	kill,pc, az,gr,ch,yymmdd	L,S	monitor the gregorian motor torques (idl). select az,gr, or ch to monitor (default is gregorian dome) yymmdd specifies the date (default is current day)
monrcvpl monrcvplvm	kill kill	L,S S	Plot 16K dewar temp for the current day. Update every 22 secs Same as monrcvpl but uses idl virtual machine (no license used)
imgui	none	L,S	An idl gui to look at the hilltop monitoring data. Can be run from a Solaris or linux machine.

Notes:
For the OS column, L =Linux (32 bit), S=Solaris

monnallsm starts many programs so it does not support any options.
the default update rate for monif is about 4 seconds (since the if/lo changes very slowly).

Program options:

The mon programs accept options that allow you to modify certain parameters. They are entered on the same line as the command. The options are:

pos +x+y

fg color

bg color

fl color

Some programs (montie, montur) will flash data values that are outside an allowable range. The default color used for flashing is red. The fl keyword lets you change the flash color to something else.

time secs

The number of seconds to delay between each update. This lets you slow down the i/o rate. It is handy for people logging in over slow network connections.

font fontindex

kill

How the displays work:

For each monitor there is a "get" program that connects to the multi cast data on ethernet, reads the data blocks that are needed, formats the output data, and writes this data as ascii to standard output. A wish script reads this data and displays it in the dedicated display window.

The "get" program binaries are in ~phil/Solaris/bin/ on solaris and /pgk/aosoft/fedora4/i386/bin on Linux . The source codes are in

Solaris: ~phil/vw/shm/Mon/(Agc,If,Pnt,Tie,Tur)/xxxMonGet.c
Linux: ~phil/Linux/filters/

If the "get" programs are run by themselves, then an ascii display will be updated on your terminal once a second with the data. An example is:

~phil/vw/Solaris/pntMonGet
start
trk :  onSrc      master:Gr      wrap:0
ast :  10:39:26.0 dut1Ms: -288   secM:38366
lmst:  08:35:03.9    mjd:52513   tolA:100000

Pos :  05:21:14.4  28:09:50.0 Cs:B Tm:imd
Off :
Rat :
Rslt:  05:24:23.5  28:12:31.8 Cs:J
ha  :  03:10:31.1
          az deg       za deg     totErr
cor :      0.1061      -0.0637
reqP:    112.0028      44.4967
curP:    251.7287       9.9129
errP:   -139.7259      34.5838    77704.3"

vHel:     27.7560 vGeo:-0.2867    km/sec
pend:   none
stat:\  OK
cumO:  0.00000  0.00000 deg
end

There is a single wish script that drives all of the monitor displays (~phil/vw/shm/Mon/monProg.sh). Each display has a configuration file in ~phil/vw/shm/Mon/Setups that customizes the window size, fonts, colors, etc.. Each monxxx above then has a line that looks like:
/usr/S2local/bin/wish -file /home/phil/vw/datatk/shm/Mon/monProg.sh tieMonSum.init $* 2>/dev/null &

The graphics programs run off of datafiles that are being written to disc. Idl is started from a script that contains the idl commands to execute. These scripts use the tcl script /home/phil/Sunos/bin/newProg.tcl to stop any old copies before starting the new one.

Dumping monitor datafiles

A number of routines have been written to dump the contents (or partial contents) of some montor/data files. They all run on Solaris and Linux. The linux programs are in the /pkg/aosoft directory hiearchy which is only available on the newer fedora machines.

program	OS
cordmp -c -d -f firstChar filename -c Only output the 1st scan of each calibrate pattern -d Output debugging info as file is read -f firstChar ..Prepend this char to each line output. filename .. Filename to output. Dump a summary of interim correlator hdr records to stdOut. It calls the program cordmprg.	S,L
dmphdrs -h -b -f filename -h .. print help msg and quit -b .. if you hit a bad hdr, keep on searching. Use for atm files where the start of the file is not a hdr. -f filename .. filename to dump Dump the headers from an interim correlator or ri datafile. Works for cordata, some atm data, and maybe the radar files. Calls the programs: stripVme and then printHdr.	S,L
masdmp filename Dump some information about a pdev fits file... still being developed. (uses idl).
tiedump -d devNum yymmdd blkstoSkip -d devNum .. tds to include in dump (1=td12,2=td4,4=td8). You can or them together. The default is 7 (all tiedowns). yymmdd .. date to dump blksToSkip .. number of seconds to before dumping. Negative numbers count from the end of the the file.
wasdmp filename Dump a summary of was (wapp) fits files. Uses idl.	S,L

History (top)

22jun08: monrcvpl. added options for dana...

-h print the options description message and exit
-l Make vertical scale logarithmic.
-t 16,70,omt which stage to monitor. (note that the 70K stage is currently not monitored).
-v minValue maxValue vertical scale for the display. (note: -l does not like minValue <=0).
(logarithmic scale) -v (min max values) -t (16,70,omt) to display.

 home_~phil