/dd/USER/NewNOT/Txt/UserInterface/commands.txt Latest update: IS 2019-05-23 Close-Side-Ports, Open-Side-Ports-Fully, Open-Side-Ports-Smoke, Stop-Side-Ports added. IS 2019-09-20 Optimal-Box-Position-For-Moving-Objects updated with the correct limits, 2E7 "/h IS 2020-03-17 Updated Load-Pointing-Model with an optional file name. Description of the commands in new TCS ---------------------------------------- The help texts below are the ones that are given with the HELP key after typing a command on the command line. Type the command and press the Help function to get the limits where not stated here. NOTE that all commands can be abbreviated in all parts as long as they are unique. Also note that new commands might affect abbreviations so that some more characters have to be given. 0 Used in auto positioning. Do not use any of the up to 3 suggested guide star candidates on the autoguider screen 1 Used in auto positioning. Select star number 1 and move it to the star box and start autoguiding. 2 Used in auto positioning. Select star number 2 and move it to the star box and start autoguiding. 3 Used in auto positioning. Select star number 3 and move it to the star box and start autoguiding. Abort-Preset Stops telescope (azimuth, altitude and rotator) where it is. Note that if the telescope is moving it might take time to decelerate down to zero speed and then go back a bit to the position where this command was given. Use the red STOP button in an emergency situation. This command is the same as 'Idle-Mode'. Accept-Actual-Structure-Temperature Useful if there was a big step in the structure temperature values returned from the XTMS server and this change was a trusted one. May only be given from the user interface in the control room, preferably from staff, if possible. Access-Code an integer The local access code for a remote user interface must correspond to the reference that is updated at noon every day, otherwise only display functions will be allowed. This command is obsolete for the main user interface that runs on a terminal in the control room where all commands are always available. Active-Optics-Off Removes all active optics corrections to the mirror. This degrades the optical quality. Active-Optics-On Enables active optics corrections to the mirror. ADC-Actual Sets the 2 ADC prisms for actual rotator position and zenith distance. They both move in the same direction to counter move the rotator, the zenith distance is compensated for by the 2 prisms moving in opposite directions to even out the atmospheric dispersion. ADC-Arm-In confirm: 'Yes' or 'No' Moves the ADC arm into the optical beam. ADC-Arm-Out Moves the ADC arm out of the optical beam. ADC-Explicit Zenith distance: 0 to 90 degrees Rotator position: -201.8 to +200.5 degrees Sets the 2 ADC prisms for this explicit zd and rot pos. Can be used in testing and whenever a fixed position is wanted that is not set by 'ADC-Actual'. ADC-Initialize-Prism-1 Needs to be done if power has been off to the adc prisms controller or the adc control program has lost contact with the adc. Also needed when the adc control program starts after a reboot. Look at status page 26 in the UI for details, takes a while. ADC-Initialize-Prism-2 Needs to be done if power has been off to the adc prisms controller or the adc control program has lost contact with the adc. Also needed when the adc control program starts after a reboot. Look at status page 26 in the UI for details, takes a while. ADC-Mode-Automatic-Continous The prisms are constantly adjusted after the actual zenith distance and rotator position of the telescope. See UI status page 26 for details during operation. ADC-Mode-Automatic-Off The prisms are only moved at specific request by 'ADC-Actual' or 'ADC-Explicit'. ADC-Mode-Automatic-When-Presetting The prisms are only moved at the start of a preset, they are set for the initial zenith distance and rotator position of the telescope that applies for the target when the preset is started. Ag-Off Switches off autoguiding. Ag-On [] additional confirm: 'Yes' or 'No' Switches on autoguiding. An extra confirmation will be needed if TV is off, that would only be meaningful for technical testing. Ag-Relaxed-On Note that the guide star must be at least partially in the star box for this to function properly. It is enough if the star touches a corner of the star box. Switches on relaxed autoguiding where the star box first is centered on the guide star, then normal telescope guiding is made. Useful to avoid moving the telescope at start of guiding in connection with spectrograph slits etc. Altitude-Position 6.02 to 90.52 degrees Append-Object name: max 20 characters, no spaces (overflow ignored) RA: hh:mm:ss.ss or hh mm ss.ss (decimals optional) DEC: [sign]dd:mm:ss.s or [sign]dd mm ss.s in range -56 to +90 degrees (decimals optional) Epoch: 1900 to 2100 years RA pm: -1000 to +1000 arcsec/year DEC pm: -1000 to +1000 arcsec/year Magnitude: 30 (faint) to -10 (bright) This object is appended to the end of the catalogue (the Enter-Object inserts it). Please remember to save the catalogue with 'Store-Catalogue' when important additions have been made to it. Auto-Positioning-Off Passive, do the placing of the guide star in the box manually. See more comments after the 'auto-pos-retry' command. Auto-Positioning-Semi After a preset, the star box is NOT moved. Up to 3 stars are searched for and marked on the autoguider screen, choose one of them with 1, 2 or 3, or 0 to skip it. See more comments after the 'auto-pos-retry' command. Auto-Positioning-Full The star box is moved to the center of the autoguider screen. After a preset, the star box is NOT moved, instead the brightest guide star is moved (by moving telescope) to the center of the star box wherever the star box is placed and autoguiding started. This can be used as a (temporary) permanent offset. See more comments after the 'auto-pos-retry' command. Auto-Positioning-Retry The autoguider program will try again to search for guide stars according to the choosen mode. Can be useful in bad seeing if TV filter Grey was choosen, no star was found and another brighter filter was set by the observer. The auto positioning is intended to save time when presetting to an object and also to give better centered objects. If in use, after the preset has finished and TV filter has been automatically set to Open or Grey, the autoguider program does NOT move the star box and will try to identify between 1 and 3 candidates as guide stars. In the full mode only one (the brightest) is looked for and if found the telescope is given a horizontal offset in order to move the guide star to the center of the star box, wherever the star box is placed, then autoguiding is switched on. There will be a notification message on the error device when done. In the semi mode up to 3 stars will be looked for, they will be marked on the autoguider screen. The observer can then choose one of them by giving 1, 2 or 3 on the user interface terminal as a command, the corresponding guide star will then be moved (with a telescope horizontal offset) to the center of the star box and autoguiding will be started. If instead a 0 is given the auto positioning is skipped. If You are too fast to choose 1 before the other 2 have been found then an error message is given saying that no one is available, then just give the 1 again after the 3'rd has been marked on the autoguider screen. The choosen mode is displayed on the user interface terminal at the upper part under the CCD filter info. Auto-Positioning-Relaxed-Retry The star box is moved to the strongest star on the autoguider screen and relaxed autoguiding is switched on. If the background box is in the way it will be moved a bit. If the star is close to the edge and the star box does not fit on the screen then the operation is cancelled. Automatic-Repositioning-At-Differential-Tracking-Off If using differential tracking of moving objects there will be no automatic repositioning when the star box gets close to a limit. The command Box-Motion-Reposition can be used if a reposition is needed. Automatic-Repositioning-At-Differential-Tracking-On This is for use with differential tracking of moving objects and box moving. If telescope is autoguiding and box motion is ON, then if the star box gets close to a limit there will be an automatic repositioning. It will do Ag-Off Box-Motion-Stop Optimal-Box-Position-For-Moving-Objects with the rates used Box-Motion-Start with the rates used Move the guide probe so the guide star gets in the star box Ag-On Details of the box movement is found on status page 24 on TCS UI. Note that the guide probe might get to a limit if the object travel is long. Automatic-TV-Focus Switches on the automatic TV focus setting at presets, foc-pos and foc-del. Type 'auto-tv' and press the HELP key (or '?') to get the algoritm and the settings. Azimuth-Position 0.00 to 360.00 Note that adjusting azimuth turns does NOT apply here. Background-Box-Position 6 to 505 (depending on size) Please always place it completely outside the star box and especially away from the vignetted area. Background-Box-Quadrant-Size 2 to 64 The resulting pixel size of the background box will be 2n+1. Please always place it completely outside the star box. Baffle-Lamp-1-On Baffle-Lamp-1-Off Baffle-Lamp-2-On Baffle-Lamp-2-Off Baffle-Lamp-3-On Baffle-Lamp-3-Off Switches on/off the baffle calibration lamps. May only be done if guide TV is off. Box-At-Center Puts the autoguider star box at the rotation center. Box-Motion-Reposition This is for use with differential tracking of moving objects and box moving. Telescope must be autoguiding and box motion ON. It will do Ag-Off Box-Motion-Stop Optimal-Box-Position-For-Moving-Objects with the rates used Box-Motion-Start with the rates used Move the guide probe so the guide star gets in the star box Ag-On Details of the box movement is found on status page 24 on TCS UI. Box-Motion-Start -20000000.0 to +20000000.0 "/hour, in SKY COORDINATES The autoguider star box will move with this rate to track a moving object. Give the rate of the object movement, the TCS will then do the necessary conversions of directions. The SetRate is also automatically set so that the autoguider just has to correct for the pointing errors and not also drag the object along by the help of the guide star. NOTE that the box will be prevented from moving if it reaches an edge. Note that the set rate is cleared by a preset to a new object. Box-Motion-Stop The telescope set rates are left as they are. Building-Hoist-Position Positions building at the hoist position. Note that azimuth turns might be adjusted during this, in order to unwind the fibre optic communication cables. PLEASE MAKE SURE THAT TELESCOPE POWER IS SWITCHED OFF BEFORE ANY LIFTING OPERATIONS. Building-Park-Position Parks building randomly around az=119 degrees. Note that azimuth turns might be adjusted during this, in order to unwind the fibre optic communication cables. Calibrate-TV-Focus-Zero-Point confirm: 'Yes' or 'No' If switched on (default), the automatic TV focus is set at a preset, foc-pos and foc-del to TVfoc = A0 + A1 * (TelescopeFocus+TelescopeFocusDelta). The observer in the control room may adjust A0 as A0 = TVfoc - A1 * (TelescopeFocus + TelescopeFocusDelta). This will stay in effect until noon next day or next reboot of TCS. A log entry will be written with relevant data info for later collection and analysis. At noon the default value is put back. Do 'aut-tv-foc' together with HELP to see the actual settings. Camera-Probe-CCD confirm: 'Yes' or 'No' Moves the camera probe to the position in front of the standby camera. Camera-Probe-FIES confirm: 'Yes' or 'No' Moves the camera probe to the position in front of the standby spectrograph. Camera-Probe-Park Parks the camera probe out of any light path. Camera-Probe-Split confirm: 'Yes' or 'No' Moves the camera probe to the position in front of the standby spectrograph. Catalogue-Menu Intended mostly for a remote user interface run on a PC where VT-100 type function keys to the right are not available. On the control room user interface terminal this is done with the PF3 key. CCD-Filter 0 to 9 Later it might be possible to also give the name. Change-Access-Code [] New access code: Optional, 1 to 2147483647 confirm: 'Yes' or 'No' If a new code is not provided as an integer then an automatic one is generated. May only be used in the control room user interface. This command also generates a warning. Close-Lower-Hatch May only be done if the upper hatch is opened. Note that power to hatches and mirror covers is always available, the telescope power does not have to be switched on for this. A closing takes about 86 seconds. For staff: if the handset is used it is enough that the upper hatch has been opened about 0.5 m Close-Mirror-Covers May only be done if the upper hatch is fully opened or closed. Note that power to hatches and mirror covers is always available, the telescope power does not have to be switched on for this. A closing takes about 34 seconds. Close-Side-Ports [] [] [.....] Optional parameter(s): All (all 8 sections) DEFAULT South (the 2 sections at hoist) West (the 2 sections at right from door) North (the 2 sections behind door) East (the 2 sections at left from door) LS or 4 (left section at hoist) RS or 5 (right section at hoist) LW or 6 (left section at right from door) RW or 7 (right section at right from door) LN or 8 (left section behind door) RN or 1 (right section behind door) LE or 2 (left section at left from door) RE or 3 (right section at left from door) Parameters may be given in any order. See 'show-page 31' for progress and status. Close-Upper-Hatch Mirror covers must be closed for this and the lower hatch must also be closed. Note that hatches and mirror covers always have power no matter if telescope power is on or off. A closing takes about 190 seconds. Copy-EngZ-To-AlternateZ Copies the engineering zernike to the alternate zernike. Copy-WFSz-To-AlternateZ Copies the WFS zernike to the alternate zernike. Counter-Weights-Height 0.0 to 1.0 Used for balancing the telescope: Put altitude to 55 degrees. Open mirror covers. Set rotator to 0 degrees. Swith on tracking with 'tr'. Adjust until the currents of the 2 altitude motors are fairly equal as seen on status page 3 on the difference value or on the physical meters. Due to the preload one is positive and the other negative. Please be patient, a long move can take 10 minutes. DEC-Delta -1200 to +1200 arcsec This command is usually executed by function keys but is available here also. Delete-Selected-Object Deletes the currently selected object from the object catalogue. Disable-TV-Focus-Optimization The best TV focus will not be searched for after a preset and autopositioning. Note that it can save time to disable optimization if a lot of 'auto-pos-retry' are performed. Dust-Level-High Reduces the operative weather condition limits for closing. This command should only be issued by staff. Dust-Level-Low Sets the operative weather condition limits for closing back to normal. THIS COMMAND SHOULD ONLY BE GIVEN BY STAFF! Also note that all commands are logged with time stamps. Enable-TV-Focus-Optimization After a preset and the autopositioning, the best TV focus will be searched for. Note that if auto positioning is off then there cannot be any TV focus optimization since a star in the guide box is needed. The search takes about 10 seconds. Sets back to the starting position if no better result was found. Enter-Object name: max 20 characters, no spaces (overflow ignored) RA: hh:mm:ss.ss or hh mm ss.ss (decimals optional) DEC: [sign]dd:mm:ss.s or [sign]dd mm ss.s in range -56 to +90 degrees (decimals optional) Epoch: 1900 to 2100 years RA pm: -1000 to +1000 arcsec/year DEC pm: -1000 to +1000 arcsec/year Magnitude: 30 (faint) to -10 (bright) This object is entered into the catalogue by inserting it after the currently selected one (see also Append-Object). Please remember to save the catalogue with 'Store-Catalogue' when important additions have been made to it. Equatorial-Offset RA: -1200 to +1200 arcsec DEC: -1200 to +1200 arcsec This offset is added to the object coordinates. Usually issued by instrument computers. It is faster to use the function keys here. Cleared when a new preset is done. Erase-Catalogue confirm: 'Yes' or 'No' The object catalogue in memory is erased. Erase-High-Resolution-Log Erase the specified log, number 1 to 10, either if it was a mistake or space for other logs is needed. Related commands are Show-High-Resolution-Logs Save-High-Resolution-Log-In-Memory Write-High-Resolution-Log Field-Delta-Rotation -360.0 to +360.0 degrees This value is added to the reference field rotation. Field-Rotation -360.0 to +360.0 degrees The rotator (if in automatic mode) is positioned so that this becomes the angle between the sky and the instrument. Find-Object name: max 20 characters, no spaces (overflow ignored) Find and select this object in the catalogue. Note that the search starts from the end to make sure the last object entered with 'Append-Object' is selected (in case it has the same name as another object). If not found then search the standard star catalogues, and if found there be nice and insert it in the main catalogue. Focus-Delta -5000 to +5000 units This offset is added to the main focus. Please note that 'Focus-Position' resets the delta to 0. Focus-Position 15614 to 36586 units Please note that this resets the delta to 0. Get-Guide-Star [ []] number: 1 to 10, optional but must be given if field ID is used field ID: optional, one of ALFOSC-Default, ALFOSC-Maximum, ALFOSC-LR, ALFOSC-LL, FIES-Default, FIES-Maximum, MOSCA-Default, MOSCA-Maximum, NOTCAM-Default, NOTCAM-Maximum, NOTCAM-Reduced, NOTCAM-Beamswitch-NS, NOTCAM-Beamswitch-EW, NOTCAM-S-posX, NOTCAM-N-negX, NOTCAM-E-negY, NOTCAM-W-posY, STANCAM-Default, STANCAM-Maximum Gets a guide star for the object currently pointed to. The guide probe is positioned accordingly. This one is also available as a function key function on the control room terminal, Catalogue menu, right 8. If number is specified, the guide star is choosen from a list of up to 10 candidates the guide star server provides. If field ID is given the guide star server will return a guide star that is found within the field choosen. For some instruments this can be required. The field is related to the instrument in use, so if no field ID is given the default field for the instrument in use is choosen. When using the function key the default is star number 1 from field ALFOSC-Default (the standard field). Goto-Object name: max 20 characters, no spaces (overflow ignored) First we do a 'Find-Object' where the object in the catalogue is searched for and selected if found, otherwise the standard catalogues are searched and if found the object is inserted into the main catalogue. If the object is found a 'Preset-To-Selected' is made. Case sensitive. Note that the search starts at the end of the catalogue so if two objects have exactly the same name the last one is selected. This fits better with the use of 'Append-Object'. Guide-Probe-Center confirm: 'Yes' or 'No' Moves the guide probe to the center position. Note that this blocks light to the cassegrain instrument. Also note that the TV camera does not like objects brighter than about mag 8(?). Guide-Probe-Park Parks the guide probe out of any light path. Guide-Probe-Position X: 1100 to 225000 units Y: 1100 to 159000 units Guide-Star-Automatic At a preset or setting of field rotation the guide star server is asked for a guide star and the guide probe is positioned accordingly. Guide-Star-Manual The guide star server is not asked for a guide star at a preset or a change in field rotation. The guide probe is not moved. Useful if you want the guide probe to stay in the center at technical work. Horizontal-Differential-Tracking-Rate Azimuth: +20000000.0 to -20000000 arcsec/hour Altitude: +20000000.0 to -20000000 arcsec/hour This rate is added to the az and alt positions. Useful for technical tests and perhaps moving objects. NOTE that these rates are cleared by a preset to a new object or 'Idle'. Horizontal-Offset Az: -1200.0 to +1200.0 arcsec Alt: -1200.0 to +1200.0 arcsec This offset is added to the object coordinates. Cleared when a new preset is done. Idle-Mode Stops telescope (azimuth, altitude and rotator) where it is. Note that if the telescope is moving it might take time to decelerate down to zero speed and then go back a bit to the position where this command was given. Use the red STOP button in an emergency situation. This command is the same as 'Abort-Preset'. Inhibit-Remote-Commands confirm: 'Yes' or 'No' For staff use only. Can only be given from the User Interface terminal in control room, when issued only commands from this terminal will be accepted. For increasing personal safety when working at the telescope. Initialize-TV-Filter Tells the guide TV filter controller to immediately initialize by finding the referens point and then set to the choosen filter. Do this if filter positions seems incorrect. This command is only available in the User Interface. Insert-Actual-Position [name] name: max 20 characters, no spaces (overflow ignored) Enters the actual telescope coordinates as an object into the catalogue. The name is optional, if not provided directly it will be 'ActualPosition'. This one is also available as a function key function in the Catalogue menu, right 3. Note that in that case no explicit name can be given. Insert-Nearest-FK5 Insert a FK5 star that is closest to the currently selected object into the object catalogue. Insert it after the selected one. In the very rare case that no object has been selected we just use the actual telescope position, to be nice to the observer. This one is also available as a function key function on the control room terminal, Catalogue menu, right 9. Instrument-Name [] Name: ALFOSC, FIES, MOSCA, NOTCAM, STANCAM, Other Preferred fieldID: optional, if provided this will be default for all guide star requests in connection with presets, one of ALFOSC-Default, ALFOSC-Maximum, ALFOSC-LR, ALFOSC-LL, FIES-Default, FIES-Maximum, MOSCA-Default, MOSCA-Maximum, NOTCAM-Default, NOTCAM-Maximum, NOTCAM-Reduced, NOTCAM-Beamswitch-NS, NOTCAM-Beamswitch-EW, NOTCAM-S-posX, NOTCAM-N-negX, NOTCAM-E-negY, NOTCAM-W-posY, STANCAM-Default, STANCAM-Maximum The preferred field will be used for subsequent presets. If telescope is slewing or tracking but not autoguiding, a new guide star will be provided from the given field, or default field if not given. Note that the command Get-Guide-Star can always be used to get a guide star with another fieldID. The instrument name and fieldID are shown on the user interface screen at upper right. If one of the main instruments is specified and the counterweights setting is not suitable for that instrument a helpful warning is given. Instrument-Parallactic-Angle -198.0 to +202.0 degrees This rotator angle is maintained when presetting to an object with 'Preset-To-Selected-With-Parallactic-Angle' in order to keep the slit in a spectrograph aligned like N-S. Keep-Telescope-Opened minutes: 0 resets extended time 1 to 60 added to actual time, used instead of the sunrise time The automatic sunrise autoclose safety will close at sunrise in case the observer has fallen asleep or gone home with the telescope left opened. Warnings will start 5 minutes before sunrise. This command can be used to extend the allowed time to stay opened. It is only meaningful to use this command between 0 and 60 minutes before sunrise, at least the first instance of it. The allowed open time can be expanded if needed if full responsability is taken. When telescope once have been closed in the morning, this command is meaningless. Kill-Control-System confirm: 'Yes' or 'No' THIS COMMAND MAY ONLY BE GIVEN BY STAFF OR BY AN OBSERVER AFTER EXPLICIT PERMISSION FROM STAFF! List-Catalogue-Errors Read and show up to 8 lines from the catalogue error file where the result from the last Read-Catalogue call was logged. The 8 lines covers the first 2 failing objects (if any) and will in most cases be sufficient for correcting the catalogue. Otherwise the process can be repeated. Load-Pointing-Model [] THIS COMMAND SHOULD ONLY BE GIVEN BY STAFF! The default is model.d, when testing it can be convenient to specify which model to test so a file name can be provided. Local-Read-Catalogue name: max 32 characters, no spaces Read objects from the named catalogue that was earlier stored locally on the TCS disc with 'Local-Store-Catalogue'. If the internal one (in memory) is not empty then the new objects are added at the end of it and the first object from the new catalogue becomes the selected one. This might help against unintended loss of temporary defined objects. If something was not OK then use 'List-Catalogue-Errors' to see what. Please note that reading local catalogues takes 1.7s/1000 objects, reading remote ones takes 2.0s/1000 objects, storing local ones takes 3.9s/1000 objects and storing remote ones takes 4.3s/1000 objects. For a maximum size catalogue of 50k objects this means up to 100s for reading and 215s for storing so please only handle huge (>10k objects) catalogues during daytime or during exposures! During the time of reading/storing the user interface is busy and does not update the display nor respond to any commands. To read an external catalogue on the system that contains the web created ones use the command 'Read-Catalogue'. Local-Store-Catalogue name: max 32 characters, no spaces Store the current catalogue (from memory) locally on the TCS disc. Please note that the storing takes about 4s/1000 objects which means up to 215 s for a 50k object catalogue. During this time the user interface is busy! Use 'Local-Read-Catalogue' to read it back. Log-Menu Intended mostly for a remote user interface run on a PC where VT-100 type function keys to the right are not available. On the control room user interface terminal this is done with the [,] key on the numerical key pad to the right. Manual-TV-Focus Switches off the automatic TV focus setting at presets, foc-pos and foc-del. Move-Guide-Probe-To-Put-Star-In-Box The guide probe will be moved so that the guide star ends up in the star box, then immediately normal autoguiding will be switched on. Name-CCD-Filter position: 1 to 9 NOT number: 0 to 999 (0 means not specified yet) name: max 20 characters, no spaces (overflow ignored) Please limit to 17 characters so it can be properly displayed in UI upper part To get a list of the defined filters write 'CCD-Filter' and then press PF1, the help key, on the control room user interface terminal, or type a '?'. Please note that if the filter casette door on the filter mechanism has been open it is necessary to change a filter to avoid complains from TCS. New-Object RA: hh:mm:ss.ss DEC: [sign]dd:mm:ss.s in range -56 to +90 degrees Epoch: 1900 to 2100 years RA pm: -1000.0 to +1000.0 arcsec/year DEC pm: -1000.0 to +1000.0 arcsec/year This object is not entered into the catalogue, the telescope just goes and tracks on this one. No-Close Do not auto close the telescope for the next about 10 minutes. Available when using the WXT520 (newer) weather station only. This one can give false rain detections in strong winds. Normally the two weather stations are used combined for rain detection. The Security program has a special handling for this that allows the user to delay the the auto closing if the command is given within about 2 minutes after an assumed rain detection. This command is mentioned in the corresponding warning message after a rain detection. Normal-Azimuth To be used after checking a full turn of azimuth with the 'Slow-Azimuth' command. Offset-Mode This is the default move mode where telescope RA/DEC are adjusted with function keys for offset stepping, AltFunction+Arrows on the user interface terminal in the control room, CTRL-T/V/F/G on any terminal window on remote machines. Offset-Size RA: 0.05 to 1200.0 arcsec DEC: 0.05 to 1200.0 arcsec This offset size is added/subtracted to the reference RA/DEC when using the function keys AltFunction+Arrow to move the telescope around. Also used in the combined offset for moving both telescope and guide probe (to keep guide star in box) around. The proper move mode is choosen with numerical key pad '5' to the right on the control room terminal or ',' on any keyboard. Ok-Close Start autoclosing the telescope now. Available when using the WXT520 (newer) weather station only. This one can give false rain detections in strong winds. Normally the two weather stations are used combined for rain detection. The Security program has a special handling for this that allows the user to immediately start the auto closing within about 2 minutes after an assumed rain detection. This command is mentioned in the corresponding warning message after a rain detection. Open-Lower-Hatch confirm: 'Yes' or 'No' May only be done if the upper hatch is opened. Note that power to hatches and mirror covers is always available, the telescope power does not have to be switched on for this. An opening takes about 99 seconds. For staff: if the handset is used it is enough that the upper hatch has been opened about 0.5 m Open-Mirror-Covers confirm: 'Yes' or 'No' May only be done if the upper hatch is fully opened or closed. Note that power to hatches and mirror covers is always available, the telescope power does not have to be switched on for this. An opening takes about 43 seconds. Open-Side-Ports-Fully [] [] [.....] Optional parameter(s): All (all 8 sections) DEFAULT South (the 2 sections at hoist) West (the 2 sections at right from door) North (the 2 sections behind door) East (the 2 sections at left from door) LS or 4 (left section at hoist) RS or 5 (right section at hoist) LW or 6 (left section at right from door) RW or 7 (right section at right from door) LN or 8 (left section behind door) RN or 1 (right section behind door) LE or 2 (left section at left from door) RE or 3 (right section at left from door) Parameters may be given in any order. See 'show-page 31' for progress and status. Open-Side-Ports-Smoke [] [] [.....] (about 1 meter) This is for opening just a bit to ventilate LN2 gas or whatever needed. Optional parameter(s): All (all 8 sections) DEFAULT South (the 2 sections at hoist) West (the 2 sections at right from door) North (the 2 sections behind door) East (the 2 sections at left from door) LS or 4 (left section at hoist) RS or 5 (right section at hoist) LW or 6 (left section at right from door) RW or 7 (right section at right from door) LN or 8 (left section behind door) RN or 1 (right section behind door) LE or 2 (left section at left from door) RE or 3 (right section at left from door) Parameters may be given in any order. See 'show-page 31' for progress and status. Open-Upper-Hatch confirm: 'Yes' or 'No' May only be done if mirror covers are closed and humidity has been < 90% for at least 20 minutes. Note that power to hatches and mirror covers is always available, the telescope power does not have to be switched on for this. The opening time is about 176 seconds. Optimal-Box-Position-For-Moving-Objects -20000000.00000 to 20000000.00000 "/hour, in SKY COORDINATES The autoguider star box will be moved to the position where Box-Motion-Start with the same parameters will give the longest possible time to follow the object. The background box will be moved so it is out of the way for the moving star box. Details of the box movement is found on status page 24. Optimize-TV-Focus Will search for the best TV focus, takes about 10 seconds. If it cannot find the best one, it sets back to the starting position. Permanent-Offset-Adopt confirm: 'Yes' or 'No' The offset from the original calculated position where the object was expected to be to the actual position where the object actually is found will be used in all presets to objects until cancelled with 'Permanent-Offset-Reset'. The defined offset will be in effect also after a reboot of TCS. A notification message will be given if any permanent offset is applied at a preset. Permanent-Offset-Reset confirm: 'Yes' or 'No' The offset from the 'Permanent-Offset-Adopt' command is reset. Permit-Remote-Commands confirm: 'Yes' or 'No' For staff use only. Can only be given from the User Interface terminal in control room, when issued commands from sequencer and remote user interface will be accepted. For use after finishing working at the telescope. Power-Off confirm: 'Yes' or 'No' Switches off power to the telescope and building. Takes about 20 seconds. Please note that the hatches and mirror covers always have their own power. Power-On confirm: 'Yes' or 'No' Switches on power to the telescope and building. Takes about 1 minute. Please note that the hatches and mirror covers always have their own power. Preset-To-Selected Usually also gets a guide star unless 'Guide-Star-Manual' has been given. Rotator will be positioned so that the currently selected field rotation is maintained. This one is also available as a function key function in the Catalogue menu, right 4. Preset-With-Fixed-Rotator-To-Selected Usually also gets a guide star unless 'Guide-Star-Manual' has been given. Rotator will not move during the preset and will track from its actual position when telescope reaches the target position. The resulting field rotation will be random so this command can be used for focussing to speed up the preset. Preset-With-Parallactic-Angle-To-Selected Usually also gets a guide star unless 'Guide-Star-Manual' has been given. Rotator will be positioned to the position defined with 'Instrument-Parallactic-Angle' to keep the object aligned with a spectrograph slit or so. This one is also available as a function key function in the Catalogue menu, right 6. Probe-Step-Size X: 0.05 to 1200.0 arcsec! Y: 0.05 to 1200.0 arcsec! This step size is added/subtracted to the guide probe reference X/Y when using the function keys AltFunction+Arrow or the CTRL-T/F/G/V to move it around. PLEASE NOTE that in the old TCS the units were encoder units but we now use arcseconds instead. The proper move mode is choosen with numerical key pad '5' to the right on the control room terminal or ',' on any keyboard. RA-Delta -1200.0 to +1200.0 arcsec This command is usually executed by function keys but is available here also. Read-Catalogue name: max 100 characters, no spaces Read objects from the named catalogue. If the internal one (in memory) is not empty then the new objects are added at the end of it and the first object from the new catalogue becomes the selected one. This might help against unintended loss of temporary defined objects. If something was not OK then use 'List-Catalogue-Errors' to see what. Please note that reading local catalogues takes 1.7s/1000 objects, reading remote ones (with this command) takes 2.0s/1000 objects, storing local ones takes 3.9s/1000 objects and storing remote ones takes 4.3s/1000 objects. For a maximum size catalogue of 50k objects this means up to 100s for reading and 215s for storing so please only handle huge (>10k objects) catalogues during daytime or during exposures! During the time of reading/storing the user interface is busy and does not update the display nor respond to any commands. The prefix '/catalogue/' will automatically be added to avoid the need to always have to write it in. If by any reason a locally stored catalogue (with 'Local-Store-Catalogue') is wanted then use the command 'Local-Read-Catalogue' instead. If the user would write 'read-cat /catalogue/mycat.cat' this will be fine, then no prefixing will be made. Refresh-Screen Initializes the screen for the user interface. Useful if the screen contents was messed up or lost. Rotator-Automatic The rotator will follow the rotation of the sky, starting with the field rotation that corresponds to the actual rotator position. Rotator-Manual The rotator will stay where it is and move only on commands 'Rotator-Position' and 'Zenith'. Rotator-Position -201.8 to +200.5 degrees If the rotator is in manual mode it will go to this position and stay there, if it is in automatic mode it will go to the new position and track from there (if the telescope is tracking). Rotator-Turn-360 The rotator will turn one turn if possible. Useful to avoid getting too close to one of the end limits during an exposure. The end limits are at about -200 and +200 degrees. The ranges where this is possible are about -200 to -160 degrees and +160 to +200 degrees. Note that autoguiding must be switched off before giving this command. Save-High-Resolution-Log-In-Memory If a malfunction or misbehaviour of the telescope is suspected then this command saves the last 5 minutes of the most important parameters with a resolution of 50Hz in memory. There is space for up to 10 such logs unless the TCS runs on an older processor module with less memory. The used logs will be written to an external machine at 9UT in the morning or if explicitly requested. Related commands are Show-High-Resolution-Logs Write-High-Resolution-Log Erase-High-Resolution-Log Select-Next-Object Select the next object in the internal object catalogue. If we already are at the end just keep it at the last one. This one is also available as a function key on the control room terminal, in Catalogue Menu, right 1. Select-Previous-Object Select the previous object in the internal object catalogue. If we already are at the beginning just keep it at the first one. This one is also available as a function key on the control room terminal, in Catalogue Menu, right 7. Set-Rate RA: -20000000.0 to +20000000.0 arcsec/hour DEC: -20000000.0 to +20000000.0 arcsec/hour Both in SKY COORDINATES This rate is added to the object coordinates. Useful when tracking moving objects. Note that when using autoguiding with a moving star box it is recommended to use both a set rate for the object and the moving rate for the star box so that the autoguider only has to correct for the pointing errors and not also drag the object along by the help of the guide star. Use 'box-motion-start' for this. NOTE that the set rate is cleared by a preset to a new object. Set-Rotator-Standard If the resulting rotator position at a preset is about 40 degrees from the upper end stop and the rotation will be positive then a full turn of the destination position will be done to give longest possible following of the object. Correspondingly if the resulting rotator position is about 40 degrees from the lower end stop and the rotation will be negative then a full turn will also be done. This feature stays in effect until changed to 'Set-Rotator-Fast'. The state of the rotator mode is shown as 'Std', just after the time to rotator limit on the TCS UI screen. This is the default mode and is set at noon every day. Set-Rotator-Fast The rotator will go the shortest and fastest distance to the new position at a preset. This feature stays in effect until changed to 'Set-Rotator-Standard'. The state of the rotator mode is shown as 'Fast', just after the time to rotator limit on the TCS UI screen. Show-High-Resolution-Logs Lists a summary of the state of the high resolution logging in the middle part of the User Interface. Show-Page n: 0 to 28 or higher Status page updating is automatically choosen on the screen. The menu functions are not changed, use 'Status-Menu' to get them. Slow-Azimuth Sets down the azimuth maximum speed to about 0.4 deg/s. Can be useful in winter times when standing outside on the stair during an azimuth move and inspecting the free height of the stair beam holder over the ice and snow layer. If an obstacle is approaching then walk back into the control room and press the ABORT key on the TCS UI keyboard. Then remove the obstacle before continuing. When it is verified that the building can move freely all the way around then use 'Normal-Azimuth' to get back the default speed. Sort-Catalogue item: 'Name' 'RA' 'DEC' 'pmRA' 'pmDEC' 'Magnitude' Note that it is not expected that another user is also doing things with the catalogue. Please be patient when sorting huge catalogues (>> 20k objects) on the names. A worst case with 50k objects sorted on very equal names takes about 13 seconds. The rest takes negligable time, sorting 50k objects on RA, DEC, pmRA, pmDEC or Magnitude takes < 3 seconds. For info the sorting algorithm is Shellsort with both average and worst case sorting time const*(n^1.5) running on a 60 MHz Motorola 68060 processor at about 50% load. Star-Box-Position X: 16 to 495 units Y: 16 to 495 units Please make sure that the background box is completely outside the star box. Star-Box-Quadrant-Size 4 to 250 pixels, The resulting pixel size of the star box will be 2n+1. Good contrast is achieved when the total size is about 2 - 5 times the diameter of the guide star. Might depend on position. Status-Menu Intended mostly for a remote user interface run on a PC where VT-100 type function keys to the right are not available. On the control room user interface terminal this is done with the PF2 key. Stop-Counter-Weights Stop-Lower-Hatch This command is intended for use if there is a severe mechanical problem discovered during the open/close operation. Note that hatches and mirror covers always have power no matter if telescope power is on or off. Stop-Mirror-Covers This command is intended for use if there is a severe mechanical problem discovered during the open/close operation. Note that hatches and mirror covers always have power no matter if telescope power is on or off. Stop-Side-Ports [] [] [.....] Optional parameter(s): All (all 8 sections) DEFAULT South (the 2 sections at hoist) West (the 2 sections at right from door) North (the 2 sections behind door) East (the 2 sections at left from door) LS or 4 (left section at hoist) RS or 5 (right section at hoist) LW or 6 (left section at right from door) RW or 7 (right section at right from door) LN or 8 (left section behind door) RN or 1 (right section behind door) LE or 2 (left section at left from door) RE or 3 (right section at left from door) Parameters may be given in any order. See 'show-page 31' for progress and status. Stop-Upper-Hatch This command is intended for use if there is a severe mechanical problem discovered during the open/close operation. Note that hatches and mirror covers always have power no matter if telescope power is on or off. Store-Catalogue name: max 100 characters, no spaces Store the current catalogue, the prefix '/catalogue/' will automatically be added to avoid the need for always having to write it. It will physically be stored on an external machine with the web created catalogues. To store it on the local TCS disc use 'Local-Store-Catalogue'. Please note that the storing takes about 4s/1000 objects which means up to 215 s for a 50k object catalogue. During this time the user interface is busy! If the user writes 'store-cat /catalogue/mycat.cat' that will be fine, then no prefixing is made. Store-Pointing-Data Store actual telescope parameters for where it is pointing. For further analysis in pointing modelling. Tracking-On Starts tracking from the actual telescope position. No guide star is provided. Note that a guide star is easily provided on function 8 in the catalogue menu. TV-Filter 'Closed' 'Grey5M' 'Open' 'Red' 'Yellow' 'Blue' TV-Focus 273 to 732 TV-Off Switches off the guide TV. TV-On Switches on the guide TV. UI-Exit confirm: 'Yes' or 'No' Quits this user interface. Please NOTE that if done on the user terminal in control room there is no way back. Use-Alternate-Zernike Tells the ActiveOptics program to use the Alternate zernike instead of the WFS zernike. Used when testing out new zernikes. Use-WFS-Zernike Tells the ActiveOptics program to use the WFS zernike instead of the Alternate zernike. The default choice. Write-High-Resolution-Log [] Write the specified log to disc (via NFS to elena). If no number is given then all used logs will be written. If a number between 1 and 10 is given then that log will be written. The used logs will be written to an external machine at 9UT in the morning or if explicitly requested. Related commands are Show-High-Resolution-Logs Save-High-Resolution-Log-In-Memory Erase-High-Resolution-Log X 1100 to 225000 Y 1100 to 159000 Useful when searching for guide stars manually. Zenith Parks altitude close to 90 degrees, puts rotator to -90 degrees and manual, leaves any CCD filter. Zernike-Tables-Off Disables contributions from zernike tables in active optics. Zernike-Tables-On Enables contributions from zernike tables in active optics.