This document describes the TCS program, which controls the 1.5m telescope from the flwo60 Linux PC. The system provides controls via a Graphical User Interface (GUI) labeled ntcs, see below. The system also runs a command xterm window labeled Telshell, which allows the observer to enter telescope and instrument commands and to run observing scripts.
The only way users should start TCS is by starting the Realtime system. TCS is an integral part of the Realtime system; it is started when you type either gofast or gotres. If you attempt to start TCS independently, bad things will happen!
The TCS window will display a series of buttons and a list of information. The information area will update every few seconds, and will accept no input. This display will not contain the profiles and rotator widget (see below) if you are running TRES. Some of the listed information varies according to instrument, for example TRES shows other options related to calibrations and fibers. To select any button place the cursor on the button and depress the left mouse button. The Buttons, starting at top left, have the following functions:
These functions are supported only by the FAST version of TCS:
Some of these buttons when selected will cause a window with further choices
to appear. This section will explore these windows, and their usage. In
most cases these windows were designed to pop-up, be used, and disappear.
For these windows, other windows will not work until the current pop-up
has been dismissed.
When you click on NEW COORDS this window appears for selection of the next telescope position desired, either manually or via catalog management commands. The single white line can be used to display the last coordinates entered from this menu by using the up-arrow key.
If you wish to manually type in coordinates, simply put the cursor anywhere inside the white line, and type coordinates, for example :
12:12:12 32:00:01 1950.0 or 12 12 12 32 00 01 1950.0Spaces or colons are used to separate the fields RA, DEC, and EPOCH. A control-K entered on this line will delete from the cursor to the end of the line, and the delete key will delete the character prior to the cursor. The epoch field is optional, but Ra and Dec MUST BOTH be entered!
This window also allows the management of catalogs. When typing into the white line, three catalog commands are recognized:
Please note that a catalog MUST be loaded before you can retrieve objects. After manually entering coordinates, or selecting an entry from a catalog, click on the "OK" button to transmit coordinates to PC-TCS . In a few seconds, the "Slew Enabled" message will appear on the PC. at this point you can click on the "Slew Enabled" button, and the telescope will slew to the coordinates. See the catalog section below for specification of catalog layout, location, names, etc...
Under this area is a window which displays the loaded catalog, and you
may select an object from this window by right clicking on that line.
!P.I.: Furesz !Program: 140 Pulsators AUPeg 21:24:00.2 +18:16:43. 2000.0 0.00 -1.3 V411Lac 22:28:58.3 +50:57:47. 2000.0 -0.02 -0.3
Object names must have fewer than 20 characters (fewer is better) and cannot contain blanks, as the program uses blanks as delimiters. Valid object names comprise letters, numbers and characters from the set "+-_." ONLY. Object names must not contain blanks, as the parser uses blanks as delimiters.
Observers are able to write in the catalog directory; please avoid clobbering existing catalogs! All catalogs must be in /Realtime/lib/catalogs. If you change a catalog, please make sure that it is group writable when you are done, i.e. "chmod g+w mymunged.mct".
The catalogs are tested using the standalone program testcats. If a catalog
fails to load, use testcats to test and then correct the catalog. For example:
A common error is using a file created on a Windows machine, which will contain DOS-style new-line carriage-return combos at the end of lines. In this case testcats will complain about a special character 13. A program to easily fix this error is convert_dos, which may be run like this:
When you click on the Rates Menu button, this window appears :
Clicking Cosdec, Track, and Dome widgets will toggle that value. Track and Dome need to be on for Dome to follow telescope. Cosdec should stay on.
Stow Dome will turn off Dome, and send the dome to its stow position.
Selecting Dome to Az will
produce this window where you can enter a dome azimuth.
The dome will move to that azimuth when you click OK.
The TV image is grabbed via a frame grabber in the guide PC. The pixel size is about 0.33 arcsec along both the EW and NS directions. The format of 640x480 pixels gives a full field of about 211x158 arcsec (EW x NS).
Begin Guide and Stop Guide
allow you to start and stop guiding. Clicking start guide
will produce a frame from the guide computer in a window on flwo60. Left
click on a star in this window to start guiding on this star. If the
frame seems empty or if you change your mind,
hit Stop Guide, and then Begin Guide until you see the star.
GUIDER STATE LABEL
Following the Focus Move widget is a label that displays GUIDER - OFF or
GUIDE - ON depending on the guiding state.