Worklists
- Kyle Kaplan
Worklists
Copied from http://snoopy.as.utexas.edu:8080/OS/manuals/2.7m-telescope/tcs/appendix/worklists
Worklist files are text files which can contain any reasonable number (1000) of commonly used object positions. The TcsGui software will only display the first 100 objects in a file. Please note that loading a worklist larger than 1000 objects will cause TCSMON to only list the first 1000 entries. The list will truncate at that point. TCS will notify the observer of this and will suggest breaking the list into smaller ones.
Creating a work list file
The worklist file name should end with a ".wrk" suffix.
The format is as follows:
Reference-number Object-name RA Dec Epoch RA-proper-motion Dec-proper-motion
Fields must be space-delimited. The fields are defined as follows:
Reference number - Must be present and can be any numeric, but is not used by the TCS software.
Object-name- MUST BY PRECEDED AND FOLLOWED BY DOUBLE QUOTES. An example is "KAP1 CET". This is the biggest difference from the VMS point worklist format.
RA- hh mm ss.ss -or- hh mm.mm -or- hh.hh
(The last field MUST contain a '.', unless it is seconds. The last field may have as many numbers after the decimal as needed.)
Dec- dd mm ss.ss -or- dd mm.mm -or- dd.dd
(The last field MUST contain a '.', unless it is seconds. The last field may have as many numbers after the decimal as needed.)
Epoch- yyyy.yy (Year and decimal fraction)
RA-proper-motion- annual proper motion in time seconds XXXX
Dec-proper-motion - annual proper motion in arc seconds XXXX
Example: (Thanks to Bill Cochran for the excerpt from his worklist. )
1 "HR 72 " 00 18 41.8 -08 03 10 2000.0 0.028 -0.139
2 "Gl 15 A " 00 18 22.9 44 01 23 2000.0 0.268 0.41
3 "HR 173 " 00 40 32.9 -23 48 16 2000.0 0.047 -0.333
... ... ... ... ... ... ... ...
145 "ALPHA SCO " 16 26 20.2 -26 19 22 1950.0 0.001-0.02
146 "ALPHA HER " 17 12 21.9 14 26 45 1950.0 0.001 0.03
147 "DELTA SGE " 19 47 23.2 18 32 03 2000.0 0.001 0.01Loading a worklist into TCS
To load a worklist you must have the worklist file located on Oberon's home disk (preferably in your default login directory). Most observers are creating a subdirectory in their home directory called worklists and putting all of their worklists in that location. All worklists should have the ".wrk" suffix in their name.
On the TCSGUI, select "File -> Open / Transfer Work list" which will popup a new window that will allow you to select your worklist file. Select the worklist file. After selecting your file and clicking on OK, the entire file is loaded into TCS.
Look under "Next -> Work List" and you should see your file listed if it loaded properly.
Note: If there are a bunch of worklists listed under"Next->Work List" you can clear them out by selecting "File-> Clear Lists ". This does not remove the files from disk, just unloads them from TCS memory.
Selecting an object in a worklist
To select an object from a loaded worklist, choose Next-> Work List -> your_work_list. This will bring up a window in which you can select your object from the entire list. Double clicking on the object or selecting the object and clicking on OK or Apply will load the object into the Next buffer. After loading it into the Next buffer, you can move to it as you would any other object.