Background

The following tables list scripts that can be used to control DEIMOS and/or the telescope. These are useful for two things:

• As shortcuts, they can be entered on any polo command line to run the instrument in a command-line mode, as is done with NIRC
• As building blocks in DEIMOS shell scripts which can perform complex operations.

These commands are always available from any DEIMOS account when logged into the DEIMOS workstation, polo.

---

Contents

• CCD - Scripts for CCD control
• EXAMPLES - Examples of complex scripts
• FCS - Scripts for FCS control
• FRAME - Scripts for image names/numbers
• IMG - Scripts for taking images
• INFO - Scripts for gathering information
• MATH - Scripts for doing math
• MOT - Scripts for motor control
• TEL - Scripts for telescope control
• TV - Scripts for guider interaction

---

DEIMOS Script Library

CCD - Scripts for CCD control

• #direct# -- change CCD readout mode to direct
• direct -- change CCD readout mode to direct
• fullframe -- reset DEIMOS detector to read out entirety of each CCD
• oneamp -- set CCD to single-amp readout mode
• spectral -- change CCD readout mode to spectral, one amp
• tint -- set/show the exposure time on the DEIMOS science detector
• twoamps -- set CCD to dual-amp readout mode

EXAMPLES - Examples of complex scripts

• acquire_slit_alignment_exposure -- take a DEIMOS slitmask alignment exposure
• acquire_slit_alignment_exposure.old -- take a DEIMOS slitmask alignment exposure
• align_check -- check slitmask alignment between spectral exposures
• by3 -- acquire images in 3-pos pattern in DETECTOR coords w/ random dither
• calib -- acquire calibration data for DEIMOS slitmask(s)
• calib_blue -- acquire calibrations for blue-ish central wavelength
• deimos_flip -- acquire dithered/rotated image sequence for phot cal
• do_focusloop -- configure DEIMOS and run focusloop
• driftscan -- acquire image while drifting target across the slit
• getsky --
• getsky-align --
• goi_wffcs_loop -- exposure loop with fcs tracking
• image_user_masks -- acquire images of DEIMOS user slitmasks
• observe_flux_standard -- acquire spectra for monthly DEIMOS throughput test
• post_calib -- acquire calibration data for DEIMOS slitmask image(s)

FCS - Scripts for FCS control

• fcs_change_lamp -- update FCS reference files to use a new lamp
• fcs_logfile -- return name of the most recently-updated FCS logfile
• fcs_tint -- set or show the FCS integration time
• fcsdiff -- difference fcs the reference fcs image with the current fcs image
• fcsmov -- move a feature to a given position on the DEIMOS FCS image
• fcsview -- view FCS reference image in ds9
• goifcs -- acquire DEIMOS flexure compensation system image(s)
• lastfcsimage -- return full disk name of the most recent FCS image
• nextfcsimage -- return full disk name of the next FCS image
• wffcs -- wait for FCS to lock on target
• wfifcs -- wait for new DEIMOS FCS image to be written to disk

FRAME - Scripts for image names/numbers

• fname -- Build full DEIMOS file name from frame number
• frame -- set or show the frame number
• lastfile -- return the FRAMENO for the last saved image
• lastframe -- reset frameno to overwrite the last image
• lastimage -- return full disk name of the most recently acquired image
• lastimage.greg.august31 -- return full disk name of the most recently acquired image
• nextfile -- return one plus the FRAMENO of the last saved image
• nextframe -- reset FRAMENO to the specified value, or 1+last frame
• nextimage -- return full disk name of the next image

IMG - Scripts for taking images

• #focusloop# -- acquire images over a range of internal focus positions
• abortex -- kill any ongoing exposure
• bxy5 -- acquire images in 5-pos box pattern in DETECTOR coords
• bxy8 -- acquire images in 8-pos box pattern in DETECTOR coords
• bxy9 -- acquire images in 9-pos box pattern in DETECTOR coords
• focusloop -- acquire images over a range of internal focus positions
• goi -- acquire DEIMOS image(s)
• goibuf -- take DEIMOS image(s) without saving to disk
• goidark -- acquire dark DEIMOS image(s)
• goisleep -- acquire images with pauses in between
• level_check -- acquire a quick DEIMOS image to check exposure levels
• mosaic -- acquire mosaiced image sequence
• telfocloop -- acquire images over a range of secondary piston positions

INFO - Scripts for gathering information

• UTdate --
• apropos -- parse DEIMOS command help for requested string
• barcode2radec -- given slitmask barcode, return RA/Dec
• barcodes -- print the barcodes for all loaded slitmasks
• consort -- print sorted list of current configurable elements
• consort2 -- print sorted list of current configurable elements
• datadirs -- print summary of recent data directories
• deeplog -- generate logsheet data from image headers
• dir -- list FITS images in the current output directory
• disks -- print out a listing of available data disks
• help -- print documentation for a DEIMOS script, or list all scripts
• inventory -- convert between guiname, barcode, and blueprint ID
• is_float -- check whether the argument is floating point number
• masknames -- print the name(s) of currently-loaded slitmasks
• newday -- set up directory, filename prefix, etc.
• newdir -- create a new output directory for DEIMOS images
• nightpath -- return the path of the 'nightly' directory
• object -- show/change the OBJECT name
• observer -- set/show observer name(s)
• obslog -- generate logsheet data from image headers
• outdir -- set/show the current output directory
• pause -- suspend execution until user presses <RETURN>
• restore_state -- restore previously saved INSTRUMENT configuration
• save_state -- store instrument settings for future restoration
• script_done -- notify observer that a script has finished
• set_state -- reconfigure DEIMOS
• showkeywords -- list all DEIMOS keywords
• skey -- list all DEIMOS keywords
• tkmessage -- post a warning message using Tcl/Tk widget
• tolower -- convert argument(s) to lower case
• toupper -- convert argument(s) to upper case
• wfi -- wait for new DEIMOS image to be written to disk

MATH - Scripts for doing math

• abs -- return the absolute value
• ampang -- compute distance + bearing between two locations on DEIMOS image
• calc -- evaluate an arbitrary arithmetic statement using GAWK
• grand -- generate a normal (Gaussian) random value
• imarith -- perform simple image arithmetic
• irand -- generate a uniform random integer value between 0 and 32768
• rand -- generate a uniform random value between 0 and 1
• sex2dec -- convert from sexagesimal to decimal

MOT - Scripts for motor control

• cycle_shutter -- perform an open/close sequence on the DEIMOS CCD shutter
• domelamps -- turn spectral or imaging dome lamps on or off, or show status
• filter -- show or select the DEIMOS filter by name
• focus -- show or set the DEIMOS dewar focus value
• focus.new -- show or set the DEIMOS dewar focus value
• gozero -- set slider 3 or 4 to zeroth order imaging position
• gratecal -- recalibrate the tilt for the current grating
• grating -- show or select the DEIMOS grating and wavelength
• lamps -- turn DEIMOS calibration lamps on/off and show status
• rotang -- set/show physical DEIMOS rotator angle
• rotatcal -- home (calibratre) the DEIMOS rotator
• rotatloop -- step the rotator and pause between moves
• skypa -- set rotator celestial position angle in position angle mode
• slider -- show or select the DEIMOS grating slider position
• slitmask -- show or select the DEIMOS slitmask by name
• wavelen -- set/show the wavelength on the current slider

TEL - Scripts for telescope control

• ab -- acquire spectra in an AB sequence
• abba -- acquire spectra in an ABBA sequence
• az -- move the telescope x arcsec in azimuth
• azel -- move the telescope x arcsec in azimuth and y arcsec in elevation
• east -- move the telescope east
• el -- move the telescope x arcsec in elevation
• en -- move the telescope east and north
• gcent -- move an object to the center of the guider pickoff mirror
• gmov -- move an object to a given position on the DEIMOS guider
• gotobase -- move the telescope to return to the base coordinates
• gxy -- move the telescope in GUIDER coordinates
• markbase -- set the base telescope coordinates to the current coordinates
• mov -- move an object to a given position on the DEIMOS detector
• mx -- move telescope along rows in detector coordinate system
• mxy -- move telescope in instrument (detector) coordinates
• my -- move telescope along columns in detector coordinate system
• north -- move the telescope north
• pmfm -- set/show the amount of focus mode in the telescope primary
• polist -- list all of the defined pointing origins
• poname -- set or show the current pointing origin
• px -- move telescope along the "x" direction in DEIMOS pixel units
• pxy -- move telescope in pixel coordinates of the DEIMOS detector
• py -- move telescope along the "y" direction in DEIMOS pixel units
• ref2slit -- offset star at REF onto slit at (x,y)
• south -- move the telescope south
• telfoc -- set/show the telescope secondary position
• west -- move the telescope west
• wftel -- wait for telescope to complete a move

TV - Scripts for guider interaction

• lasttvimage -- return full disk name of the most recent TV image
• takeOffsetGuiderImage --
• tvfilter -- show or select the DEIMOS guider filter by name
• tvfocloop -- increment TV focus when images are saved
• tvfocus -- show or set the DEIMOS guider focus value
• tvgoi -- take DEIMOS guider image
• tvpower -- show or set state of DEIMOS guider power
• wftv -- wait for new TV image

---

Go to: DEIMOS Home Page - Instruments Home Page - Keck Home Page

---

DEIMOS Master

Last modified: