Background
When the observer clicks on the Default
DEIMOS configuration button on the Dashboard, the
software will attempt to send stages to their "nominal"
positions; i.e., the position in which they should be stored
when the instrument is ready for use. Note that this is
different from the "home" position, defined as the position at
which the stage's encoder reads its index mark and resets to
zero.
The stowPositions.tcl File
The stow positions are defined in the file called
/local/kroot/data/deimos/stowPositions.tcl
which lives on deimosserver (aka polo) and
is owned by the kics account. This file takes the
form of a sequence of Tcl commands that are executed by the
Dashboard software. Here are the contents as of 2008-Jul-30:
#!/local/ucolick/tcl831/bin/tcl
#
# Name:
# /local/kroot/data/deimos/stowPositions.tcl
#
# Type:
# tcl script
#
# Invocation:
# This file is SOURCED by dashboard, not executed like a shell script.
# (therefore the hashbang line above is irrelevant)
#
# Caveat:
# You may edit the stow (default) values herein at your own risk.
# However, beware of adding whole new line entries unless you know
# for a fact that the keywords are "known" to the GUI.
#
# Author:
# De Clarke (de-at-ucolick.org)
#
# Modification history:
# 2003-May-19 de Original version
# 2003-May-19 gwirth Changed tvfocus to 970
# 2004-Oct-07 gwirth Changed tvfocus to 930 following guider service
# Changed DWFILORD to 6=R
# 2005-Apr-08 gwirth Added more CCD keywords
# 2005-May-03 gwirth Added even more CCD keywords (VIDOFFn)
# 2005-Aug-25 gwirth Updated VIDOFFs
# 2006-Mar-22 gwirth Updated VIDOFFs
# 2006-Apr-11 MK Updated VIDOFFs
# 2006-may-08 MK Updated TVfocus from 930 to 980
# 2006-Jul-21 GDW Updated VIDOFFs
# 2006-Sep-12 MK Updated VIDOFFs
# 2006-Sep-14 GDW Updated TVfocus from 980 to 930
# 2008-Jan-04 GDW Updated TVfocus from 950 to 1020
# 2008-Jan-26 GDW Added GRATOFFx
# 2008-Mar-04 GDW Updated VIDOFFs
# 2008-Apr-27 GDW Updated VIDOFFs
# 2008-Apr-27 GDW Change TVFOC to 973
# 2008-Jul-25 GDW Updated VIDOFFs
# 2008-Jul-30 GDW Update GRATOFF4
#------------------------------------------------------------------------
global Stow
keylset Stow(TVFIL) srv deimot kwd TVFILORD val 4
keylset Stow(TVFOC) srv deimot kwd TVFOCVAL val 973
keylset Stow(DWFIL) srv deimot kwd DWFILORD val 6
keylset Stow(FOCUS) srv deimot kwd FOCUSVAL val -8000
keylset Stow(DWXL8) srv deimot kwd DWXL8VAL val -750
keylset Stow(SLMSK) srv deimot kwd SLMSKPOS val 0
keylset Stow(GRATE) srv deimot kwd GRATEPOS val 3
keylset Stow(G3TLT) srv deimot kwd G3TLTWAV val 7500
keylset Stow(G4TLT) srv deimot kwd G4TLTWAV val 7500
keylset Stow(TMIRR) srv deimot kwd TMIRRRAW val 4500
# add GRATOFFx keywords...
keylset Stow(G2OFF) srv deimot kwd GRATOFF2 val 27152
keylset Stow(G3OFF) srv deimot kwd GRATOFF3 val 49500
keylset Stow(G4OFF) srv deimot kwd GRATOFF4 val 50000
# don't include rotator PA for now.
# keylset Stow(ROTAT) srv deirot kwd ROTATVAL val 90
keylset Stow(ROTmod) srv deirot kwd ROTATMOD val Pos
keylset Stow(ROTdcs) srv deirot kwd ROTATDCS val 0
keylset Stow(hatch) srv deimot kwd HATCHPOS val closed
keylset Stow(lamps) srv deimot kwd LAMPS val Off
keylset Stow(Flamps) srv deimot kwd FLAMPS val Off
# PANEs never did get implemented. bummer.
# keylset Stow(pane) srv deiccd kwd PANE val "1 1 8192 8192"
keylset Stow(pane) srv deiccd kwd WINDOW val "0 0 0 2048 4096"
keylset Stow(bin) srv deiccd kwd BINNING val "1 1"
keylset Stow(etime) srv deiccd kwd TTIME val 1
# this is implicit
# keylset Stow(amps) srv deiccd kwd AMPMODE val DUAL:A+B
keylset Stow(mode) srv deiccd kwd MOSMODE val Direct
keylset Stow(shutter) srv deiccd kwd CSHUTTER val close
keylset Stow(speed) srv deiccd kwd CCDSPEED val fast
keylset Stow(fcs) srv deiccd kwd FCSMODE val 0
# these added by GDW 2005-Apr-08
keylset Stow(apane) srv deiccd kwd AUTOPANE val AlignArea
keylset Stow(frame) srv deiccd kwd ADDFRAME val true
keylset Stow(disk) srv deiccd kwd TODISK val true
keylset Stow(erase) srv deiccd kwd ERASECNT val 1
keylset Stow(aerase) srv deiccd kwd AUTOERAS val true
keylset Stow(aread) srv deiccd kwd AUTOREAD val true
keylset Stow(ashut) srv deiccd kwd AUTOSHUT val true
# CCD video offsets updated 2008-July-25
keylset Stow(vidoff1) srv deiccd kwd VIDOFF1 val 2536
keylset Stow(vidoff2) srv deiccd kwd VIDOFF2 val 2438
keylset Stow(vidoff3) srv deiccd kwd VIDOFF3 val 2502
keylset Stow(vidoff4) srv deiccd kwd VIDOFF4 val 2513
keylset Stow(vidoff5) srv deiccd kwd VIDOFF5 val 2557
keylset Stow(vidoff6) srv deiccd kwd VIDOFF6 val 2545
keylset Stow(vidoff7) srv deiccd kwd VIDOFF7 val 2519
keylset Stow(vidoff8) srv deiccd kwd VIDOFF8 val 2590
keylset Stow(vidoff9) srv deiccd kwd VIDOFF9 val 2376
keylset Stow(vidoff10) srv deiccd kwd VIDOFF10 val 2463
keylset Stow(vidoff11) srv deiccd kwd VIDOFF11 val 2498
keylset Stow(vidoff12) srv deiccd kwd VIDOFF12 val 2540
keylset Stow(vidoff13) srv deiccd kwd VIDOFF13 val 2404
keylset Stow(vidoff14) srv deiccd kwd VIDOFF14 val 2404
keylset Stow(vidoff15) srv deiccd kwd VIDOFF15 val 2359
keylset Stow(vidoff16) srv deiccd kwd VIDOFF16 val 2446
Notes
- If the stowPositions.tcl file does not exist
or there is any error sourcing it then the default values will
be used instead.
- Do try not to shoot self in foot by specifying 2 keywords
for the same stage (DWFOCVAL and
FOCUSVAL for example: only
FOCUSVAL should be used). Same goes for the
compound stages like slitmask and grating: use the highest
level keyword available.
See Also