![]()
|
APPENDICESAPPENDIX B - ADDITIONAL S2KB INFORMATIONKPNO Telescope, Filter, and Detector Database# KPNO Telescope, Filter, and Detector Database
# Telescope data:
# Filter data:
# Detector information:
Normal Bias Image
Bad Bias Images
APPENDIX C - GETTING THE CORRECT FILTER NAMES IN YOUR HEADERS (S2KB only)
Instructions
InstructionsObservers can insert the filter names into their image headers by running the included kpfilt.cl script after they have taken their images. The steps to run it are as follows:
The kpfilt Script
# This will name the filters to things that make sense
# Brian Marsteller, Michigan State University
procedure kpfilt (input)
string input {"",prompt="Input images"}
struct *inlist
begin
string filt
string intmpfile
string imgname
# This will set things up in case your input is a list
intmpfile = mktemp ("intem")
files (input, sort=no, >> intmpfile)
inlist = intmpfile
while (fscan (inlist, imgname) !=EOF){
imgets (imgname, param="FILTERS")
filt = imgets.value
if (filt==" 100"){
# hedit imgname FILTER U ver- show+ add+
hedit (imgname, fields="FILTER", value="U", add=yes, delete=no, verify=no, update=yes)
}
if (filt==" 200"){
# hedit imgname FILTER B ver- show+ add+
hedit (imgname, fields="FILTER", value="B", add=yes, delete=no, verify=no, update=yes)
}
if (filt==" 300"){
# hedit imgname FILTER V ver- show+ add+
hedit (imgname, fields="FILTER", value="V", add=yes, delete=no, verify=no, update=yes)
}
if (filt==" 400"){
# hedit imgname FILTER R ver- show+ add+
hedit (imgname, fields="FILTER", value="R", add=yes, delete=no, verify=no, update=yes)
}
if (filt==" 500"){
# hedit imgname FILTER I ver- show+ add+
hedit (imgname, fields="FILTER", value="I", add=yes, delete=no, verify=no, update=yes)
}
if (filt==" 001"){
# hedit imgname FILTER SII ver- show+ add+
hedit (imgname, fields="FILTER", value="SII", add=yes, delete=no, verify=no, update=yes)
}
if (filt==" 002"){
# hedit imgname FILTER Ha ver- show+ add+
hedit (imgname, fields="FILTER", value="Ha", add=yes, delete=no, verify=no, update=yes)
}
if (filt==" 003"){
# hedit imgname FILTER OIII ver- show+ add+
hedit (imgname, fields="FILTER", value="OIII", add=yes, delete=no, verify=no, update=yes)
}
}
inlist=""
delete(intmpfile)
end
APPENDIX D - MORE ON THE LINUX GUIDER
Guider Control GUI
The Guider control graphical user interface is started from the 'Guider GUI' icon on the desktop. The information fields X, Total Count, FWHM, X Ref, Y, Max Value, Background, Y Ref, RMS X, and RMS Y contain status information which updates either when the guider is ON, or when it is calculate only mode. X and Y These values are the current guider box center positions in integer pixel coordinates. Total Count The total count is the number of counts summed over all pixels in the guider box. It provides a relative indicator of signal strength. FWHM The FWHM is the full-width-half-max of the guider star image and can be used as a rough indication of guide signal quality. The value is in arcseconds. Max Value This is the maximum pixel value inside the guide box. As the digitization is 8-bit, the maximum possible value is 255, which represents signal saturation. If the signal is constantly above 240, then turn down the controller gain. Expect to see this number fluctuate; if it seems to be pegged you may be saturating even if the value is not 255. Background The background is an estimate of the sky background. It is calculated using the pixels around the perimeter of the guide box. If the background is high (>50), then increasing the guide box size is recommended. X Ref and Y Ref The X and Y Ref values are the measured centroid deviations. These are in units of arcseconds and provide an indication of the amount of correction the guider is making. The actual corrections applied are somewhat smoothed (see Guide AV and Gain). RMS X aND RMS Y The RMS values show the root-mean-square values of the last "n" centroid measurements. The value of n is shown. To reset n to zero, select a guiding mode using the "Mode" menu. The default mode is "Intensity Centroid". Interactive Fields The interactive fields Leaky AV, Guide AV, Box Size, Increment, Gain, VContrast and VBright, are fields which can be changed by the arrow buttons to their right. Leaky AV This value is the amount of "Leak". The units are "number of frames". For example, selecting a value of 3 will use a running average of 3 frames. This helps to reduce background noise and bring out fainter objects. Values above about 5 are unlikely to be used except during acquisition of very faint targets. Guide AV The Guide AV value controls the number of guide star centroid measurements to average, BEFORE sending a guide correction to the TCS. This does not change the appearance of the video picture but it does change the frequency of pointing correction. The default value is 10; larger numbers may be useful to avoid over-correction if there is a lot of image motion. Values of less than 10 are NOT recommended as the TCS may have problems accepting corrections at this rate. Box Size This value controls the size of the guide box (in pixels). It needs to be an odd number of pixels, so it will only change by 2 pixels at a time up or down. The ideal size for the guide box will provide a few pixels of "sky" between the guide star and each box edge. Increment This value controls the step size (2, 10, or 100 pixels) by which the guide box can be moved around the screen. When the guider gui window is selected, the "arrow" cursor keys have the effect of moving the guide box inside the subraster box. To move both boxes together, hold down the "shift" key while pressing the arrow keys. Be sure not to hold down the arrow key - this is known to crash the program. Manual control of the guide box will not usually be needed because the box will "warp" to the guide star automatically in most circumstances. Gain The Gain parameter is an interactive value which controls how much of the guiding correction actually gets sent to the TCS (default 0.8). For example, a gain of 0.5 means that if the measured error is 1.0 arcseconds, then the guider would send a correction of only 0.5 arcseconds. Setting the Gain low and the Guide AV low can give excellent results in good seeing. The Gain will normally be set between 0.4 and 1.0 in normal operation. The "Guider" menu has an autotune option which attempts to determine the best settings for the "Gain" and "Guide AV" parameters for you. NOTE: autotune is only going to work when the seeing is good. Log file name field This entry field issued to alter the log file. Enter a new log file name (including the directory path) and press RETURN to activate it. Status line The bottom of the window contains the status fields, which are:
Guide control (menu) options The major operations are controlled via menu selections. The menus available are: ![]() Display guider Guider On Switch guiding on. Calculate Only This mode of operation does all the calculations identically to normal guiding mode, but never sends any corrections to the TCS. Guider Off Switch guider off. Guider Lock Defines the precise position at which to guide. Normally, guiding occurs at the center of the guide box: selecting guider lock will make the guider attempt to keep the guide star at its CURRENT location (at the moment you select this option) within the guide box. The guider-lock status is independent of guider on/off, and may be used while guiding is on or off. If you select guider lock, then move the telescope and switch guiding on, it will guide back to the precise position when guider-lock was selected. The guider-lock position is zeroed by a "Warp to star" operation. See also Locks menu below. Warp to star Locates the brightest guide star in the field, and centers the guide box on it. This option may be used while guiding is on or off. Note that the guider cannot use stars too close to the edge, defined to be such that the subraster would overlap the full video field. The guide box will not move if the brightest star in the field is unavailable: you will need to move the guide box manually to another star in the field. Calibrate guider The guider has information about the instrument and telescope focus, and will automatically adopt the appropriate pixel scale. This option is not used at the 0.9m. Autotune guider This option automatically adjusts the guider parameters (Guide AV and Gain) through a set of possible values. At each setting the RMS behavior of the guiding offsets is calculated. The best combination of parameters is then presented to the operator for confirmation. This option will only be worthwhile in good to excellent seeing. Measure background/Subtract background These options are used together to improve the guider performance when the sky background is high or the guide star is faint (ie. in low contrast situations). It can also remove detector gradients or other camera pattern noise. First, move the guide star, and any other visible stars, out of the field and click "Measure background". After approximately 20 seconds the average background will have been measured. Click on the "Subtract background" option and the screen should go almost black. Now move back to your guide star. The guider algorithm defines loss of signal depending on how much brighter the guide star is than the background. Background subtraction forces the background to almost zero, and thus lets you guide in extreme conditions. Snap image Save a FITS format copy of the full 640x480 video field to disk. Images are saved in files called frame_XXXXX.dat, where the running number is simply incremented on each save operation. Save 512 subimages to disk Save a sequence of 512 FITS format snaps of the 65x65 subraster of the video field to disk. Images are saved in files called sampleXXX_yyy.dat, where the running number XXX is incremented on each save operation, and the number yyy runs from 000 to 511. Guide image quality monitor on/off This option is used to gain a quick look at the instantaneous image quality of the guide star. It may be useful for fine focusing and determining if the seeing has suddenly changed (better or worse), or is stable or variable. This puts up a continuous sequence of subraster field across the video image (NOTE: this does not interfere with guiding and only changes the display). This option can be used when guiding is on or off. Field scale options These options allow you to select the appropriate telescope focal ration. There is only one focal ratio used at the 0.9m (f/8), which is automatically selected on startup so this should never need to be changed. Quit Quit the guider GUI. NOTE: this does not turn off guiding, it only shuts down the guider program. Guiding will continue until manually turned off.
Define lock position X Set up any of four available lock positions at the current centroided star location. Goto lock position X Move the guider box to the lock position Clear lock positions Undefine all lock positions. Note that the guider still knows where they are and you can still move to them, but you will not be able to save them. This option was more important in earlier versions of the guider software. Save/Load lock positions Save or load the current lock positions to or from a disk file. A dialog box will prompt you for a filename.
A set of up to 4095 markers may be created and optionally saved and restored to and from disk files. The current marker is always indicated by extended vertical features. Once a new marker is created it automatically becomes the current marker. To cycle through a set of markers use the ALT-+ key combination. The cursor must be in the GUI window for this and the following key combinations to work. CAUTION: Please switch guiding OFF before cycling between markers. To move the current marker (one pixel at a time) hold down the ALT key and press an arrow key. To delete the current marker, hold down the ALT key and press the Del key. Add marker at current box center Adds a new marker at the center of the guide box. Add marker at guider center Adds a new marker at the center of the screen (i.e. x=320,y=240). Clear markers Delete all markers Save/Load markers Save or load the marker positions to or from a file. A dialog box will prompt you for a filename. These files are on the guider computer and are not generally accessible except from these menu options.
Panoramic Mode This option selects full screen mode digitization. Depending upon available CPU this mode will run at approximately 8 frames per second. Subraster Mode This option selects Subraster mode digitization. A full video frame rate of 30Hz is possible with this mode. CAUTION: only the area inside the larger box on the screen in updated when in subraster mode. This is the default mode when guiding. Intensity centroid Selects a simple intensity centroid calculation. In practice this method seems to work as well as any, and is the most robust with noisy signals. Moment centroid Uses a very simple "moment" calculation. May be of some use in very poor signal conditions. Shectman centroid The classic Shectman centroiding algorithm. Quadrant centroid A simple quadrant centroid calculation. May be useful for very low signal conditions. Gaussian centroid A full gaussian parameter fit with centroid calculation. The extra processing is only worthwhile when a very good guide signal is available. Guide/Subraster Box
Console Diagnostics and engineering window which allows low level access to the guider functions. DO NOT USE THIS unless you are the responsible programmer! History graphs The history graphs window contains the following six historical data plots, which can be used to evaluate the efficacy of the guiding. X correction: the guide correction in arcseconds in the X axis Y correction: the guide correction in arcseconds in the Y axis Total Count: the summed signal inside the guide box FWHM: the full-width-half-max in arcseconds X data: the guide star signal summed by column (ie an X slice) Y data: the guide star signal summed by row (ie a Y slice) HELP The help menu contains only one item, "About TV Guider", and no useful help information.
APPENDIX E - UNIX CHEAT SHEETCommon UNIX commands
Useful web page: http://www.nmt.edu/tcc/help/unix/unix_cmd.html APPENDIX F - IRAF CHEAT SHEETCommon IRAF commands
Useful web page: http://www.noao.edu/kpno/manuals/ice/node20.html APPENDIX G - USING SFTPWhy use sftp instead of ftp?
How does one use sftp? Using sftp is similar to, but not identical to using ftp. Here is a sample session:
Comments: "36inch" is the userid, and "taupe.kpno.noao.edu" is the address. After the password is typed in correctly, you get the "sftp>" prompt. A simple "put" (not "mput") will transfer all the files indicated by the wildcard character; in this case, the four test files shown. Additional info can be found from "man sftp", e.g. on taupe. APPENDIX H - EMACS CHEAT SHEETCommon Emacs keystrokes
Useful web page: http://www.stanford.edu/group/dcg/leland-docs/emacs.html APPENDIX I - VI CHEATSHEET
Useful web page: http:/ /www.uic.edu/depts/accc/software/unixgeneral/vi101.html#startvi APPENDIX J - A REFERENCE GUIDE FOR TAKING SKY FLATSThe following describes a method that provides useful twilight sky flats at the 0.9m telescope using either the MOSAIC or S2KB setups. Philosophy: If you want to use twilight sky flats (instead of dome flats) to correct for pixel-to-pixel sensitivity variations, then you need at least 5 well-exposed sky flats in each filter each night. If you want to use twilight sky flats in conjunction with dome flats to do an illumination correction (twilight flats will be smoothed), then you need at least 3 flats per filter approximately every other night. The following describes how to obtain 5 twilight sky flats in each filter. The aim is to expose the CCD to between 1/3 and 2/3 of the full well. If the level is not optimum, adjust the exposure times appropriately.
APPENDIX K - DEWAR FILLING TIPS AND TRICKSFilling a dewar can be tricky, but once you've figured out the right techinque it will become second nature. Below are a few pointers to help you make sure the dewar has gotten a good fill. Note: NEVER USE A WRENCH TO TIGHTEN OR REMOVE THE LIQUID NITROGEN LINE FROM THE DEWAR.
APPENDIX L - TAKING A SEEING MEASUREMENTWe are seeking to track the seeing quality of the 0.9m telescope. As such, we would like each observer to measure the seeing toward the end of the night using the following procedure.
*Note that having the dome vents open and the telescope exhaust fan on (weather permitting) helps to improve the seeing.
Last updated February 3, 2008 |