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