| 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 |
|