Debian Codegraph @

gui/XAlice/help/alice.hlp

raw
1 # @(#)alice.hlp 19.1 (ESO) 02/25/03 13:43:05
2
3 ~CONTEXT
4 This context allow interactive manipulation of spectral data.
5
6 Flux integration, rebinning, filtering and fitting are some facilites
7 that you can see here.
8
9
10 When you load a 2D spectrum ( or a many rows mean 2D spectrum) this
11 will be plotted on a small control window and on a MIDAS graphic window.
12 A graphical tool set is given for each window.
13
14 The selected spectrum area is plotted on the MIDAS graphic window and
15 showed on the small control window.
16
17 There are three temporary files that store some information :
18
19 TMPalice.tbl : integration output (Midas table format).
20 TMPalice.stat : multi-gaussian fitting statistics (Ascii file).
21 TMPalice.prg : "Label / Cursor" output (Ascii file).
22
23 These files can be saved using the "Save TMP files" option from the
24 "Utils" top menu.
25
26
27 Top menu description
28 --------------------
29
30 File --- Open : read an image ( .bdf), the line number is assigned
31 in the main form.
32 Save As : name for the output spectrum ( .bdf)
33 Save : save the current spectrum with the previous given
34 name in the "Save As" option.
35
36 Frame -- Cut X : change the x limits in the MIDAS graphic window. You
37 must use the left button cursor twice. Exit with
38 any other button.
39 Cut Y : like "Cut X" but for y limits.
40 Unzoom : Return to original cuts ( from the small control window).
41 Redraw : redraw the current selected spectrum area.
42
43 Continuum- Begin : define the continuum. Use the graphics cursor to mark
44 the regions of the spectrum where the continuum will be
45 defined. You may define as many regions as you want.
46 Pairs of positions are required. Click at the beginning
47 and end of each pair. A magenta arrow should appear at the
48 continuum level where the cursor was set. Exit with the
49 middle mouse button. The continuum fit will be drawn.
50 Add : add more points to the continuum definition. Use the
51 cursor as in the case of "begin". Notice that begin erases
52 any previous definitions.
53 Plot : plot the fit. Useful if the fit degree is changed.
54 Fit : Load the new Y values from the spectrum and draw the new
55 continuum fit.
56
57
58 Filter - Smooth : apply the mean filter over the current spectrum
59 using the defined window size in the "Window :" field.
60 Median : like smooth but with a median filter.
61
62 Label -- Label Axis : change the default axis labels.
63
64 Label / Cursor : put any string on the graphic window. You
65 can select font, angle and size and then use the cursor
66 for fix it. Select the position with the first button
67 and confirm with the second one.
68 Load label file : load a previous saved file (TMPalice.prg).
69 Clear labels : clear all the labels from the MIDAS graphic window
70
71 Utils -- Get Cursor : get the x and y values from the graphic window.
72 Save TMP files : save the Alice temporary files .
73
74 Option - Plote Mode : change the spectrum plot mode. Currently there are
75 two modes : straight line and like-histogram.
76
77 Help --- On Context : this message.
78 On Help : how use the help.
79
80 Quit --- Bye : exit alice without confirmation !!
81
82 ~HELP
83 You can get an extended help for each button of the interface by pressing
84 the right mouse button when the cursor is over the interface button.
85
86 ~GAUSS
87 Open the multi-gaussian fitting interface.
88
89 ~REBIN
90 Open the interface for the spectrum rebinning
91
92
93 ~INTEGRATE
94 This button allows to integrate the flux of a spectral feature above or
95 below the continuum. A gaussian fit is performed to determine the
96 wavelength of the feature. The wings of the feature must be defined
97 by clicking with the graphics cursor at both sides of the line.
98 A "arrow" should appear at the positions selected. Exit with the middle
99 mouse button. The gaussian fit will be plotted and the line parameters
100 displayed in the MIDAS window as follows:
101
102 CENTER : position of the line determined by the gaussian fit.
103 FWHM : also determined from gaussian fit.
104 Flux : total flux of the line determined adding the pixels. The
105 gaussian fit is not used for this parameter.
106 Contin : flux of the continuum at the position of the line centre.
107 EQWT : equivalent width of the feature (negative for abs. lines).
108 Error : estimate of the error in the line flux determined based on the
109 rms of the continuum fit and the equivalent width of the line.
110 The estimate is valid only if t e photon counting errors are much
111 larger than the readout noise.
112
113 The line parameters are stored in a MIDAS table file called TMPalice.tbl.
114 If the file exists, the measurements will be appended at the end of the file.
115 Notice that the file will be erased when you exit from SPECTRA.
116
117 ~CUTX
118 Cut the spectrum displayed in the main window in the x direction, displaying
119 the result in the Midas graphic window. The middle button finishes the process.
120
121 ~CUTY
122 Cut the spectrum displayed in the main window in the y direction, displaying
123 the result in the Midas graphic window. The middle button finishes the process.
124
125 ~MOVE
126 Move the current box over the spectrum displayed in the main windo, displaying
127 the result in the Midas graphic window. The middle but ton finishes the process.
128
129 ~UNZOOM
130 The current box covers the whole spectrum.
131
132 ~CLEAR
133 Clear the "Initial guess" and "Fit values" field.
134
135 ~EXECUTE
136 Execute the multi-gaussian fitting using the number of components given.
137
138 If there are no enough initial guesses, these must be given with the
139 graphical cursor (3 for each gaussian component):
140
141 The first and second clicks are used as fwhm input ( only x values) .
142 The third click will provide the central x value and the amplitude
143 ( y value over the continuum).
144
145 You must use the left button to enter the coordinates. Any other button
146 exit.