| 1 |
# @(#)long.hlp 19.1 (ESO) 02/25/03 13:45:23 |
| 2 |
#+++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 3 |
#.COPYRIGHT (C) 1993 European Southern Observatory |
| 4 |
#.IDENT long.hlp |
| 5 |
#.AUTHORS Pascal Ballester (ESO/Garching) |
| 6 |
# Cristian Levin (ESO/La Silla) |
| 7 |
#.KEYWORDS Spectroscopy, Long-Slit |
| 8 |
#.PURPOSE |
| 9 |
# This is the help file for the extended help |
| 10 |
# feature of XLong. |
| 11 |
# |
| 12 |
#.VERSION 1.0 Package Creation 17-MAR-1993 |
| 13 |
#------------------------------------------------------- |
| 14 |
# |
| 15 |
|
| 16 |
~HELP_CONTEXT |
| 17 |
This is the context Long. |
| 18 |
|
| 19 |
~HELP_HELP |
| 20 |
You can get an extended help for each button of the interface by pressing |
| 21 |
the right mouse button when the cursor is over the interface button. |
| 22 |
|
| 23 |
~HELP_TUTORIAL |
| 24 |
Not available for the moment. |
| 25 |
|
| 26 |
~HELP_VERSION |
| 27 |
This is the beta version of the new context Long. |
| 28 |
|
| 29 |
~MAIN_SEARCH |
| 30 |
Open the search lines interface. |
| 31 |
|
| 32 |
~MAIN_IDENT |
| 33 |
Open the interface that allows identification of comparison lines. |
| 34 |
The line catalogue is listed in the main window. More information is |
| 35 |
given with the individual buttons in the interface. |
| 36 |
|
| 37 |
PARAMETERS: the following parameters are required by interface: |
| 38 |
|
| 39 |
a) Line catalogue -- name of the file containing the wavelength |
| 40 |
of the comparison lines. |
| 41 |
|
| 42 |
b) Wavelength range -- select the range of wavelengths from the |
| 43 |
line table to be used in the calibration. |
| 44 |
|
| 45 |
|
| 46 |
c) Strength limit -- select the minimum intensity of the comparison |
| 47 |
lines to be used in the calibration. |
| 48 |
|
| 49 |
d) Starting line -- row number where the lines will be identified. |
| 50 |
|
| 51 |
~MAIN_CALIB |
| 52 |
Open the wavelength calibration interface. |
| 53 |
|
| 54 |
~MAIN_REBIN |
| 55 |
Open the rebinning interface. |
| 56 |
|
| 57 |
~MAIN_EXTRACT |
| 58 |
Open the spectrum extraction interface. It contains commands for fitting |
| 59 |
the sky and extracting the spectra of unresolved sources using an |
| 60 |
optimization algorithm. |
| 61 |
|
| 62 |
~MAIN_FLUX |
| 63 |
Open the flux calibration interface. |
| 64 |
|
| 65 |
~MAIN_BATCH |
| 66 |
Open the batch reduction form. |
| 67 |
|
| 68 |
~SEARCH_SEARCH |
| 69 |
Automatic search of 2-D spectra for the positions of the spectral lines. |
| 70 |
The interface offers three algorithms for determining the centroids: |
| 71 |
|
| 72 |
gravity -- Find the center of gravity of the lines. |
| 73 |
|
| 74 |
gaussian -- Fit a gaussian to the line profiles. |
| 75 |
|
| 76 |
maximum -- Use the pixel with the maximum intensity. |
| 77 |
|
| 78 |
If you click the left buitton of the mouse, the list of .bdf files appears. |
| 79 |
Click the file you want to search. The identifier of the file is displayed |
| 80 |
in the main window. |
| 81 |
|
| 82 |
PARAMETERS: the following parameters are required by search: |
| 83 |
|
| 84 |
a) Threshold -- to define the level above which lines are |
| 85 |
identified |
| 86 |
b) Width of search window -- to search and center the lines. |
| 87 |
|
| 88 |
c) Smooth Factor -- search averaging N rows above and N rows below |
| 89 |
every line (except at borders). Thus a smoothing |
| 90 |
of 2xN+1 rows is applied. |
| 91 |
d) Binning step -- |
| 92 |
|
| 93 |
~SEARCH_PLOT |
| 94 |
Plot the found lines |
| 95 |
|
| 96 |
~CALIB_CALIBRATE |
| 97 |
|
| 98 |
Determine the dispersion relation for the starting row using the |
| 99 |
identified lines (mode IDENT) or a previous session (mode GUESS) as |
| 100 |
initial guesses. |
| 101 |
|
| 102 |
The program iterates until all lines within the given tolerance are |
| 103 |
identified. The number of lines found and the final rms of the fit are |
| 104 |
given. |
| 105 |
|
| 106 |
The iterative identification of lines is controlled by the matching |
| 107 |
parameter (alpha). For each element of the table line a computed wavelength |
| 108 |
is estimated. The closest wavelength in the line catalog will be the |
| 109 |
identification candidate. The absolute difference between the computed |
| 110 |
wavelength and the candidate wavelength is the residual. The residual |
| 111 |
divided by alpha is the acceptation distance. The distance |
| 112 |
of four neighbours is taken into account (left and right in the line table |
| 113 |
and in the line catalog). The candidate is retained if the distance of |
| 114 |
the closest of the four neighbours is larger than the the acceptation |
| 115 |
distance. The optimal range for the matching parameter alpha is between |
| 116 |
0. and 0.5, which secures that the candidates will be retained only if the |
| 117 |
neighbours are at least twice further (alpha=0.5) than the residual. |
| 118 |
|
| 119 |
The maximal deviation is expressed in pixels. The iterative process |
| 120 |
aborts if the fit rms in pixels after line identification is larger than |
| 121 |
the maximal deviation. A typical value for this parameter is 10 pixels. |
| 122 |
|
| 123 |
~CALIB_EDIT |
| 124 |
Add or subtract lines from the fit. Use the "Dispersion" or "Spectrum" |
| 125 |
button to display the fit. Click "edit". Position the graphics cursor |
| 126 |
on top of the line you want to edit (eliminate or reset. In colour displays, |
| 127 |
the line symbol will turn red when eliminated and green or blue again when |
| 128 |
reset). The button "Calibrate" should be used to update the fit after |
| 129 |
editing points. |
| 130 |
|
| 131 |
~CALIB_GETCUR |
| 132 |
Read the wavelength of any feature with the graphics cursor. The values |
| 133 |
of the pixel position and the corresponding wavelength are displayed in |
| 134 |
the MIDAS window. This command is designed to be used with the |
| 135 |
"Spectrum" command. |
| 136 |
|
| 137 |
~CALIB_ALL |
| 138 |
It propagates the polynomial fits from the initial line to the whole |
| 139 |
spectrum row-by-row. |
| 140 |
|
| 141 |
~CALIB_TWICE |
| 142 |
The row-by-row calibration is done in two passes in such a way that the |
| 143 |
same set of lines is used in all rows. Thus, this option uses only the |
| 144 |
lines that have been found in all the rows of the spectrum. |
| 145 |
|
| 146 |
~CALIB_DISPER |
| 147 |
Plot delta lambda vs. lambda for all lines found. |
| 148 |
|
| 149 |
~CALIB_RESID |
| 150 |
Plot the fit residuals vs. lambda. |
| 151 |
|
| 152 |
~CALIB_SPEC |
| 153 |
Plot the spectrum labeling the lines with their table wavelengths. |
| 154 |
|
| 155 |
~CALIB_SHAPE |
| 156 |
Plot the distortion of the spectrum from a specific wavelength value. |
| 157 |
|
| 158 |
~REBIN_RBR |
| 159 |
Rebin the spectrum to wavelength. Calibration must be done before to |
| 160 |
determine the polynomial coefficients. This pulldown menu offers |
| 161 |
three options: |
| 162 |
|
| 163 |
LINEAR -- Rebins using linear interpolation. Flux is preserved. |
| 164 |
|
| 165 |
QUADRATIC -- Rebins using quadratic interpolation. Flux is preserved. |
| 166 |
|
| 167 |
SPLINE -- Rebins using spline interpolation. Flux is not preserved. |
| 168 |
|
| 169 |
After clicking the desired method LONG prompts for the file to |
| 170 |
be rebinned and the name of the output file. |
| 171 |
|
| 172 |
~REBIN_2D |
| 173 |
|
| 174 |
~REBIN_TABLE |
| 175 |
|
| 176 |
~REBIN_PLOT |
| 177 |
|
| 178 |
~EXTRACT_SKY |
| 179 |
Asks the user for the sky windows using the cursor over the display |
| 180 |
window. The coordinates are then displayed in the input form. |
| 181 |
|
| 182 |
~EXTRACT_OBJECT |
| 183 |
Asks the user for the object limits using the cursor over the display |
| 184 |
window. The coordinates are then displayed in the input form. |
| 185 |
|
| 186 |
~EXTRACT_FIT |
| 187 |
Fit a polynomial to the data in two windows along the Y-axis. |
| 188 |
Two modes can be selected: |
| 189 |
|
| 190 |
Same spatial profile -- Here it is assumed that the normalized spatial |
| 191 |
profile is the same for all columns and only one |
| 192 |
polynomial is fitted to the mean spatial profile. |
| 193 |
|
| 194 |
Independent profile -- In this case an independent polynomial is fitted |
| 195 |
for every row of the spectrum, filtering also the |
| 196 |
cosmic rays. |
| 197 |
|
| 198 |
PARAMETERS: The following parameters must be set in the input form: |
| 199 |
|
| 200 |
a) Sky limits (pixels) -- starting and ending Y coordinates of the sky |
| 201 |
windows |
| 202 |
|
| 203 |
b) Polynomial fit degree -- degree of the fit to be used. |
| 204 |
|
| 205 |
c) Radius -- used for cosmics rays rejection. |
| 206 |
|
| 207 |
~EXTRACT_AVERAGE |
| 208 |
The standard method. The sky is taken from the sky limits values of |
| 209 |
the input window. The result is summed or averaged depending on the |
| 210 |
extraction method parameter. |
| 211 |
|
| 212 |
~EXTRACT_WEIGHT |
| 213 |
Extract spectrum from CCD frame. The rows of the spectrum are |
| 214 |
added with weights which are chosen for optimal S/N-ratio of |
| 215 |
the resulting spectrum. Cosmic ray hits are removed by |
| 216 |
analyzing the profile perpendicular to the dispersion (assumed |
| 217 |
to be along the X-axis). The method is only suited for |
| 218 |
spectra of (spatially) unresolved sources. The method is very |
| 219 |
similar to the one described by Horne (1986, PASP 98, 609). |
| 220 |
|
| 221 |
PARAMETERS: The extraction algorithm uses the following parameters: |
| 222 |
|
| 223 |
a) Object limits (pixels) -- Approximate Y coordinates of the object |
| 224 |
(starting and ending). |
| 225 |
|
| 226 |
b) Extraction iterations -- Number of iterations in the extraction |
| 227 |
process. |
| 228 |
|
| 229 |
c) Read-out-noise (e-) -- Read out noise of the CCD in electrons. |
| 230 |
|
| 231 |
d) Inverse gain factor -- Conversion factor from ADU to electrons. |
| 232 |
(e-/ADU) |
| 233 |
|
| 234 |
e) Threshold for cosmic rays -- Threshold used for the rejection of |
| 235 |
cosmic ray hits. |
| 236 |
|
| 237 |
~FLUX_EXTIN |
| 238 |
Determine the extinction curve by interpolating the standard extinction |
| 239 |
tables for La Silla. This table must be in the working directory and |
| 240 |
can be copied from the MIDAS database using a button in the "utils" |
| 241 |
pulldown menu. The airmass must be given. If present, the airmass in |
| 242 |
the file header is used as default. In the present version, the airmass |
| 243 |
correction can only be applied to 1-D spectra. |
| 244 |
|
| 245 |
~FLUX_INTEGR |
| 246 |
Bin the standard star spectrum to the bands of the calibration tables |
| 247 |
and produce the calibration curve. |
| 248 |
|
| 249 |
~FLUX_FIT |
| 250 |
This command allows to fit the calibration curve depending on the |
| 251 |
fitting selected: |
| 252 |
|
| 253 |
polynomial -- the fit degree of the input form is used. |
| 254 |
|
| 255 |
spline -- Standard spline fits. The parameters of the spline must |
| 256 |
be given in the input form (smooth factor, degree). |
| 257 |
|
| 258 |
~EDIT_FLUX |
| 259 |
This command allows to edit the points generated by the integration process. |
| 260 |
|
| 261 |
~FLUX_CORRECT |
| 262 |
Calibrate the input image in flux, using the response curve generated. |
| 263 |
|
| 264 |
~FLUX_FILTER |
| 265 |
|
| 266 |
~FLUX_PFLUX |
| 267 |
Plot the flux table. |
| 268 |
|
| 269 |
~FLUX_PRESP |
| 270 |
Plot the response curve. |
| 271 |
|