Debian Codegraph @

gui/XEchelle/incl/help.h

raw
1 # @(#)help.h 19.1 (ESO-IPG) 02/25/03 13:45:25
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 GUI XEchelle for reduction of Echelle spectra. The
18 context requires auxiliary calibration tables. Auxiliary data include
19 catalogues with comparison lines and tables with the fluxes of some
20 standard stars.
21
22 The area MID_ARC contains the following calibration catalogues,
23 thar.tbl, Thorium-Argon catalogue (for CASPEC, ECHELLEC, EMMI).
24 hear.tbl, Helium-Argon catalogue (for EFOSC).
25 as well as Th-Ar tables selected for blends at spectral resolutions
26 25000, 33000, 50000, 100000, respectively named thar25.tbl, thar50.tbl,
27 thar50.tbl, thar100.tbl (these tables have been prepared by H.Hensberge,
28 M.David and W.Verschueren from Antwerp University).
29
30 Standard stars for flux calibration are available in the area
31 MID_STANDARD. Additional tables of southern spectrophotometric
32 standards are available in /midas/calib/data/spec/ctio (Hamuy & al.,
33 1992, PASP, 104 533-552 and Hamuy & al., 1994, PASP 106
34 566-589) and midas/calib/data/datatrans/hststd (HST Standards).
35
36 These tables are distributed
37 on request in complement to the Midas releases. These tables are
38 also available on anonymous ftp at the host ftphost.hq.eso.org
39 (IP number 134.171.40.2). The files to be retrieved are located
40 in the directory /midaspub/calib and are named README.calib and
41 calib.tar.Z. Command SHOW/TABLE can be used to visualize the
42 column name and physical units of the tables. Demonstration
43 data required to execute the tutorial
44 procedure TUTORIAL/ECHELLE are also located on this ftp
45 server in the directory /midaspub/demo as echelle.tar.Z. FTP access
46 is also provided on the World Wide Web URL:
47
48 http://http.hq.eso.org/midas-info/midas.html
49
50 The calibration directory contains other information
51 such as characteristic curves for ESO filters and CCD detectors, which
52 can be visualized with the Graphical User Interface XFilter
53 (command CREATE/GUI FILTER).
54 in the directory /midaspub/demo as echelle.tar.Z.
55 ~HELP_HELP
56 You can get an extended help in each panel of the interface by pressing
57 the HELP button.
58
59 ~HELP_TUTORIAL
60 A tutorial demonstrating a standard echelle reduction session
61 is provided by the command TUTORIAL/ECHELLE. The tutorial requires
62 demonstration tables, provided on the ftp server:
63
64 ftphost.hq.eso.org (IP number 134.171.40.2).
65
66 in the directory /midaspub/demo as echelle.tar.Z.
67
68 ~HELP_VERSION
69 This is the 95NOV version of the context Echelle. This context
70 supports world coordinate calibrations. The 94NOV version of the
71 can be accessed with SET/CONTEXT echellec command (however this GUI
72 supports only 95NOV version).
73
74 ~MAIN_SEARCH
75 Open the search lines interface.
76
77 ~MAIN_IDENT
78 Open the interface that allows identification of comparison lines.
79 The line catalogue is listed in the main window. More information is
80 given with the individual buttons in the interface.
81
82 PARAMETERS: the following parameters are required by interface:
83
84 a) Line catalogue -- name of the file containing the wavelength
85 of the comparison lines.
86
87 b) Wavelength range -- select the range of wavelengths from the
88 line table to be used in the calibration.
89
90
91 c) Strength limit -- select the minimum intensity of the comparison
92 lines to be used in the calibration.
93
94 d) Starting line -- row number where the lines will be identified.
95
96 ~MAIN_CALIB
97 Open the wavelength calibration interface.
98
99 ~MAIN_REBIN
100 Open the rebinning interface.
101
102 ~MAIN_EXTRACT
103 Open the spectrum extraction interface. It contains commands for fitting
104 the sky and extracting the spectra of unresolved sources using an
105 optimization algorithm.
106
107 ~MAIN_FLUX
108 Open the flux calibration interface.
109
110 ~MAIN_BATCH
111 Open the batch reduction form.
112
113 ~SEARCH_SEARCH
114 Automatic search of 2-D spectra for the positions of the spectral lines.
115 The interface offers three algorithms for determining the centroids:
116
117 gravity -- Find the center of gravity of the lines.
118
119 gaussian -- Fit a gaussian to the line profiles.
120
121 maximum -- Use the pixel with the maximum intensity.
122
123 If you click the left buitton of the mouse, the list of .bdf files appears.
124 Click the file you want to search. The identifier of the file is displayed
125 in the main window.
126
127 PARAMETERS: the following parameters are required by search:
128
129 a) Threshold -- to define the level above which lines are
130 identified
131 b) Width of search window -- to search and center the lines.
132
133 c) Smooth Factor -- search averaging N rows above and N rows below
134 every line (except at borders). Thus a smoothing
135 of 2xN+1 rows is applied.
136 d) Binning step --
137
138 ~SEARCH_PLOT
139 Plot the found lines
140
141 ~CALIB_CALIBRATE
142
143 Determine the dispersion relation for the starting row using the
144 identified lines (mode IDENT) or a previous session (mode GUESS) as
145 initial guesses.
146
147 The program iterates until all lines within the given tolerance are
148 identified. The number of lines found and the final rms of the fit are
149 given.
150
151 The iterative identification of lines is controlled by the matching
152 parameter (alpha). For each element of the table line a computed wavelength
153 is estimated. The closest wavelength in the line catalog will be the
154 identification candidate. The absolute difference between the computed
155 wavelength and the candidate wavelength is the residual. The residual
156 divided by alpha is the acceptation distance. The distance
157 of four neighbours is taken into account (left and right in the line table
158 and in the line catalog). The candidate is retained if the distance of
159 the closest of the four neighbours is larger than the the acceptation
160 distance. The optimal range for the matching parameter alpha is between
161 0. and 0.5, which secures that the candidates will be retained only if the
162 neighbours are at least twice further (alpha=0.5) than the residual.
163
164 The maximal deviation is expressed in pixels. The iterative process
165 aborts if the fit rms in pixels after line identification is larger than
166 the maximal deviation. A typical value for this parameter is 10 pixels.
167
168 ~CALIB_EDIT
169 Add or subtract lines from the fit. Use the "Dispersion" or "Spectrum"
170 button to display the fit. Click "edit". Position the graphics cursor
171 on top of the line you want to edit (eliminate or reset. In colour displays,
172 the line symbol will turn red when eliminated and green or blue again when
173 reset). The button "Calibrate" should be used to update the fit after
174 editing points.
175
176 ~CALIB_GETCUR
177 Read the wavelength of any feature with the graphics cursor. The values
178 of the pixel position and the corresponding wavelength are displayed in
179 the MIDAS window. This command is designed to be used with the
180 "Spectrum" command.
181
182 ~CALIB_ALL
183 It propagates the polynomial fits from the initial line to the whole
184 spectrum row-by-row.
185
186 ~CALIB_TWICE
187 The row-by-row calibration is done in two passes in such a way that the
188 same set of lines is used in all rows. Thus, this option uses only the
189 lines that have been found in all the rows of the spectrum.
190
191 ~CALIB_DISPER
192 Plot delta lambda vs. lambda for all lines found.
193
194 ~CALIB_RESID
195 Plot the fit residuals vs. lambda.
196
197 ~CALIB_SPEC
198 Plot the spectrum labeling the lines with their table wavelengths.
199
200 ~CALIB_SHAPE
201 Plot the distortion of the spectrum from a specific wavelength value.
202
203 ~REBIN_RBR
204 Rebin the spectrum to wavelength. Calibration must be done before to
205 determine the polynomial coefficients. This pulldown menu offers
206 three options:
207
208 LINEAR -- Rebins using linear interpolation. Flux is preserved.
209
210 QUADRATIC -- Rebins using quadratic interpolation. Flux is preserved.
211
212 SPLINE -- Rebins using spline interpolation. Flux is not preserved.
213
214 After clicking the desired method LONG prompts for the file to
215 be rebinned and the name of the output file.
216
217 ~REBIN_2D
218
219 ~REBIN_TABLE
220
221 ~REBIN_PLOT
222
223 ~EXTRACT_SKY
224 Asks the user for the sky windows using the cursor over the display
225 window. The coordinates are then displayed in the input form.
226
227 ~EXTRACT_OBJECT
228 Asks the user for the object limits using the cursor over the display
229 window. The coordinates are then displayed in the input form.
230
231 ~EXTRACT_FIT
232 Fit a polynomial to the data in two windows along the Y-axis.
233 Two modes can be selected:
234
235 Same spatial profile -- Here it is assumed that the normalized spatial
236 profile is the same for all columns and only one
237 polynomial is fitted to the mean spatial profile.
238
239 Independent profile -- In this case an independent polynomial is fitted
240 for every row of the spectrum, filtering also the
241 cosmic rays.
242
243 PARAMETERS: The following parameters must be set in the input form:
244
245 a) Sky limits (pixels) -- starting and ending Y coordinates of the sky
246 windows
247
248 b) Polynomial fit degree -- degree of the fit to be used.
249
250 c) Radius -- used for cosmics rays rejection.
251
252 ~EXTRACT_AVERAGE
253 The standard method. The sky is taken from the sky limits values of
254 the input window. The result is summed or averaged depending on the
255 extraction method parameter.
256
257 ~EXTRACT_WEIGHT
258 Extract spectrum from CCD frame. The rows of the spectrum are
259 added with weights which are chosen for optimal S/N-ratio of
260 the resulting spectrum. Cosmic ray hits are removed by
261 analyzing the profile perpendicular to the dispersion (assumed
262 to be along the X-axis). The method is only suited for
263 spectra of (spatially) unresolved sources. The method is very
264 similar to the one described by Horne (1986, PASP 98, 609).
265
266 PARAMETERS: The extraction algorithm uses the following parameters:
267
268 a) Object limits (pixels) -- Approximate Y coordinates of the object
269 (starting and ending).
270
271 b) Extraction iterations -- Number of iterations in the extraction
272 process.
273
274 c) Read-out-noise (e-) -- Read out noise of the CCD in electrons.
275
276 d) Inverse gain factor -- Conversion factor from ADU to electrons.
277 (e-/ADU)
278
279 e) Threshold for cosmic rays -- Threshold used for the rejection of
280 cosmic ray hits.
281
282 ~FLUX_EXTIN
283 Determine the extinction curve by interpolating the standard extinction
284 tables for La Silla. This table must be in the working directory and
285 can be copied from the MIDAS database using a button in the "utils"
286 pulldown menu. The airmass must be given. If present, the airmass in
287 the file header is used as default. In the present version, the airmass
288 correction can only be applied to 1-D spectra.
289
290 ~FLUX_INTEGR
291 Bin the standard star spectrum to the bands of the calibration tables
292 and produce the calibration curve.
293
294 ~FLUX_FIT
295 This command allows to fit the calibration curve depending on the
296 fitting selected:
297
298 polynomial -- the fit degree of the input form is used.
299
300 spline -- Standard spline fits. The parameters of the spline must
301 be given in the input form (smooth factor, degree).
302
303 ~EDIT_FLUX
304 This command allows to edit the points generated by the integration process.
305
306 ~FLUX_CORRECT
307 Calibrate the input image in flux, using the response curve generated.
308
309 ~FLUX_FILTER
310
311 ~FLUX_PFLUX
312 Plot the flux table.
313
314 ~FLUX_PRESP
315 Plot the response curve.
316