Starting Kastfocus

If you're going to run IDL from the gouda console, or from a terminal hosted by gouda, start by simply typing

idl

Once in IDL simply type

kastfocus,[/hardcopy,center_line=center_line,dir=dir]

Kastfocus takes the optional keywords /hardcopy, center_line, and dir and will prompt you for all the information it needs. The program assumes that you are focusing either the red or blue side of the KAST spectrograph. If you first run kastfocus to focus the red side, you will need to run the program a second time to focus the blue side of the spectrograph, or vice versa.

Keywords

/hardcopy	Specifies that you want to print a hardcopy of the final focus fit plot. The plot will be sent to shane's printer. The plot will also be saved in the file on gouda /data/idl_tmp/kastfocus.ps until it is overwritten the next time kastfocus is run.
center_line=center_line	Specifies the center row of the 10 row region that is averaged together for identifying lines and measuring line widths. If no center_line is set, the default is to find the center row of the image and average the 10 rows around it.
dir=dir	Specifies a directory for the data files if they aren't in the default directory for the red or blue side data or scratch image directories.
Syntax Examples:	kastfocus kastfocus,/hardcopy kastfocus,center_line=100 kastfocus,center_line=40,/hardcopy kastfocus,dir='/workspace/'

To measure the width of the emission lines, kastfocus needs to know their positions. This list can be interactively generated or read from a file. The kastfocus program will prompt if you want to create a new linelist file. If you respond yes to this query, you will then be prompted for an arc lamp file name. Enter the file name of the most recent arc lamp spectrum you have taken (e.g. bscr.ccd). The program automatically identifies reasonably high signal-to-noise emission lines in the spectrum. Kastfocus will then display a line profile of each identified line and query you if you wish to accept or reject each line. It is wise to accept only well separated, unsaturated, and unblended lines to get the best focus measurement. The selected lines are written to a file on gouda, /data/idl_tmp/linelist.kast and a plot is displayed showing the selected lines (the color diamond above the line shows the state of the line in the acceptance process: red is rejected, green accepted, white is current line being examined, blue is as yet undetermined). The linelist file is overwritten each time a new linelist is created. If you wish to save the file for future reference or use, copy it to a new file name.

Arc Line Accept/Reject Plot

Using an Existing Line List

An existing line list may be used, in which case the grating and tilt (red side) or grism and x stage (blue side) must be set so that the lines match the positions (to within a few pixels) in the existing linelist.

To enter the existing linelist file, respond no to the 'Interactively create a new linelist file?' query. You will then be prompted for the linelist file name (please include the path to the file).

Measuring Focus

If you have created a new linelist, kastfocus will use the first arc lamp file as the initial focus position. If you are using an existing linelist file, you will be prompted for a file name for the first focus image. Kastfocus will measure the FWHM of each line, plot the FWHM across the spectrum, and print the median FWHM, mean FWHM, and standard deviation for the spectral lines. The program will then instruct you to move the collimator and take a new focus exposure.		FWHM Plot
You will then be prompted for the next focus image name. The same calculations will be performed on this image. This process will repeat until at least three focus positions have been measured. Then plots of FWHM (mean, median, and standard deviation) vs. collimator focus position will be displayed and a best fit parabola overlayed. A printout of the predicted best fit collimator position and FWHM will also be displayed. These parabolic fits will be updated with each additional focus position and file that is entered into kastfocus.		Focus Plot

Exiting kastfocus

To exit kastfocus, simply respond no to the 'Another focus position and file?' query.

Exiting IDL

To end an IDL session, type

exit

Helpful hints

The KAST red side collimator focus position is typically around 20000.

The KAST blue side collimator focus position is typically around 60000.

A typical move of either the red or blue side collimator for focusing is 3000 counts.