Using Guide Stars for Fast, Accurate Target Acquisition

John Thorstensen, Dartmouth College

2007 January

The Short Story:

(The reason is that these latter instruments do not use the offset guider on the MIS; Modspec and Mark III use the guider to look at the slit jaws, and the 8k doesn't use MIS at all.)

If you are using one of the applicable instruments, it is possible to center on targets quickly and accurately using offset guide stars. This can be a substantial time-saver even if you don't have a lot of targets. The procedure has been made straightforward and convenient, as described here.

The Ingredients:

How to Use the Simple GUI That Does This:

The description here is verbose for newbies, but it goes very quickly once you've done it a few times.

First, to set up:

(0)You can do everything from Hiltner's (or McGraw's) terminal, but you need to run the program on Agung (or Hill).

(1) Pop up a terminal window using the icon at the lower left of the KDE screen on Hiltner (or McGraw). In this terminal window, type

   ssh agung         (at the 1.3m,   ssh hill)
(If you run into trouble starting up skycalcdisp.py later on, log out of your ssh session and try it with "ssh -X agung", upper case X. This should not be necessary. The "-X" enables X-window tunneling through ssh, and it's supposed to be on by default.)

(2) If you have an object list that you have put on Agung somewhere, change directory to where the list resides:

   cd mydirectory
(You can omit that step if you don't have an object list, but trust me, you'll want one.)

(3) Launch the Python GUI skycalc with

   skycalcdisp.py
(If it gives you trouble about "couldn't connect to display", go back to step (1) and restart the ssh session with "-X"). If you've been using the Java version of this program, JSkyCalc, you'll recognize that skycalcdisp.py is a precursor to JSkyCalc. We use skycalcdisp.py here because only it has the MDM-specific feature we need.

Skycalcdisp.py will come up with some windows you may not want (e.g. the site chooser). To close any window in skycalcdisp.py, use the "Hide" button provided, not the "X" button on the title bar; if you use "X" you can't get the window to come back up.

(4) Near the bottom of the gui skycalc window you'll see a button labeled Guide Star Config. Press this to get a tiny window that sets the telescope and the rotator angle.

Be sure the telescope rotator is set to a precisely known angle, probably zero. Note that the mirror covers must be open to move the rotator. Once you do have the mirror cover open (!!!!) you will want to ensure that the rotator encoder is correct by by putting the rotator on exactly zero. To do this, depress the white pushbutton on the rotator paddle; when the rotator is dead-on zero, the pushbutton will light up white. You'll have to move the rotator very slowly to catch this, the button only lights up over a tiny range. Once you're sure the rotator is at zero, set the encoder in the xtcs window using the item brought up by the pink "Setup" button. (The manual page for the rotator, including a diagram of the paddle, is linked here ). Note that the rotator angle doesn't need to be zero for your science exposures, but it does need to be known accurately for this centering procedure to work.

(5) If you have a pointing list, load it into skycalcdisp.py with the Get object list button. This is not strictly necessary, but it makes the operation vastly more convenient. The format of the list is identical to the MDM pointing list, viz.

   name_no_blanks  hh mm ss  dd mm ss  equinox
for example
   grb090909  7 50 18.23  -0 12 13  2000

OK, now to use it:

(6) Enter an object's coords into the program. You can always do this by typing the RA, dec, and equinox into the boxes in the upper left, followed by the "Enter" key to refresh. If you do have an object list loaded, you can load your object by double-clicking it on the list, or by typing its (exact) name into the "objname" box in the main window and hitting "Enter".

(7) Press the Get Guide Stars button (bottom row). A temporary bright blue xterm pops up, and a big black xwindow appears like the one at the top of this document. The red lines show the guide probe's field of regard, with the catalog stars superposed on it. Click on your favorite star, and its guider XY coordinates will appear in the blue window as shown below. (In all likelihood the blue window will be blocked by the black diagram, so you'll need to move the black diagram to see the numbers; just grab its title bar with the mouse and drag it out of the way.)

(8) Selecting a good guide star:

(9) Go over to the xmis window (shown below). Select the beige "x:" field, and use the delete key (not backspace) to erase the number there; type in the guider X value of your star, and hit the "Enter" key. This moves the guide probe. Do the same for Y. Note that the blue field above the entry boxes gives the actual location of the probe (though it doesn't update until the probe stops moving).

(10) Set on your target by putting the guide star near the middle of the screen. Center up your target accurately - e.g., with a test exposure, or by viewing the target on the CCDS slit jaws. Once the telescope is pointed exactly where you want, use the numeric keypad on the guider computer keyboard to move the guide box onto the star. This will be the fiducial location for all your guide stars.

(11) Take your science exposure; check carefully that you've actually centered it correctly. When it's time to move to the next target, repeat steps 6-11; to summarize, just

Carefully check your centering on the first few targets to be sure you haven't blundered, and pretty soon you'll be quickly centering up by dropping the guide star into the box. This won't usually be accurate enough to put a star right down a slit, but it'll be plenty accurate enough even for rather exacting direct programs. With CCDS it will give a valuable check on your target ID, and make it much quicker to set up.

(12) To make the big black Xwindow go away, just type a q in the black Xwindow. This kills the process that skycalcdisp.py has spawned, and takes down the blue Xterm also. These windows take up a lot of room so you'll only want one set up at a time. The skycalc window will stay up and you can repeat the process indefinitely.

Cautions:

Historical note
The skycalcdisp.py manifestation of this code was derived from an earlier program, gs24, which is available at MDM but which I believe was seldom used. As it turned out, gs24 had a bug in it -- nutation was being applied inconsistently -- which led to roughly 20-arcsec errors. Because of experience with gs24 I had thought that the offset guider might not be accurate or reproducible. With the bug fixed, it turns out that the guide-star centering procedures typically puts you on target within a few arcsec -- it's really good! Integration into the skycalcdisp.py program makes it easier to get coordinates into the program, too.

Skycalcdisp.py is useful in its own right -- you can learn it by playing with it, and it has an online help text and reference manual built in. There's also an html manual (with screenshots and the like) on the MDM mountaintop web server. The java version JSkyCalc is similar to skycalcdisp.py, but it does not have any MDM-specific goodies. Java code is extremely portable; JSkyCalc it will run on Macs and Windows machines as well as Linux boxes, provided only that you have Java Runtime Environment 1.5 or higher.