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

See Also