CASPIR is controlled by typing DCL commands into the Control window on the MOPRA workstation screen. A status window displays system parameters in its upper section and scrolls information in its lower section. Faults are displayed as flashing symbols on the bottom line of the Status Display window. Two image display windows are also provided. The upper display is the Idle Display, and the lower display is the Run Display. These both use a version of FIGDISP, the image display used with UNIX FIGARO. When no run is active, the system continuously takes data using idle readout parameters, and displays it in the Idle Display. This provides an almost real time display of the infrared sky which is useful for focusing and acquiring objects. When a data run is initiated (either by the CASPIR/RUN command or the CASPIR/DO command), the idle loop is interrupted and real integrations begin. On completion, the acquired data are displayed in the Run Display, and the system automatically returns to the idle loop.
The following sections describe this system in more detail. The CASPIR software is located in the directory with the logical name IR_CASPIR which has open read-only access.
The CASPIR dewar is controlled through the CASPIR DCL command. The following subsections describe the command qualifiers used with the CASPIR command. When the infrared system is started, the command procedure in IR_CASPIR:CASPIR.COM is executed to make the composite definitions listed below. These are offerred to simplify the control operations. If any of these get inadvertantly redefined they can be deleted by typing, e.g.:
DELETE/SYMBOL FILTER
and then redefined by typing the appropriate line listed below.
f*ilter :== caspir/filter=
uf*ilter :== caspir/ufilter=
lf*ilter :== caspir/lfilter=
a*perture :== caspir/aperure=
u*tility :== caspir/utility=
l*ens :== caspir/lens=
mo*de :== caspir/mode=
m*ethod :== caspir/method=
t*ime :== caspir/time=
c*ycles :== caspir/cycles=
p*eriod :== caspir/period=
re*peats :== caspir/repeats=
im*ethod :== caspir/imethod=
it*ime :== caspir/it=
ic*ycles :== caspir/icycles=
ip*eriod :== caspir/iperiod=
r :== caspir/run
b*ias :== caspir/bias
d*ark :== caspir/dark
do :== caspir/do=
abort :== caspir/abort
su*btract :== caspir/subtract=
di*vide :== caspir/divide=
isu*btract :== caspir/isubtract=
idi*vide :== caspir/idivide=
zmi*nimum :== caspir/zminimum=
zma*ximum :== caspir/zmaximum=
za*utoscale :== caspir/zautoscale
izmi*nimum :== caspir/izminimum=
izma*ximum :== caspir/izmaximum=
iza*utoscale :== caspir/izautoscale
fa*st :== caspir/apert=fastclr/util=clear/lens=fastcam/mode=direct
sl*ow :== caspir/apert=fastclr/util=slowcam/lens=clear/mode=direct
jg*rism :== caspir/apert=lslit1/ufilter=clear/util=j_grism/lfilter=clear-
/lens=fastcam/mode=direct
hg*rism :== caspir/apert=lslit1/ufilter=clear/util=h_grism/lfilter=clear-
/lens=fastcam/mode=direct
kg*rism :== caspir/apert=lslit1/ufilter=clear/util=k_grism/lfilter=clear-
/lens=fastcam/mode=direct
ijg*rism :== caspir/apert=sslit1/ufilter=clear/util=ij_grism/lfilter=clear-
/lens=fastcam/mode=direct
jhg*rism :== caspir/apert=sslit1/ufilter=clear/util=jh_grism/lfilter=clear-
/lens=fastcam/mode=direct
hkg*rism :== caspir/apert=sslit1/ufilter=clear/util=hk_grism/lfilter=clear-
/lens=fastcam/mode=direct
grid*pol :== caspir/apert=fastclr/ufilter=grid/util=clear/lens=fastcam-
/mode=polarimetry
pr*ismpol :== caspir/apert=polar/util=wollaston/lens=fastcam/mode=polarimetry
j :== caspir/filter=j/imethod=2/itime=5/icycles=1/method=2/time=5-
/cycles=12/repeats=1
h :== caspir/filter=h/imethod=2/itime=5/icycles=1/method=2/time=5-
/cycles=12/repeats=1
k :== caspir/filter=k/imethod=2/itime=5/icycles=1/method=2/time=5-
/cycles=12/repeats=1
kp :== caspir/filter=kp/imethod=2/itime=5/icycles=1/method=2/time=5-
/cycles=12/repeats=1
kn :== caspir/filter=kn/imethod=2/itime=5/icycles=1/method=2/time=5-
/cycles=12/repeats=1
nbl :== caspir/filter=cont3.6/imethod=1/itime=0.2/icycles=50/method=1-
/time=0.2/cycles=300/repeats=1
Helium :== caspir/filter=helium/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
PGamma :== caspir/filter=pgamma/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
PBeta :== caspir/filter=pbeta/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
Cont16 :== caspir/filter=cont1.6/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
FeII :== caspir/filter=feii/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
AAOFeII :== caspir/filter=aaofeii/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
H2O :== caspir/filter=h2o/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
H2_1_0 :== caspir/filter=h2_1_0/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
BrGamma :== caspir/filter=brgamma/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
Cont22 :== caspir/filter=cont2.2/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
H2_2_1 :== caspir/filter=h2_2_1/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
CONB :== caspir/filter=co/imethod=2/itime=5/icycles=1/method=2-
/time=5/cycles=12/repeats=1
Ice :== caspir/filter=ice/imethod=1/itime=0.2/icycles=50/method=1-
/time=0.2/cycles=300/repeats=1
Dust328 :== caspir/filter=dust3.28/imethod=1/itime=0.2/icycles=50/method=1-
/time=0.2/cycles=300/repeats=1
Dust34 :== caspir/filter=dust3.4/imethod=1/itime=0.2/icycles=50/method=1-
/time=0.2/cycles=300/repeats=1
Cont36 :== caspir/filter=cont3.6/imethod=1/itime=0.2/icycles=50/method=1-
/time=0.2/cycles=300/repeats=1
Cont40 :== caspir/filter=cont4.0/imethod=1/itime=0.2/icycles=50/method=1-
/time=0.2/cycles=300/repeats=1
BrAlpha :== caspir/filter=bralpha/imethod=1/itime=0.2/icycles=50/method=1-
/time=0.2/cycles=300/repeats=1
The Idle and Run image displays are based on the FIGDISP program used with UNIX FIGARO. In essence, they operate in a way which will be familiar to FIGARO users. However, some modifications have been necessary in porting the program to VMS. Specifically, in the function key definitions which control the program, and in the way the window is activated.
Under VMS, you must click in the window to make it active. Since FIGDISP will pan the image to that position if you click in the display part of the window, it works better clicking in the window title bar. Similarly, you must remember to click in the command entry window again before entering CASPIR commands.
The FIGDISP functions and their binding in the infrared environment are listed below. Consult the FIGDISP manual for further explanation of what they do.
Left button - Pan the image. Middle button - Display an arbitrary line plot between start and end points. Right button - Manipulate the color look-up tables. F2 - Zoom in. F3 - Reset to normal zoom factors. F4 - Zoom out. PF1 - Zoom in X coordinates. PF2 - Zoom out X coordinates. PF3 - Zoom in Y coordinates. PF4 - Zoom out Y coordinates. F5 - Print help text. F6 - Toggle cursor display. F7 - Re-center image. F8 - Toggle display of the location window. F10 - Toggle display of the color map window. F11 - Toggle display of the pixel value window. F12 - Display a row plot in the line graphics window. F13 - Print the whole image. F14 - Print the visible portion of the image. F16 - Inhibit keystroke interpretation until this key is pressed again. F18 - Toggle color map inversion. F19 - Toggle display of centroid/FWHM window for star near cursor. F20 - Display a column plot in the line graphics window. , - Decrease number of pixels averaged for a line plot. . - Increase number of pixels averaged for a line plot. / - Reset number of pixels averaged for a line plot.
The CASPIR detector array must be held accurately at its operating temperature of 32 K. This is achieve by the use of a Lakeshore Cryotronics Model 330 temperature controller which is located on top of the Cassegrain Instrument Rack in the 2.3 m Nasmyth Lab. This controller can be configured through front panel controls, or via RS-232 commands. While the infrared control software is running, a subprocess continually monitors both the array temperature, which is actively servoed to a preset value, and a second temperature sensor attached to the camera body. These functions are controlled through the following DCL TEMPERATURE commands:
The IMB command qualifiers were fully described in the original Infrared Users Manual and are repeated here for completeness. The IMB includes the grism calibration lamp module which is controlled by the IMB command.
A telescope paddle appears on the MOPRA workstation screen during system startup (if ENLIST IR has been typed). This paddle consists of a 3 x 3 grid with NSEW boxes labelled accordingly. The first mouse button (the left one for a righthanded setup) is used to offset the telescope by clicking on the appropriate box. All eight outer boxes respond in the obvious way. The first mouse button does not respond to clicks in the central square. The default telescope offset is 1.0 arcsec. This offset can be increased in factors of two by clicking the second (middle) mouse button in the central square. Similarly, it is decreased by clicking the third mouse button in the central square. The second and third mouse buttons do not respond to clicks in any other squares.