PTI Single Star Observing Cookbook

HTML version with links to /home/pti/writeup documents

CDK 24 Nov '96, Update 21 May '97, 9 September '97, 9 Dec 99, 9 Mar '00, 17 Apr '00
MJK 17 Jul '98 Update 20 Aug '98, 19 Sept '98, Sept '99

These instructions are based on a set of notes taken during observing runs on 14 Oct and 11 Nov 1996. Xiaopei Pan was the PI, and he showed me the startup procedures, which I recorded as best I could. There is no guarantee that they are complete or correct, especially since the instrument itself is in a state of flux. Nevertheless, it is hoped that they will be useful to future observers.

These instructions cover only the most basic setup and a few of the error recovery procedures. A very concise description of the startup and operation is availabile in /home/pti/writeup/startup.txt Additional information is available in a set of files in the /home/pti/writeup directory on horatio. Links to these documents are provided below.

Contents

  • Troubleshooting Guide
  • The current Observing Schedule
  • Notes to the observer
  • Project Documents
  • An abbreviated Startup Checklist

  • Overview of the Instrument
  • Basic Setup
  • Setting the Observing Wavelength
  • Preparing the Detectors
  • Preparing the Huts
  • The Primary Bench
  • Aligning the Long Stellar Beam Paths
  • Aligning the Delay-Line Metrology System
  • Starting up the Data System and Sending Movable Parts to their "Home" Positions
  • Aligning the White-Light Source with the Boresighting Laser
  • Aligning the Single-Mode Fiber
  • Calibrating the Detector
  • Preparing the Acquisition System
  • Chop Calibrating the Star Tracker
  • To Begin Observing
  • Setting the Integration Time
  • Shutting Down
  • Backing Up Your Data
  • Miscellaneous Notes and Error-Recovery Procedures
  • Links to Documents in /home/pti/writeup 
  • Overview

    The Palomar Testbed Interferometer (PTI) is a two-beam instrument of 100 m baseline which is used to make very high angular resolution (~0.005 mas) observations of astronomical sources. The observations are conducted in the K (2.0-2.4 micron) band. The concept is simple: bring the starlight from a pair of well-separated apertures together and interfere them, after using adjustable delay lines to compensate for the difference in optical path lengths. Currently, the interference fringes produced by the science target are "tracked", i.e., followed by the delay lines and compensated in real-time as the the path length difference varies due to atmospheric "seeing", Earth rotation, and mechanical effects.

    The data returned are in the form of a single fringe visibility measurement per observation. Earth's rotation enables visibility measurements to be made in a series of points in the (u,v) plane, but reconstruction of an image is not possible. Future enhancements include implementation of a "dual-star" mode in which the fringe tracking is done on a bright (K<5) star within the isoplanatic angle (~30 arcsec) of the science target, which can be considerably fainter (K~15?). In addition, a third aperture is being brought online, although it will not be possible to use all three simultaneously.

    PTI consists of several discrete subsystems: a pair of siderostats (flat, steerable mirrors) and their associated telescopes, a star acquisition system with a CCD camera for each siderostat, a set of delay lines used to equalize the path length from the source to the beam combiner, metrology systems for accurately measuring the lengths of the delay lines, a star tracking system with a tip-tilt mirror (?), the beam combiner itself, an infrared array detector used to sense the ~2 micron light, and a rather complicated computer setup used to control it all.

    PTI is currently housed in a main building containing the delay lines, beam combiner, detector, and warm room, plus a small outbuilding ("hut") for each siderostat+telescope. Each hut is approximately 50 m from the main bulding, and is optically connected to it by a pair of PVC pipes of ~5" diameter which is used to block airflow across the light beams. For single-star (a.k.a. primary) observations, only one of each pair of pipes is in use; the second pipe is used to carry the beam of a secondary star during dual-star observations.

    Setting the Observing Wavelength and Frame Time

    Starting in 1999, it became practical to observe using an H-band filter (centered at 1.65 microns) as an alternative to the standard K-band filter (centered at 2.2 microns).   The shorter wavelength is useful primarily because it produces a smaller fringe spacing (lambda/D ~ 3.2 mas at H, and 4.3 mas at K, for a projected baseline of 105 m).  The tradeoff is that the timescales over which the atmospherically-induced phase changes occur is reduced by a factor of approximately (2.2/1.65)^1.2 = 1.4, so the instrument will have more problems tracking the fringe at the shorter wavelength.  In addition, the detector's quantum efficiency is significantly lower at H than at K.

    Switching between these filters is not completely trivial, since in addition to changing the filter wheel in the dewar, also it requires changing the delay-line stroke and detector readout timing, replacing the prism in the spectrometer, and realigning both the spectrometer and white-light optics in front of the dewar.  The details are given in the file  /home/pti/writeup/H-99.txt .  Note that it may be a bad thing to switch store data taken at different wavelengths in the same directory, since it can make the reduction more difficult.

    One may independently choose the length of time the detector integrates between readouts.  Frame times of 10 and 20 mS are available.   Because sensitivity of PTI measurements is typically limited by the detector readout noise, and because the detector spends a smaller fraction of its time reading out when used in 20 mS mode, 20 mS mode allows PTI to observe stars ~3 times fainter than it can in 10 mS mode.  The catch is that the longer frame time reduces the bandwidth of the fringe tracker loop, so it doesn't work well when the atmospheric seeing is fast.  Switching between 10 and 20 mS mode is done by running a commandline script, rebooting the fringe tracker, and resetting the amplitude and frequency of the delay-line stroke.  Detailed instructions are in  /home/pti/writeup/20ms.txt .
     
     

    Basic Setup

    Because PTI is not a production science instrument, there is a lot of fiddling around to do before beginning a night's observations. Some of this must be done outside in the siderostat "huts", some on the optical benches in the main building, and some at the console of harbinger, the main data acquisition computer. The following paragraphs describe the basic setup procedures. They assume that everything is in its "normal" configuration and that nothing is broken or badly out of adjustment.

    Here is a map of the optics room at PTI.

                    ^       ^           ^       ^
                    |   \   |  Delay    |   /   |
                    |    \  |  Lines    |  /    |
                    |     \ |___________| /     |
      ______________|      \ ___________ /      |______________ 
                            |           |                      |
       __________________   |           |   __________________ |
    | | Secondary Bench  |  | Metrology |  | Primary Bench    ||
    | |                  |  |           |  |                  ||
    | | Dewar            |  |           |  | Dewar    WL      ||
    | |__________________|  |      PC   |  |__________________||
    |                       |___________|                      |
    |                                                          |
    |_______________________    _______________________________|
                                           liquid Nitrogen
                                                tank

    Preparing the Infrared Detector

    The infrared detector is a NICMOS-3 type. It is sensitive from ~1-2.5 microns, and has 256 x 256 pixels (65536 total), of which only a few are actually used. The detector needs to be kept cold with liquid nitrogen, and is therefore installed in a dewar. This dewar is an aluminum cylinder approximately 12" diameter and 24" high, and is bronze or gold in color. It contains a can of liquid nitrogen to which the detector is thermally coupled, so that the detector is held at the 77 K boiling temperature of the nitrogen. The dewar is insulated by a vacuum between its outer wall (the "jacket") and the can.

    Maintainence of the dewar should be done only be people experienced with such things, because although it is basically pretty simple there are a number of things that can go badly wrong. The vacuum must be maintained by pumping through a valve on the side of the jacket when the dewar is at room temperature. Typical dewars can go about a week between pumpings before the vacuum goes "soft" and the nitrogen boiloff rate becomes unacceptably high. When the valve between the dewar and the pump (or the outside air) is closed, and there is a good vacuum in the jacket , liquid nitrogen can be added to the can through the fill hole on the top surface of the jacket. There is a funnel and a set of hand dewars (and gloves!) for this purpose. Don't put the funnel directly into the secondary dewar; put the notched metal cylinder on first to leave an exhaust hole for the nitrogen gas.

    An LED display next to the dewar shows the temperature of the detector in degrees Kelvin. If it's close to room temperature when you start adding nitrogen, it should take an hour or so to reach the ~77 K operating temperature. If the temperature reads 77 K, then all is probably well.

    Note that the secondary dewar, which is located on the secondary beam combiner bench and is larger than the primary dewar, is used for dual-star mode only. If the secondary dewar is cold (check its thermometer), then it's probably worth topping off the nitrogen in that one also. Generally it's good to avoid putting array detectors through many thermal cycles as this causes pixels to go bad.

    Preparing the Huts

    This is pretty straightforward. It should be done around twilight (not earlier to avoid exposing the siderostats etc to direct sunlight, and to keep them from getting too warm). The huts are small outbuildings with covers that slide away on rails. Each hut is held open or closed by a pin attached to the cover close to the handle. Open it by sliding the locking pin out of its hole, and pull the hut back along the rails by its handle. Be careful not to slam the hut cover into the I-beam holding up the end of the rail. Pin the cover in its open position to prevent it from being blown around by wind. Each station has an air conditioner mounted on the wall and a freestanding dehumidifier. These should be on during the day, and need to be turned off when the hut is opened. Remove the flat black metal cover over each siderostat. It's not locked down, but is held in place by a couple of small hollow tubes on its top surface (these fit over pins attached to the siderostat).

    Each hut produces two beams, the Primary beam and the Secondary beam. The Secondary beam is only used for Dual Star observing. The Primary beam path is on your right as you follow the pipes into the hut.

    Flip up the shiny cloth cover over the optical bench and find the Primary corner cube. It's about an inch in diameter and is attached to a black aluminum stand about 3" high. Don't confuse it with the Secondary corner cube, which is gold-coated. Place it against the stops set up for it on the optical bench, labeled "Primary". Then remove the plastic cover over the end of the primary PVC pipe and inspect the window to make sure it's clean.

    The Primary Bench

    Go back into the main building and take a look at the primary optical bench. Here's a rough schematic of what happens on the primary bench:
                       visible light
                     goes to star tracker 
                           ^    ^
                           |    |
     light from S hut      |    |                  
     -------------------->            ---------->\
                                                 |   N+S light for
     light from N hut      Dichroic   IR light   v   visibility measurement
     -------------------->            ------->  beam ------------>\
                                               combiner           |       
                                                 |                |        
                                                 | N+S            v        
                                                 | light         fiber     
                                                 | for fringe     |       
                                                 | tracking       |    
                                                 v                v      
                                            detector<-- prism <-- /
                                            (in Dewar)       
    
    
    
    
    Here is a crude map of the Primary bench. Locations of things you will need to adjust have asterisks.
     ______________________________________________________________________________
    |             visible light goes up here                                       |                           |                                                                              |
    |               Questar          star tracker                                  |
    |    |                                                                         |
    |   |                                                                          |
    |                 compensator                                                  |
    |           /Di-       |         \                   coupler                   |
    |          /chroic                \                    |       \          \    |
    |         /                 beam                 OAP                           |
    |                          combiner             single                         |
    |   || stops for         >                      \\ mode                        |
    |   corner cube*        >           OAP          \\ fiber*                     |
    |                    2 corner       fiber                                      |
    |                     cubes*       \ ends                                      |
    |                                   \ here                                     |
    |    _____                                              align WL               |
    |   /     \                                   spectral *here    _              |
    |  /       \                                   /\/*fil-\\     l| |       micro-|
    |  |       | ||WL*        |> prism            /  \/ter  \\    a| |ND     scope |
    |  | dewar | ||lens                           \   \goes       s| |filter  _    |
    |  \       /      ___ spectrometer         WL  \  /here       e|_| *     | |   |
    |   \_____/       --- fold *             source \/            r   +block |_|   |
    |______________________________________________________________________________|
    
    
    

    Aligning the Long Stellar Beam Paths

    Unblock the boresiting laser. This means pushing a button on the optical bench to open a shutter and moving the neutral-density (ND) filter, which is now in a small hand-operated flip stage, out of the beam.

    For each siderostat (North and South), put the alignment target, which is a piece of cardboard with a hole in it mounted on an aluminum stand, against its stops on the fringe-tracker table. Now adjust the mirror which sends the laser beam to one of the huts. This mirror is located on the optical bench close to the end of the delay lines, and right next to the end of its corresponding PVC pipe. It is one of four, and is labeled. Adjust the mirror by turning the two adjustment screws, either by hand or using the picomotor controller on the N side of the table. Try to get the return beam centered on the hole in the target. To use the picomotors, set the swich on the box to the adjustment you want to make and make the adjustment with the "a" switch on the remote controller. Repeat for the other siderostat.

    Caution: Do not adjust these mirrors unless you see some return light (try translating the template left-right or up-down slightly to see where the return is). One rotation of a knob causes about a 12" translation of the beam at the hut, making it easy to get "lost" by adjusting so far that the light doesn't make it out the pipe at the end. If that happens, it's a pain to get back. If you don't see anything, first verify that light is indeed heading into the input side of the pipe toward the outside. Then remove the cardboard template you just installed in the lab, head back to the hut, and install the full-size template. This is an inverted-T bracket with target sides labeled "Primary" and "Secondary." Put this template in place of the corner cube with the "Primary" side facing out and use it to get the beam roughly centered. This will require running back and forth between the hut and the lab, unless you have a friend to help via the intercom. For the fine tuning, you can put the corner cube back and follow the instructions above.

    Once the laser beams are aligned, go to each hut and remove the corner cube target and store it out of the beam. Get a segment of PVC pipe from rack on the back of the hut and carefully install it between the end of the long pipe and the optical bench. The hut end of the pipe should rest between a pair of screws on the optical bench. Pull the shiny cloth around the pipe to insulate the bench as well as possible. The South Hut has two pieces of cloth that fit aroun the pipe outside the hut wall that should be velcroed or taped on to keep air from flowing through and degrading the seeing. On the South Hut, put the section of wall back in place on the south side for the same reason.

    Aligning the Delay-Line Metrology System

    The signals from the two optical detectors for the metrology interferometers on the long active and passive delay lines are normally displayed as traces on an oscilloscope located on the metrology optical bench. The system sometimes goes out of optical alignment, causing the size of these signals to be below their normal values (typically ~2 divisions on the scope). If a signal falls below about half its normal value, the system may lose track of the position for that delay line. This should (but may not be) be indicated by an error message on the GUI warning you that a metrology dropout has occurred.

    Aligning the metrology optics for each of the long delay lines takes several steps. Move the delay lines to the back. Go to the center optical table in the lab. Flip the cardboard target down over the upper of the two ~2" mirrors which face toward the delay-line carriage, and tweak the rotation of the beamsplitter, which is a 1" cube on a small plexiglas-covered table between the mirror and the carriage, so that the laser spot is centered on the target. Then flip the target back out of the beam and put a piece of paper in front of the optical detector, which is mounted on the table with the beamsplitter. Using the white plastic knobs, adjust the top mirror so that the return laser spot is aligned with the outgoing spot on the detector. Then remove the paper and adjust the bottom mirror to maximize the signal on the oscilloscope. Since the laser is bright enough to saturate the detector in normal operation, making it difficult to see where the strongest signal is, you might want to put a neutral-density filter in front of the detector for this adjustment.

    In the worst case, the alignment is completely off and there is no signal. If this happens, there is a set of instructions for recovering the signal in /home/pti/writeup/dlalign.txt

    Once the signal strength is normal, send the delay lines to their fiducial positions (using FidSet at the GUI) to recalibrate them. We will do this in the next step.

    Starting up the Data System and Sending Movable Parts to their "Home" Positions

    Note: I like to reboot acq at this point at the beginning of the night - MJK

    On harbinger, cd to /home/pti/bin. Type 'beginNight' to create a data-directory link. Then type 'g &' to start the GUI. This launches the main control panel, labeled "Palomar Testbed Interferometer", which has a bunch of buttons that toggle the visibility of control windows for the various subsystems.

    The next step is to establish the fiducial (home) positions of the siderostats and delay lines by driving each system against a limit switch. The encoders and metrology systems will monitor changes in position relative to the fiducials. Note that the fiducials for a subsystem are lost whenever the corresponding CPU is rebooted, making it necessary to these procedures if that happens.

    Click "Pri N" under Siderostats to pop up the north siderostat control panel. Click "Off", then "Home" to send the north siderostat to its home position. Then click "Pri N" on the main panel again to hide the north siderostat control panel. Repeat this procedure for the south primary siderostat.

    NOTE: On these panels, it is sometimes necessary to precede each click of a top-area action button by a click of the "Off" button to get the system to recognize a click.

    Click "Psv" to get the passive delay line control panel, titled "Long Motor Only Delay Line". Click "Fid Set" button to send it to its fiducial position, then hide the control panel by clicking "Psv" on the main panel again. Repeat this procedure for the active delay line ("Act").

    On the "Long Active Delay Line" window, check the "Show detailed status" box to expand the window. Open the Fringe Tracker window and look at the Frame Rate and the Desired stroke. Their values will depend on whether you are in 10-ms or 20-ms mode, and on on the observing wavelength; for example, for 10-ms mode at K there will be a Frame Rate of 100 and Desired Stroke of 3260, for 20-ms mode at K there will be a Frame Rate of 50 and Desired Stroke of 2934. If you want to change the integration time, now is a good time to do it. Otherwise, copy the Desired Stroke into the "Amplitude (nm)" field in the Long Active Delay Line window, and click the appropriate Frequency(Hz) button below that field to enter the Frame Rate. Then click "Send Stroke", followed by "Stroke Set".

    Aligning the White-Light Source with the Boresighting Laser

    The purpose of this step is to insure that the white light (WL) source is aligned with the laser for the next set of adjustments. Put the corner cube in the North position at the left edge of the primary beam combiner bench. Check to see that the laser is unblocked and that the ND filter is in the beam. Turn on the small TV monitor which sits on the plexiglas cover over the bench. This is connected to a video camera which views the output of a microscope on the far right. Adjust the position of the lens directly in front of the microscope to center the laser spot on the target marked on the monitor.

    The white-light source is a tungsten lamp controlled via a power supply located below the optical bench. Flip the solid orange "DC out" swich to turn on the WL source. Turn the voltage all the way up (~4.5 V) so that the current through the WL source is at the limit set by the current adjustment knob on the power supply. Then block the laser and look at the monitor. Adjust the two white plastic knobs on the mirror tip-tilt stage next to the WL source to put the WL spot on the crosshairs. These knobs are sensitive.

    Note: This procedure is also described in /home/pti/writeup/ftalign.txt

    Aligning the Detector

    Verify that the corner cube is in its position along the edge of the beam-combiner optical bench, in the North beam. Go to the PC to the left of the optical bench. (Note: the PC is being used simply as a dumb terminal to the fringe-tracker CPU, which is called ft0, so if for some reason the PC isn't working you can go to horatio, open an xterm, and do 'rlogin ft0'. The username on the subsystem CPUs is 'delay', and the password is 'lineline'. For the following, it doesn't matter which keyboard you're typing on, except that the PC is more conveniently located close to the dewar and its display.)

    Commands on the PC can either be typed carefully (the system is case-sensitive) or entered by typing the Alt key followed by a number. The Alt key macros are listed on a piece of paper next to the keyboard. You have to hit the "Enter" or "Carriage-return" key after typing each command or Alt macro. Note that the PC periodically prints out some status info, and this might come out in the middle of the command you're typing. Don't worry about that.

    Type the following commands:

    Set the WL voltage to around 0.6 V. You should see an array of 8x8 pixels on the screen to the right of the PC monitor. There should be a bright spot on an otherwise dark field. It's possible that the detector will be either seeing too little light or is saturated; adjust the white-light power supply to get a good image. The display will be updated with a new detector readout every few seconds.

    The PC will show a pair of centroid numbers, X, and Y, every detector readout. Adjust the white-light lens mount (it's on the optical bench, and is labeled "WL") so that the X and Y values are 0 +/-1. This will happen when the center of the bright spot is precisely on the 5th row down, and the 5th column from the left (the correct pixel is marked with an "X" on the display). The units of the centroids are 1/30 of a pixel.

    The next step is to align the spectral axes. Do this by putting the narrowband infrared filter in front of the white-light source. The filter is taped to a small aluminum stand, and it fits on the little shelf behind the lens mount closest to the WL source. It is necessary to increase the voltage on the white-light source to ~4 V to compensate for the light lost in the filter. At the PC, type the command

    Now adjust the spectrum mirror mount till the X and Y centroids displayed on the PC are 0 +/- 1. The spectrum mirror is on the optical bench near the dewar, and is labeled "SPEC".

    Note: This procedure is also described in /home/pti/writeup/ftalign.txt

    Aligning the Single-Mode Fiber

    The optical path from the star to the dewar now includes a single-mode fiber which rejects distorted components of the incoming wavefront, trading away some photons to get a cleaner signal. The OAPs in the diagram of the Primary Bench are Off-Axis Parabolic mirrors that send the light into the fiber and collect it from the fiber. The position of the input end of the fiber (the end furthest to the right when one faces the microscope eyepiece) must be adjusted fairly precisely. This is accomplished using the WL source (set to ~ 0.7V) and tweaking the white knobs on the fiber positioning stage while reading the signal level on a multimeter.

    Make sure there are no strong lights on. Remove the narroband filter from the beam. Type "ftABCD" on the PC. Turn on the multimeter by turning its rotary switch two click CCW (to "off") and then two clicks CW (to "DC", which is labeled as a V with a solid and a dashed line above it. Turn on the WL source and adjust it so that the meter reads something like 2.5 V. This should require around 0.7 V on the WL source. (If the meter reading fluctuates erratically over a wide range then the WL source is probably too bright and the sensor is out of range.) Peak up the signal using the white fine adjustment knobs on the fiber positioning stage. The little bargraph display on the meter is convenient for this kind of tweaking.

    Additional information is available in /home/pti/writeup/fiber.txt

    Calibrating the Detector

    This is where you measure the "flatfield" and sky response of the detector. Before you do this step, make sure the sky is dark! Remove the infrared filter from in front of the white-light source, and set its voltage to around 0.6 V. At the PC, type This causes the signal level in four positions along the fringe-tracker stroke to be read and displayed periodically on the screen. Adjust the white-light source to make the levels close to 1000 ADU. Once the level is set, turn OFF the white-light source and any other lights (including flashlights), remove the corner cube from the edge of the table, and type to take a low-intensity frame (sort of a "sky").

    Then turn the white-light source back on, put the corner cube in its position at the edge of the table, and type

    This takes the "flatfield" frame.

    NOTE: Because of the way the software is written, ftCalLow and ftCalHigh must be done in this order, and in pairs. So, for example, if you mess up the ftCalLow you must do the ftCalHigh before you can come back and do the ftCalLow again. Then you must repeat the ftCalHigh.

    Now move the corner cube out of the beam. It's best to store it with the front (optical) surface facing down so it won't accumulate dust.

    Note: This procedure is also described in /home/pti/writeup/ftalign.txt

    Preparing the Acquisition System

    Open the two ACQ control panels and check "Show Status", then "Hardware Reset". Click "Off" and then "Reset". This sends the acquisition cameras into a continuous readout mode, which seems to help clear out any residual charge on the detectors and improves the chances that they'll work properly later. Click "Off" again after a few reads.

    Unblock the boresite laser and remove the ND filter from the beam. Open the "North" acquisition camera window and click "Laser Boresight". Do the same for the south. The laser spots should be visible on the two TV monitors to the left of harbinger's display. If there's a problem, click "Off" and "Laser Boresight" again. When the process is finished, block the laser.

      CPU Rack behind sound curtain
     ________________________________
    |          |          |          |
    | Sequencer| Delay    | Fringe   |
    | Computer | Line     | Tracker  |
    |          | Computer | Computer |
    |          |          |          |
    |          |          |          |
    |          |          |          |
    |          |          |          |
    |          |          | Acceler- |
    |          |          | ometer   |
    |          |          | Oscill-  |
    |          |          | iscope   |
    |________________________________|
    
    

    Chop Calibrating the Star Tracker

    The star tracker is a tip-tilt system which stabilizes the positions of the star images as they go to the beam combiner. It consists of a small telescope which focusses the visible portion of the starlight (which is separated from the infrared by a dichroic) onto a set of four avalanche photodiode (APD) detectors which measure a centroid position, and a piezo-driven tip-tilt mirror. A single set of APDs and a single tip-tilt mirror are used for the primary beams from both the North and South siderostats. This is done by chopping the tip-tilt so that the North and South beams alternately fall upon the APDs. The chop calibration step is used to determine what signals need to be sent to the piezo to accomplish this.

    Set the white-light source to ~1.6 V. Remove the paper cover from the pair of corner cubes, and verify that the laser is blocked. Back at the horatio console, click on the "PriN" and "PriS" under "Star Tracker" to bring up a pair of control windows. Position the windows with the mouse so that both are visible. Click the "Chop Calib" button on each window, one right after the other (don't wait for one to finish before starting the second - the two chop calibrations should be done simultaneously; in practice, what is important is that they finish nearly simultaneously). When both calibrations finish, it's a good idea to repeat the chop calibration, though the reason for that is somewhat mysterious. Then put the paper cover back over the pair of corner cubes and turn off the white-light source.

    You are now ready to begin observing. YIPEE!

    To Begin Observing

    On the Observing window (which can be shown by clicking the "Observing" button on the main control panel) click "Create star list", then "Browse Current Schedule", then click on "Load Current Schedule". Set the track time to 130 seconds (you must do this before you load the selected stars). Highlight the stars to observe first, Click "Load selected stars", then "Send list to sequencer".

    To start observing, click "Off", and "Primary Observe". This should cause the system to start its automatic observing mode, in which it cycles through the stars in the starlist, performing all tasks without user intervention (until something goes wrong!) Do not close the Observing window until you have sent the list to the sequencer, or the GUi will crash.

    If you wish to modify the starlist, click "Create star list" again. Modify the starlist in the obvious way. The only trick is that you must stop observing (click "Off" in the Primary Observe window) before sending the new starlist to the sequencer.

    Setting the Integration Time

    Depending on the seeing conditions and the brightness of your targets, you may choose to observe with 10-mS or 20-mS detector frame times. The longer frame time improves the sensitivity by about a magnitude, but it only works well if the atmosphere is stable enough that the fringe doesn't move around too much during the exposure.

    There are some simple scripts, called 10MS and 20MS, in /home/pti/bin. They modify configuration files in the appropriate way. Once one of these scripts has changed the configuration, it is necessary to activate the changes by rebooting the fringe tracker CPU (ft0), and resetting the stroke on the delay line. The reboot is done in the usual way: hibernate the system by checking the Hibernate box in the Sequencer window, then rlogin to ft0 with username delay, password lineline, and hit Ctrl-X. When the terminal beeps and tells you that the remote host has closed the connection, the CPU should be back up.

    Note that the calibrations for the fringe tracker have to be done after the reboot. This means the CalLow,CalHigh sequence for the fringe tracker. You'll probably want to redo the FidSets for the delay lines. Put in the new values of the stroke amplitude and frequency (check the Primary Fringe Tracker window for the correct values), then do SendStroke,StrokeSet for the Long Active delay line.

    Additional information is available in /home/pti/writeup/20ms.txt

    Shutting Down

    This is simple. Start by sending the siderostats to their "stow" positions, send the passive and active delay lines to their "back" positions, and exit from the data acquisition program. Put a set of blank CDs in the CD-writers. Then run the "endNight" script in /home/pti/bin. This Perl script (hats off to Andy Boden!) will do a preliminary reduction of the data, compose a night report and email it to the PTI group, and burn the data to the CDs.

    For each hut, turn on the air conditioner and/or dehumidifier as appropriate, remove the PVC pipe extension and store it, cap the end of the pipe to cover the window, flip the shiny cloth down and velcro it in place. Put the covers back on the siderostats (with the little silver tubes fitting over the pins). On the south hut, put the south wall panel back in place to provide insulation.

    Backing Up Your Data

    The CD burning process is done automatically by the endNight script. But there may be situations in which it is useful to do it manually. Here's how:

    The data acquisition system saves raw data to the /home/palomar/data directory, which is actually a symbolic link to another directory which is created by the beginNight script. cd to /export/data and make a subdirectory there whose name is the data (yyddd, where ddd is the U.T. date at the start of the observations). Use the 'cp -rp' command to copy the night's data there, and then delete the orginal data. Follow the instructions in /home/pti/writeups/cdBurning.txt to create two CDs, one for taking back to Caltech and one to stay at PTI.

    Miscellaneous Notes and Error-Recovery Procedures

    There is a set of notes on dealing with many common problems in the file /home/pti/writeup/common_problems.txt on horatio. The intent is that these notes contain the most up-to-date versions of recovery procedures for the most common types of errors. What follows is a set of notes describing the resolutions to some problems I've seen at PTI, and which may not be described in those notes.

    Note that an on-call system has been set up in which experienced PTI observers are assigned to serve as telephone tech support people. The schedule, which tells you whom to call on a given night, is on the web. Please contact your on-call volunteer after you've exhausted the procedures in the writeups and before calling Mark Colavita.

    Computer crashes: The most troublesome component of the PTI is probably the computer system. This consists of three cardcages in the observing room, at least one cardcage in each hut, and several PCs which serve as dumb terminals connected over serial lines. The cardcages can contain several CPU boards each. Typically, one CPU board drives one subsystem component. If you see the realtime clock on the control window for a particular subsystem component stop, the corresponding CPU is probably down.

    If it becomes necessary to reboot the whole system, follow the directions in /home/pti/writeup/reboot.txt

    It's usually the cardcages that cause the most trouble once things are working. The usual procedure is to reboot the offending CPU. Before doing this, it is necessary to 'hibernate' the system. As I (vaguely) understand it, this is necessary to prevent shared memory areas from being corrupted by the rebooting CPU. Additionally, the CPUs must be booted in sequence, and for any given attempt there is a significant chance of failure, so it might be necessary to try several times. There is a file in /home/pti/writeup called 'reboot.txt' or something similar which gives details. There's also a set of instructions posted at eye level on the wall to the right of the cardcages. Good luck.

    Fringe Tracker Window Hang: If the system still seems mostly alive but the digital clock on the Fringe Tracker window has stopped, it probably means that one or more of the processes running on fit FT CPU has a problem. You have to use the PC terminal in the beam-combiner lab to get it going again. Type a ^C (ctrl-C) to get a prompt, then schedShow to see a list of the scheduled processes. If any of them are in "panic" status, re-enable it with schedTaskEnable "taskname". Here taskname will be something like "ftTask Med", for example. The computer should respond with messages like "... cal start". Repeat the schedShow command as needed to confirm that there are no more processes in panic state, and then type ftOff and ftTaskZip. Finally, do another, schedShow to confirm that everything is well. Note that this procedure may work with the other CPUs as well.

    PAQ (Primary Acquisition) Errors: These fall into a general class of errors which are often caused by the presence of a large offset value. So the first step is to go to the siderostat control window and and check the "Show detailed status" box. The idea here is to clear out any offsets that are larger (in an absolute-value sense) than ~10,000. To do this, click "Set Offsets" to get a new panel on which a there are buttons used to clear the offending offsets. Since this panel disappears when you do this, you'll have to repeat the procedure once for each offset you wish to clear.

    If a PAQ error persists, try hitting the "Hardware Reset" button, which becomes visible when the "Show details" box is checked.

    If none of the above works, try repeating the Laser Boresite procedure, clicking "Use Laser Boresite", and then clearing the siderostat offsets again.

    NOTE: Watch out for NaN values in the offsets. These are trouble, and should be cleared out quickly whenever they are seen.

    Don't step on the big black beetles. They stink.

    Links to Documents in /home/pti/writeup