TCS SEQUENCER Command Reference
TCS commands (tcs.command in scripts) (if used with option "-d" extended debugging information
is written to the log):
- focus-position [-d] n
Moves the telescope main focus position
to 'n'.
- focus-delta [-d] n
Applies a delta of 'n' to the focus
position.
- field-rotation [-d] field
Sets the field rotation to
"field"
- rotator-auto [-d]
Sets the rotator to automatic mode
- rotator-manual [-d]
Sets the rotator to manual mode
- check-rotator-time-to-limit
Returns the number of minutes
remaining until the rotator reaches its limit.
- ag-on [-d]
Turns on autoguiding
- ag-relaxed-on [-d]
Turns on relaxed autoguiding
- ag-off [-d]
Turns off autoguiding
- tv-on [-d]
Turns the guide TV on. Use with care as strong
light can destroy the TV camera!
- tv-off [-d]
Turns the guide TV off
- guidestar-automatic [-d]
At preset or field change a new
guide star is requested and the guide probe is set accordingly.
- guidestar-manual [-d]
No new guidestar is requested at
preset or field change. The guide probe is not moved.
- guide-probe-position [-d] n m
Moves the autoguider to x=n
and y=m
- star-box-position [-d] n m
Moves the autoguider star box
to x=n and y=m
- star-box-quadrant-size [-d] pixels
Sets the size of the star
box on the guide screen. Range: 4 to 250 pixels.
- background-box-quadrant-size [-d] pixels
Sets the size of
the background box on the guide screen. Range: 2 to 64 pixels.
- background-box-position [-d] n m
Moves the autoguider
background box to x=n and y=m
- box-at-center [-d]
Puts the autoguider star box at the
rotation center
- get-guide-star [-d] [number [field id]]
Gets a guidestar
from the guidestar server. See TCS command reference for
explanation of number and field id.
- tv-filter [-d] name
Selects the guide TV filter "name".
One of "Closed", "Grey", Open", "Red", Yellow" or "Blue"
- tv-focus [-d] pos
Changes the guide TV focus to position
"pos"
- probe-step-size [-d] n m
Sets the guideprobe step size in
x to "n" and in y to "m"
- camera-probe-park [-d]
Moves the camera probe to the
"park" position
- camera-probe-split [-d]
Moves the camera probe to the
"split" (FIES) position
- camera-probe-fies [-d]
Moves the camera probe to the
"split" (FIES) position
- camera-probe-ccd [-d]
Moves the camera probe to the
"ccd" (StanCam) position
- camera-probe-stancam [-d]
Moves the camera probe to the
"ccd" (StanCam) position
- ccd-filter [-d] n
Selects the CCD (StanCam) filter "n".
See TCS for a description of available filters
- open-mirror-covers [-f]
Opens the mirror covers of
the telescope. Unless called with the "-f" option, the user
will be asked to confirm this action. USE WITH CARE.
- close-mirror-covers
Closes the mirror covers of
the telescope.
- baffle-lamp-1-on [-d]
Turns baffle lamp number 1 on.
This is the halogen lamp at the moment.
- baffle-lamp-1-off [-d]
Turns baffle lamp number 1 off.
- baffle-lamp-2-on [-d]
Turns baffle lamp number 2 on.
This is the argon lamp at the moment.
- baffle-lamp-2-off [-d]
Turns baffle lamp number 2 off.
- baffle-lamp-3-on [-d]
Turns baffle lamp number 3 on.
This is the xenon lamp at the moment.
- baffle-lamp-3-off [-d]
Turns baffle lamp number 3 off.
- offset-size [-d] RA DEC
Sets the offset size used when
moving the telescope, using the TCS console arrow keys
- equatorial-offset [-d] RA DEC
Sets the offset that is added
to the object coordinates. Range from -1200 to +1200 arcsec.
- horizontal-offset [-d] Azimith Altitude
Sets the offset that
is added to the object coordinates.
Range from -1200 to +1200 arcsec.
- instrument-parallactic-angle [-d] nn
Sets the rotator angle
which is maintained when presetting to an object with the command
'Preset-With-Parallactic-Angle-To-Selected'
- preset-with-parallactic-angle-to-selected [-d]
Presets with parallactic angle to the selected object.
- goto-object [-d] objname
Preset the telescope to the
object named "objname". See TCS manual for details.
- instrument-name [-d] name [preferred field ID]
Sets the instrument name to "name". This will select a specific
guide star selection area.
- enter-object [-d] objname hh mm ss.s dd mm ss.s epoch
pm-ra pm-dec mag
Insert the
object named "objname" into the current TCS catalogue. All the
arguments needs to be given.
- append-object [-d] objname hh mm ss.s dd mm ss.s epoch
pm-ra pm-dec mag
Append the
object named "objname" to the end of the current TCS catalogue. All the
arguments needs to be given.
- read-catalogue [-d] catalogue name
Reads the catalogue "catalogue name" into the TCS. The catalogue
must have been created with the web tool or stored with the
command 'store-catalogue catalogue-name'.
- store-catalogue [-d] catalogue name
Stores the TCS catalogue on the disk.
- find-object [-d] objname
Finds the object "objname" in the currently loaded catalogue if
it exists and sets it to be the selected object.
- delete-selected-object [-d]
Deletes the currently selected object from the catalogue.
- auto-positioning-off [-d]
Turns the guide star auto positioning off.
- auto-positioning-full [-d]
Turns the guide star auto positioning to full-automatic.
- auto-positioning-semi [-d]
Turns the guide star auto positioning to semi-automatic.
- auto-positioning-retry [-d]
Tries to auto position the guide star again.
- adc-arm-in [-d]
Moves the ADC arm into the optical path.
- adc-arm-out [-d]
Moves the ADC arm out of the optical path.
- adc-explicit [-d] zenith_distance rotator_position
Sets the ADC prisms for the explicit zenith distance and rotator position.
- adc-actual [-d]
Sets the ADC prisms for the actual rotator position and zenith distance.
- adc-mode-automatic-off [-d]
The prisms are not moved automatically (i.e. only "manually" by explicit commands).
- adc-mode-automatic-when-presetting [-d]
The prisms are only moved at the start of a preset.
- adc-mode-automatic-continous [-d]
The prisms are contantly moved according to the actual zenith distance and
rotator position. This command should not be used by regular users because the continous
ADC mode is not commissioned.
- adc-initialize-prism-1 [-d]
Initializes ADC prism 1. Under normal conditions the TCS keeps the prisms initialized.
- adc-initialize-prism-2 [-d]
Initializes ADC prism 2. Under normal conditions the TCS keeps the prisms initialized.
- wait-adc [-d]
Waits for the ADC to be positioned before returning the prompt. Usefull together with
telescope preset commands to only continue when the ADC is also ready. Continous ADC mode
is not commissioned and not offered.
- tel-idle [-d]
Sets the telescope to 'idle'.
- tcs-command [-d] "tcs-command"
Sends the command "tcs-command"
to the TCS. Example: to send the command "guide-probe-park" to the
TCS, do
tcs-command "guide-probe-park" or
tcs-command "g-p-park"
It is IMPORTANT to note that this command does not wait until this or
that movement in the telescope has been done. It sends the command and
returns the prompt.
See TCS manual for details.
|