TCS SEQUENCER Script Reference

• tcs.setup-tel-alfosc [-e]
  Sets up the telescope for observing with ALFOSC.
  Currently equivalent to the commands:
  tcs.ag-off
  tcs.tcs-command idle
  tcs.tcs-command adc-arm-out
  tcs.auto-positioning-full
  tcs.camera-probe-park
  tcs.offset-size 10 10
  tcs.probe-step-size 5 5
  tcs.box-at-center
  tcs.background-box-position 400 400
  tcs.instrument-name ALFOSC
  tcs.field-rotation 90
  tcs.guide-star-automatic
  tcs.instrument-parallactic-angle 0
  tcs.focus-position 23230
  tcs.tv-focus 460
  

Note that the last command prepares the telescope to put horizontal slits onto the parallactic angle.
To prepare the telescope for vertical slits please execute the command

tcs.instrument-parallactic-angle 90

in a sequencer terminal, after running tcs.setup-tel-alfosc .
• tcs.setup-tel-fies [-e]
  Sets up the telescope for observing with FIES.
  Currently equivalent to the commands:
  tcs.ag-off
  tcs.tcs-command idle
  tcs.tcs-command adc-arm-out
  tcs.auto-positioning-full
  tcs.ccd-filter 2                     (STANCAM B-filter)
  tcs.camera-probe-stancam       (for full-frame STANCAM target-acquisition image)
  tcs.offset-size 3 3
  tcs.probe-step-size 0.3 0.3
  tcs.box-at-center
  tcs.background-box-position 400 400
  tcs.instrument-name FIES
  tcs.field-rotation 0
  tcs.guide-star-automatic
  tcs.instrument-parallactic-angle 90
  tcs.focus-position 23550
  tcs.tv-focus 520
  
• tcs.setup-tel-mosca [-e]
  Sets up the telescope for for observing with MOSCA.
  Currently equivalent to the commands:
  tcs.ag-off
  tcs.tcs-command idle
  tcs.tcs-command adc-arm-out
  tcs.auto-positioning-full
  tcs.camera-probe-park      
  tcs.instrument-name MOSCA
  tcs.field-rotation -90
  tcs.offset-size 10 10
  tcs.probe-step-size 5 5
  tcs.box-at-center
  tcs.background-box-position 400 400
  tcs.focus-position 23100
  tcs.tv-focus 440
  tcs.guide-star-automatic
  
• tcs.setup-tel-notcam [-e]
  Sets up the telescope for observing with NOTCam.
  Currently equivalent to the commands:
  tcs.ag-off
  tcs.tel-idle
  tcs.tcs-command adc-arm-out
  tcs.auto-positioning-full
  tcs.camera-probe-park
  tcs.offset-size 10 10
  tcs.probe-step-size 5 5
  tcs.box-at-center
  tcs.background-box-position 400 400
  tcs.instrument-name NOTCAM
  tcs.field-rotation -90
  tcs.guide-star-automatic
  tcs.instrument-parallactic-angle 0
  tcs.focus-position 23450                (default value for imaging with the WF-camera, check!)
  tcs.tv-focus 475
  
• tcs.setup-tel-stancam [-e]
  Sets up the telescope for normal imaging with STANCAM.
  Currently equivalent to the commands:
  tcs.ag-off
  tcs.tcs-command idle
  tcs.tcs-command adc-arm-out
  tcs.auto-positioning-full
  tcs.ccd-filter 0                 (STANCAM no filter)
  tcs.camera-probe-stancam      
  tcs.instrument-name STANCAM
  tcs.field-rotation 0
  tcs.offset-size 10 10
  tcs.probe-step-size 5 5
  tcs.box-at-center
  tcs.background-box-position 400 400
  tcs.focus-position 23040
  tcs.tv-focus 420
  tcs.guide-star-automatic
  
• tcs.guide-object objectname
A modified version of 'goto-object'. Waits for the guidestar to have settled in the center of the guidebox before returning the prompt to the user.
• tcs.guide-object-with-parallactic objectname
A modified version of 'preset-with-parallactic-angle-to-selected'. Waits for the guidestar to have settled in the center of the guidebox before returning the prompt to the user.
• tcs.store-tel <filename>
  Saves current TCS settings, to be restored later with tcs.restore-tel .
  The data file will be stored in the current working directory. If the file already exists, it will be overwritten.

• tcs.restore-tel [-e] [-noconfirm] <filename>
  Restores saved TCS settings, stored by tcs.store-tel .

  The data will be read from file <filename> in the current working directory.
  If the store file is more than 10 hours old, a warning will be issued, but the script will continue.

  Interactive confirmation is prompted for, except when the -noconfirm flag is given on the command line.

  If a stored value is different from the current DB value, then the appropriate restoring TCS command will be issued from the Sequencer.

  In order for the TCS to accept changes for certain parameters, this script switches off autoguiding, and leaves it off.

  Note that several restored parameters will be reset by the TCS at the next preset:
  - tv-focus
  - equatorial-offset
  - horizontal-offset
  - guide-probe-position
  which implies that this script has to be rerun after presetting if these parameters need to be restored properly.

  Currently uses the following commands to restore the settings:
  - tcs.tcs-command "Rotator-Manual"
  - tcs.tcs-command "Rotator-Automatic"
  - tcs.field-rotation
  - tcs.tcs-command "Equatorial-Offset"
  - tcs.tcs-command "Horizontal-Offset"
  - tcs.focus-position
  - tcs.focus-delta
  - tcs.auto-positioning-off
  - tcs.tcs-command "Auto-Positioning-Semi"
  - tcs.auto-positioning-full
  - tcs.guide-probe-position
  - tcs.tv-focus
  - tcs.tv-filter
  - tcs.tcs-command "Star-Box-Quadrant-Size"
  - tcs.star-box-position
  - tcs.tcs-command "Background-Box-Quadrant-Size"
  - tcs.background-box-position
  - tcs.instrument-parallactic-angle
  - tcs.tcs-command "Instrument-Name"
  - tcs.offset-size
  - tcs.probe-step-size
  - tcs.camera-probe-park
  - tcs.camera-probe-fies
  - tcs.camera-probe-stancam
  

• tcs.pointing [-e] (staff only)
  Records pointing accuracy from 72 stars, chosen from the GSC catalog in an alt/az equidistant manner.
  The script is fully automatic, and takes around 1 hour to complete.
  The pointing data recorded are used to compute a new pointing model (not included in the script).