HIRES Cross-disperser changeout procedure

Contents

• Mechanical Changeout Procedure
• Software Calibration Procedure
• Manual Calibration Procedure
• Useful Files
• Appendix: Sample Session

Mechanical Changeout Procedure

1. Don't forget your bunny suit!
2. Upon entering the HIRES enclosure, before doing anything else, check if the optics covers are closed. If they are not, then you need to exit the enclosure and close them from XHIRES via the ETC button. This button is in the top left of XHIRES and pops up another menu. Select the Close Down option.
3. If the covers are closed, pull back and fasten open the curtains, and set up the quartz flood light.
4. For safety reasons, switch the collimator shuttle and camera cover controls to manual, to prevent remote operation.
5. Switch the cross disperser turret control to manual, and by pushbutton rotate it to a position normal to the entrance beam (facing the slit). This rotation can also be done from command line by typing

   	lehoula{hireseng}: m xdname=slit-axis
   

6. Roll the CD chain lift with lifting bridle over the CD, lower it and attach by hand the knurled knobs to the threaded side inserts. Take the slack out of the lifting chain. Here is a picture.
7. Disconnect the cover control connector, a 6-pin LEMO connector.
8. Disconnect two airlines. One is a quick disconnect and the other is a screw disconnect.
9. Unscrew the six 3/8-inch capscrews from the bottom of the turntable. There are two on each side, and one each rear side half. The table must be rotated slightly to access the two left side cap screws in turn. It is safest to the drive to do this with the pushbutton motor control, rather than rotating the pulley wheel by hand.
10. Position the cart to accept the CD, over in the open area near the entry door. Slowly lift the CD off the turntable, noting that it will be resting against the rear guides as you do so. Once clear of the table and guides, it can be lifted more rapidly. Lift it high enough to manage it's transport through the narrow passage between the first corrector element and the collimator shuttle.
11. When in position over the cart, lower the CD, positioning the cone detent over the hole in the cart. Make very gentle contact with the cart.
12. Install the new CD in reverse order.
13. Reset the CD, collimator, and camera cover control boxes to auto. Return the lifting bridle and lift to the stow position. Turn off all lights and reconnect the curtains.

Software Calibration Procedure

1. Launch HIRES software. Logon as user hireseng and start up the control software by selecting HIRES Control Menu > Start All HIRES GUIs from the OpenWindows pulldown menu. This will bring up an xterm window running the hires_init script, which will ask you a series of questions:

   •   Do you want to continue running the setup script? (y/n) [y]: 

     Press Enter to take the default (i.e., y). This just gives people a chance to bail out.

   •   Enter names of observing team members [Hill]:

     You can enter anything you like or just hit return. The default is the last people who ran HIRES.

   •   Enter data directory name [/s/sdata125/hireseng/2010apr01]:

     Just hit return. The default presented to you is a subdirectory created on the disk you chose named by today's date.

   • Enter starting image number [9]:

     This does not matter for the cross-disperser calibration so you can either take the default or just enter 1. This just allows observers to number their data however they like.

   •   Enter [y], or anything else to skip homing.

     Its a good idea to home things so enter y.

2. Pre-configure HIRES. You must do the following in order to ensure that HIRES is ready to complete the calibration script:

   • Select collimator: This is done via keywords. From an xterm on either vm_hires or lehoula (hires server) issue this command: "modify -s hires coll=red" or "modify -s hires coll=blue", as appropriate. It will take a minute to move the collimator into beam.

   • Verify collimator: "show -s hires collred" and "show -s hires collblue". Correct Red Collimator shows: collred = red & collblue = not blue, and vice-versa for Blue Collimator.

   • Open hatches. Click the Covers button at the top in HIRES_GUI and select Open All. Wait to proceed until all hatches are open.

   • Position cross dispersion. Use the command m xdraw=-10000 to set the cross disperser position to the zeroth order position. If you're lucky the move will complete, but if you're unlucky the cross-disperser will start oscillating. In the latter case, use the pulldown menu to select HIRES Control Menu > Stop Cross-disperser Oscillation to interrupt the move and try again. Note: it may help to complete the move in smaller increments of 1000 units or so.

   • Make sure OBSTYPE = Object (select 'Object' under Obstype on the dashboard).

3. Start IRAF.

   As an interim measure, you will need to use IRAF to perform some measurements on the image.

   • Launch iraf and ds9 from the windows manager background menu by selecting: IRAF/IDL > IRAF > cl+ds9

4. Run calibration script.

   The script will reconfigure HIRES so that the zeroth order spectrum falls near the middle of the green chip as a bright horizontal line. The CCD is windowed so that only a narrow strip reads out. Important note: Once you start the cal script running (next step) it will bring up an xterm window. Lots of stuff is going to scroll past in this xterm and it helps to expand it. Right click with the mouse on the xterm title bar, click and release on Full Size.

   • In a lehoula xterm, type: "calibrate_cd" (~hireseng/bin/calibrate_cd). Caution: will NOT work from a vm_hires xterm.

   • You will first be prompted for the type of cross-disperser to calibrate:

       Type "uv" for Blue-CD calibration, "red" for Red-CD, "e" to Exit,

     Enter uv or red as appropriate.

   • The script now configures HIRES in zeroth order imaging mode (xdraw=-10000), and takes a 8 sec quartz image. This produces a line in the spatial direction near the middle of the chip. The displacement of this bright line from the nominal position (row 1076) will determine the home offset of the X-disperser.

   • While waiting for the image to read out, go to the IRAF session you started up earlier and cd to your output data directory (which can be determined by executing the command sc outdir in a window on hiresserver).

   • When the image is read out, it will be written as backup.fits in /s/sdata125/hireseng/xdchange. At the IRAF prompt, type

       display backup.fits[1] (if no line, then backup.fits[2])

     You should see an image like this.

   • To analyze the image, type imexamine at the IRAF prompt to get an image cursor. Place the cursor on the center of the bright vertical feature and press the j key to fit a Gaussian profile. You should get a plot like this. Note the center value.

   • At this point, the xterm window with the script should print the following message requesting your input:

        Enter the position of the zero order

     Type in the center value derived from your IRAF Gaussian fit.

   • At this point, the new home positions for the X-disperser and echelle gratings are calculated and printed out. A typical X-disperser offset when first running the script is less than 300 counts. The echelle offset is always 0 (red) or -5085 (blue). Here is an example (from a blue calibration):

       Old cross-disperser home position:  -82
       Offset:                             215
       New cross-disperser home position:  133
       Echelle home position:              -5085

   • Below the output (above) is a description of how to decide whether to reboot the motor crate or abort. To elaborate on that description:
     • If you do not see the correct horizontal line (the zeroth order spectrum) then you must ABORT by typing a and pressing Enter. Why you might not see a spectrum
     • If the offset is very large (more than a few hundred), then you should also abort.
     • Look at the value of offset. Here it is 215. This qualifies as either less than -1 or greater than +1, so in this case you would want to reboot the motor crate no matter how many times you have run it so far.
     • Even if you see an offset of -1, 0, or +1 on your first running of the script you must reboot. This will make sure the new echelle position is properly applied.
     • If, after rebooting, you run through the script one or more times and the offset is -1, 0, or +1 you can abort. You may have to run through the script multiple times.

   • If you choose to reboot:
     • This will load the new positions to be applied at the .cfg file level.
     • You will be prompted for a comment for the log; please enter your initials at a minimum.
     • Do not be alarmed by the 10 or 20 error messages you see that are a normal part of the reboot process:

         Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
         ...Waiting for motor crate reboot to complete...

       These messages are normal while the motor crate is rebooting. The reboot should take about 2 minutes to complete.

   • After the HIRES motor crate reboot is complete you will be asked whether you want to take another image to verify that the new home positions are correct. Answer y; this will run the script another time and acquire another image. It should now show a well-centered feature, like this. Warning: it is quite possible that the script will hang before taking the image if the cross disperser enters oscillation mode again. If it does, follow these steps to recover:
     • Interrupt the script by typing Ctrl-C in the xterm window.
     • Halt the cross disperser using the pulldown menu option HIRES Control Menu > Stop Cross-disperser Oscillation.
     • Command the cross disperser to the zeroth order position manually using the command m xdraw=-10000, using smaller increments if required.
     • Re-run the cross-disperser calibration script from the pulldown menu via Engineering > Cross-disperser calibrate.

   • If the X-disperser offset is now -1, 0, or +1, AND you have run through the script at least once already then it is OK to abort the script (by entering a and pressing Enter) instead of running through it again.

   • You will be prompted to home all HIRES stages at completion, since the crate reboot leaves all stages in a reset condition.

5. Turn Guider Power back On (NEW STEP)
   • Following the motor crate reboot(s), the HIRES Guide Camera power will have been swtiched to OFF. Switch power to ON. This can be done from the Guide Camera section of the HIRES instrument control GUI.

6. Shut down HIRES GUIs.
   • If HIRES is not going to be used by an observer immediately, close all HIRES covers in HIRES GUI → Covers → Close All.
   • Once HIRES GUI indicates all covers are closed and the lamps are off, then you may run End of Night to shut down HIRES and the GUIs. Note, if HIRES is going on sky tonight, run Shutdown ALL HIRES GUIs, instead of end-of-night.

Manual Calibration Procedure

1. Run the zero-order exposure script: xd0-uv or xd0-red (both in ~hireseng/bin). An optional argument for the script is the next frame number. The script sets up the spectrograph in 0-order CD mode (xdraw=-10000), and takes a 5 sec quartz D5 image, producing a single line of overlapping echelle orders on the CCD, nominally at row 1076. The displacement of the 0-order image from row 1076 determines the home offset of the CD, which must be applied at the .cfg file level, and reloaded on the crate by a reboot. The reboot happens automatically, while running a second script xdchange, described in step 4.
2. A second fixed offset must be applied to the echelle grating drive. This offset is a well defined number that is automatically applied in step 4., the value of which is determined by CD type and need not be measured in a separate image.
3. When the image has read out, read the Y-pixel centroid at column 1100 with kfigdisp FWHM.
4. As user kics, run the CD rehoming script xdchange. Type xdchange without argument to see the syntax (note that the text output calls it xdchange2; they are both linked to the same script.

   	makua{kics} xdchange name y-pixel xdraw
   
   	name: is red or uv
   	y-pixel: found in step 3
   	xdraw: was logged and printed on the xd0-red screen, but can
   	  be checked in the image header.  
   
   	makua{hireseng}: xdchange red 1054 -9999		for example.
   

   The user will be prompted at the beginning of the script for whether he wants to continue, since the crate will be rebooted as part of the procedure. The user will also be prompted for a comment of the day - include your initials and any relevant information for the log.
5. Run xd0-red or xd0-uv again (this will home many but not all stages). Repeat steps 3 and 4. If the change in offset is less than 2 encoder counts, do not iterate in the script, and exit as instructed (cntl-C RETURN).
6. Shut down HIRES GUIs.

Useful Files

~hireseng/bin/calibrate_cd

Script run by menu selection.

/kroot/kui/hires_sh/xd_change2/xdchange

Called by calibrate_cd to change the actual calibration number.

/kroot/data/music/log/xdchange*.log

Log file containing new zero-point values.

/vx/sparc502/ROT/hmot_crate/cfg/dc_stage.xd.home.cfg

Contains the zero-point and other configuration values for the cross-disperser.

Appendix: Sample Session

lehoula{hireseng}61: calibrate_cd
setting outdir = /s/sdata125/hireseng/xdchange/ (wait)

 Current cross-disperser type registered is:
                      xdispers = UV (cross disperser's name)

Type  for Blue-CD calibration,  for Red-CD,  to Exit, 
red

 Selection is red
setting outfile = rzero (wait)
setting todisk = false (wait)
setting lfilname = ng3 (no wait)
setting lampname = quartz (no wait)
setting deckname = D5 (no wait)
setting fil1name = clear (no wait)
setting fil2name = clear (no wait)
setting coll = red (no wait)
setting cofname = DR00mm (no wait)
setting echname = blaze (no wait)
setting slitname = opened (no wait)
setting xdname = 0-order (no wait)
setting ttime = 4 (wait)
setting pane = 
	initial x 2048
	initial y 1968
	span x 2048
	span y 160 (wait)
setting binning = 
	Xbinning 1
	Ybinning 1 (wait)
setting ampmode = SINGLE:B (wait)
setting postpix = 80 (wait)
setting lfilname = ng3 (wait)
setting lampname = quartz (wait)
setting deckname = D5 (wait)
setting fil1name = clear (wait)
setting fil2name = clear (wait)
setting coll = red (wait)
setting cofname = DR00mm (wait)
setting echname = blaze (wait)
setting slitname = opened (wait)
setting xdraw = -10000 (wait)
setting rcocover = open (no wait)
setting echcover = open (no wait)
setting xdcover = open (no wait)
setting co1cover = open (no wait)
setting co2cover = open (no wait)
setting camcover = open (no wait)
setting darkslid = open (no wait)
setting rcocover = open (wait)
setting echcover = open (wait)
setting xdcover = open (wait)
setting co1cover = open (wait)
setting co2cover = open (wait)
setting camcover = open (wait)
setting darkslid = open (wait)
 
Exposing Th-Ar+Red-CD with xdraw = -10000 encoder pulses xdangl = -4.423000 deg
 
Sat Oct  2 15:07:44 HST 2004
setting autoshut = true (wait)

setting expose = true (wait)
  Exposing                        frameno = 1                          object =  (FITS object name)...
Waiting for exposure and readout to finish....

Sat Oct  2 15:08:10 HST 2004
Sequence complete.
setting ampmode = SINGLE:B (wait)
setting ccdgain = low (wait)
setting postline = 0 (wait)
setting postpix = 80 (wait)
setting preline = 0 (wait)
setting pane = 
	initial x 0
	initial y 0
	span x 6144
	span y 4096 (wait)
setting binning = 
	Xbinning 1
	Ybinning 1 (wait)
setting outfile = hires (wait)
 Enter the position of the zero order
1177.61

 XDRAW =  -10000
 0-ORDER ROW =  1177.61

 Running xdchange red 1177.61 -10000 ...
 
 
Old cross-disperser home position:  265
Offset:                             -116
New cross-disperser home position:  149
 
Echelle home position:              0
 
 Reboot the motor crate or not?
 
 The answer is yes if:
 The value of offset (above) is greater than +1 or less than -1
                       or
 This is the first time you have seen this message
  
 The answer is no if:
 You have seen this message at least once already and the offset
 is -1, 0, or 1
 
 To reboot the motor crate just hit any key
 
 To abort hit the a key
 
(press Enter)
 
One XD HOME reference position record found in
/vx/sparc502/ROT/hmot_crate/cfg/dc_stage.xd.home.cfg.  Changing record.
 
 
One ECH HOME reference position record found in
/vx/sparc502/ROT/hmot_crate/cfg/dc_stage.ech.home.cfg.  Changing record.
 
 
Moving home config file 'dc_stage.xd.home.cfg' to 'dc_stage.xd.home.cfg.old.'
Moving new home config file to 'dc_stage.xd.home.cfg'.
 
Moving home config file 'dc_stage.ech.home.cfg' to 'dc_stage.ech.home.cfg.old.'
Moving new home config file to 'dc_stage.ech.home.cfg'.
 
Comment for cross disperser home change log file:
GDW 2004-Oct-02 installed red
 
Change data and comment saved in /kroot/data/music/log/xdchange.log.
 
setting hmotboot = 0 (wait)
XDISPERS keyword set to RED.
 
XDSIGMAI keyword set to 250.0.
 
XDDELTAD keyword set to 4.382.
 
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...
Error reading hmotboot: Can't read HIRES motor controller status: mread select timeout.
  ...Waiting for motor crate reboot to complete...

  Motor crate reboot is complete.

Type  to take another image at 0-order, or  to exit
y
Unable to format keyword value: Expected integer value for frame-number, got: 
setting outfile = rzero (wait)
setting todisk = false (wait)
setting lfilname = ng3 (no wait)
setting lampname = quartz (no wait)
setting deckname = D5 (no wait)
setting fil1name = clear (no wait)
setting fil2name = clear (no wait)
setting coll = red (no wait)
setting cofname = DR00mm (no wait)
setting echname = blaze (no wait)
setting slitname = opened (no wait)
setting xdname = 0-order (no wait)
setting ttime = 4 (wait)
setting pane = 
	initial x 2048
	initial y 1968
	span x 2048
	span y 160 (wait)
setting binning = 
	Xbinning 1
	Ybinning 1 (wait)
setting ampmode = SINGLE:B (wait)
setting postpix = 80 (wait)
setting lfilname = ng3 (wait)
setting lampname = quartz (wait)
setting deckname = D5 (wait)
setting fil1name = clear (wait)
setting fil2name = clear (wait)
setting coll = red (wait)
setting cofname = DR00mm (wait)
setting echname = blaze (wait)
setting slitname = opened (wait)
setting xdraw = -10000 (wait)
setting rcocover = open (no wait)
setting echcover = open (no wait)
setting xdcover = open (no wait)
setting co1cover = open (no wait)
setting co2cover = open (no wait)
setting camcover = open (no wait)
setting darkslid = open (no wait)
setting rcocover = open (wait)
setting echcover = open (wait)
setting xdcover = open (wait)
setting co1cover = open (wait)
setting co2cover = open (wait)
setting camcover = open (wait)
setting darkslid = open (wait)
 
Exposing Th-Ar+Red-CD with xdraw = -10000 encoder pulses xdangl = -4.423000 deg
 
Sat Oct  2 15:22:33 HST 2004
setting autoshut = true (wait)

setting expose = true (wait)
  Exposing                        frameno = 1                          object =  (FITS object name)...
Waiting for exposure and readout to finish....

Sat Oct  2 15:22:58 HST 2004
Sequence complete.
setting ampmode = SINGLE:B (wait)
setting ccdgain = low (wait)
setting postline = 0 (wait)
setting postpix = 80 (wait)
setting preline = 0 (wait)
setting pane = 
	initial x 0
	initial y 0
	span x 6144
	span y 4096 (wait)
setting binning = 
	Xbinning 1
	Ybinning 1 (wait)
setting outfile = hires (wait)
 Enter the position of the zero order
1073.77

 XDRAW =  -10000
 0-ORDER ROW =  1073.77

 Running xdchange red 1073.77 -10000 ...
 
 
Old cross-disperser home position:  149
Offset:                             1
New cross-disperser home position:  150
 
Echelle home position:              0
 
 Reboot the motor crate or not?
 
 The answer is yes if:
 The value of offset (above) is greater than +1 or less than -1
                       or
 This is the first time you have seen this message
  
 The answer is no if:
 You have seen this message at least once already and the offset
 is -1, 0, or 1
 
 To reboot the motor crate just hit any key
 
 To abort hit the a key
 
a

  Motor crate reboot is complete.

Type  to take another image at 0-order, or  to exit
e

 If the motor crate has been rebooted, some of the HIRES stages
 will be left unhomed after this procedure.

Enter  to run home_hires, or  to Exit,
y

  Homing HIRES stages and setting some to defaults:
   cafname  = nominal  slitname = opened  tvaname  = open
   tvf1name = clear    tvf2name = clear   tvfname  = 0mm
   lfilname = clear    fil1name = clear   fil2name = clear
   lampname = none     iocell   = out     hatch    = closed
Enter a  to Initiate homing, or anything else to Exit
y
setting deckcal = homed (no wait)
setting slitcal = homed (no wait)
setting fil1cal = homed (no wait)
setting fil2cal = homed (no wait)
setting cofcal = homed (no wait)
setting echcal = homed (no wait)
setting xdcal = homed (no wait)
setting cafcal = homed (no wait)
setting tvacal = homed (no wait)
setting tvfcal = homed (no wait)
setting tvf1cal = homed (no wait)
setting tvf2cal = homed (no wait)
setting lselcal = homed (no wait)
setting lfilcal = homed (no wait)
setting hatch = closed (no wait)
setting iodcell = out (no wait)
setting slitname = opened (wait)
setting lampname = none (wait)
setting lfilname = clear (wait)
setting fil1name = clear (wait)
setting fil2name = clear (wait)
setting tvaname = open (wait)
setting tvf1name = clear (wait)
setting tvf2name = clear (wait)
setting tvfname = 0mm (wait)
setting cafraw = -10 (wait)

 Note: XHIRES is inactive after the motor crate reboot.
  Kill and restart it if you are continuing HIRES operation.
  Enter  if you wish to shut down HIRES and the control software.


     Finis - sleeping 60s.... ^C if you wish.
^C