Worklists
About
Worklists are an easy way for observers to move between their objects throughout the night without having to hand-type coordinates into TCS. We recommend using worklists for efficient observing!
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 worklist file
The worklist file name should end with a ".wrk" suffix. Columns must be space-delimited.
The fields are defined as follows (from left to right):
Reference number - Must be present and can be any numeric, but is not used by the TCS software.
Object-name- must be proceeded and followed by double quotes. An example is "KAP1 CET".
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.
There is currently a bug in TCS that renders errors for RA coordinates above 23 hours when the worklist has coordinates in hh.hh format. The only known fix for this is putting coordinates in the hh mm ss.ss or hh mm.mm format instead.
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 (e.g. mas / 15 / 1000 to get to time seconds)
Dec-proper-motion - annual proper motion in arc seconds XXXX (e.g. mas / 1000 to get to arc seconds)
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 ATLAS in your user’s home directory (the IGRINS observer account in this case). There is a subdirectory called worklists on the IGRINS observer account, you can put the file there or in your own unique subdirectory.
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.
When you first upload your worklist to TCS, ensure there are no errors that pop up. If there are issues with the worklist, TCS will tell you what lines they occur on (e.g. the reference number of the object). Until you fix the errors for those particular objects, you will not be able to see the objects or click on them in the on sky projection of the worklist from TCS.
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 using the TCSGui.