Debian Codegraph @

gui/XLong/help/long.hlp

raw
1 # @(#)long.hlp 19.1 (ESO) 02/25/03 13:47:51
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