Invoking GMEPlot without including a menufile on the command line brings up the unfilled User Interface GUI menu.
Runs the application after the menu options have been filled in.
Quit the application
If you want to read in a previously saved menu, enter the file name the menu options were saved to into the provided box and then click the Read button to the right. This will read file and fill in the menu options with the values found in the file. Hit a return in the menu entry box after you have typed in the file name to echo it down into the Save Menu box.
If you want to save the entered menu options to a file, enter the file name in the provided box and then click the Save button to the right. This will save all option settings into that file. The Save operation works on both complete and incomplete menu definitions. Using the same save and read file names will update the read file. If you wish to make changes to the menu but not loose the original menu options the save file name must be different than the read file name.
A set of two options defining the color scheme. The first option allows the selection of a color table to load. There are a number of color tables which are selectable by clicking on the option bar.
The second option defines the background color of the plot. This is either white or black. The option toggles between the two states each time it is clicked.
A set of three options defining the color mapping used to display an He+ density map derived from the inversion of EUV images. If no He+ inversion data is being displayed then the option settings are ignored in the program.
The first two options define the minimum and maximum color mapped values. Values below the minimum value are mapped to the plot background color as set above (either white or black) and values above the maximum value are mapped to the color of the maximum value. The third option sets the scaling to use in the mapping. This can either be LINEAR or LOGARITHMIC.An identical set of options to those described above under the He+ Color Scale options above but these define the color mapping used when displaying the ion differential energy flux plots derived from the inversion of MENA and HENA neutral atom images. If no neutral atom inversion data is being displayed then the option settings are ignored in the program.
This option determines where to output the colorbar with respect to the matrix of image plots. The three options are described below:
| OPTION | DESCRIPTION |
|---|---|
| VERTICAL | The color bar is output to the right of the image plot matrix. |
| RHOZONTAL | The color bar is output below the image plot matrix with the maximum value to the right. |
| LHOZONTAL | The color bar is output below the image plot matrix with the maximum value to the left. |
The mapping plots are output in SM coordinates, centered on the Earth (0,0). They run from either (-X,-Y) to (+X,+Y) or vice-versa with X = Y. This option sets the plot limits in Re. A negative value will put (-X,-Y) in the lower left-hand corner of the plot (sun to the right) while a positive value will put (+X,+Y) in the lower left-hand corner of the plot (sun to the left).
This is the directory containing the EUV inversion data being output. If no EUV data is to be output the program will ignore this entry. The entry may begin with an environment variable. For example if the inversion files are in your home directory under the directory EUVSimFiles then you could specify the directory as $HOME/EUVSimFiles.
Same as the above but for the MENA inversion files.
Same as the above but for the HENA inversion files.
The name of the EUV inversion file to be plotted less the file extension which the program expects to be .sim. If there is no EUV inversion to be output then this menu entry is unused by the program.
This is the base file name for the 4 MENA inversion files produced from the MENA images taken within a specified time interval. There is one file per each of the 4 MENA energy bands. The base file name can be anything. Each inversion file is created by appending E#.inv to the base name where # runs from 0 to 3. E0 should be the inversion associated with the lowest energy and E3 the inversion associated with the highest.
This is the base file name for the 6 HENA inversion files produced from the HENA images taken within a specified time interval. There is one file per each of the 6 HENA energy bands. The base file name can be anything. Each inversion file is created by appending E#.inv to the base name where # runs from 0 to 5. E0 should be the inversion associated with the lowest energy and E5 the inversion associated with the highest.
When a spectrum has been fit according to one of the available algorithms this option determines if the fit is to be output together with the spectra.
The agorithm to use when fitting spectra. There are three algorithms to chose from. These are described below.
| FIT TYPE | DESCRIPTION |
|---|---|
| 2 MAXWELLIANS (Linear) |
Fits the MENA and HENA portions of the spectra independently to
a Maxwellian distribution and then merges the two fits. The fits
are done using a linear least-squares algorithm to the function:
log(dF) = log(A) - E / T
where dF is the distribution function value, E is the energy, T is
the temperate and A is the density times the normalization coefficient:
A = N · [(m/(2&pi kT/m)]3/2
|
| 2 MAXWELLIANS (NLinear) |
Fits the spectra independently using the Levenberg-Marquardt
nonlinear least-squares method. The function being fit is:
dF = A1e-E/T1 + A2e-E/T2
where dF is the value of the distribution function, E is the energy,
Ti are the temperatures, and Ai are the function
normalizations times the densities:
Ai = Ni · [(m/(2&pi kTi/m)]3/2
|
| KAPPA |
Fits the spectra independently using the Levenberg-Marquardt
nonlinear least-squares method. The function being fit is:
dF = A · [1 + E/(&kappa E0)]-(&kappa + 1)
where dF is the value of the distribution function, E is the energy,
E0 is the characteristic energy and A is the normalization
constant times the density:
A = N · [m /(2&pi &kappa E0)]3/2 · &Gamma (&kappa + 1)/&Gamma (&kappa - 0.5)
For a kappa function the temperature is given by:
T = 2&kappa E0/(2&kappa - 3)
It should be noted that a kappa function will sometimes will yield
unphysical temperatures (negative values) for a spectrum even though
the fit looks good. This is the result of a low &kappa value.
|
This set of three options describes how moments are to be derived from output spectra. The first option determines the method used to obtain the moments. The options are discussed below.
| MOMENT METHOD | DESCRIPTION |
|---|---|
| FROM FITS | The moments are determined directly from the fits to the distribution. using the coefficients determines in the above fits. |
| INTEGRATED | The moments are derived by a direct integration of the spectra. The distributions are assumed to be isotropic so that integrals over Phi and Theta reduce to 4&pi and only odd integrals over velocity result in non-zero solutions. |
The next two options only have meaning if the computation method is set to INTEGRATED. The first of these options indicates if the moments are to be computed individually for the HENA and MENA portions of the spectra (SPLIT) or if one set of moments are to be produced for the entire spectra (FULL). Moments derived from fits are out either at SPLIT or FULL depending on the fit algorithm.
The second option in the pair indicates whether to compute the moments using the defined energy band widths (WIDTHS) of the individual data points in the spectra or by using the band center energies (CENTERS). Fits using the band widths are computed as:
One word of caution. When performing a FULL integration the lowest energy HENA inversion step should be omitted from the interation (see the Data Omissions option below). This energy step is fully overlaped by the MENA enegy steps. Including it will cause erronous results.
Any of the MENA and/or HENA energy steps can be excluded from either or both the spectra plot and the spectra fits and moment integrations. The avialable omission options are defined below. Any actual indentification of the omitted energy steps are made in the next two menu entries.
| OPTION | DESCRIPTION |
|---|---|
| NONE | All data is used in both the spectra plots and the fits and integration routines. |
| PLOTS | Energy steps designated under the MENA and HENA omits menu options are not included in the spectra plots but are included in the spectra fit and moment integration routines. |
| FITS | Energy steps designated under the MENA and HENA omits menu options are not included in the spectra fit and moment integation routines but are included in the spectra plots. |
| PLOTS AND FITS | Energy steps designated under the MENA and HENA omits menu options are not included in either the spectra plots or the spectra fit and moment integration routines. |
This is a space separated list of the MENA energy steps to be omitted from the analysis rouintes listed under the Data Omission menu option. The MENA energy steps run from 0 through 3 with 0 being the lowest energy step and 3 the highest. Leave the option empty if all MENA emergy steps are to be included.
This is a space separated list of the HENA energy steps to be omitted from the analysis rouintes listed under the Data Omission menu option. The HENA energy steps run from 0 through 5 with 0 being the lowest energy step and 5 the highest. Leave the option empty if all HENA emergy steps are to be included.
The two options give the number of rows and columns of plots which will be defined and output. Once these are selected it is necessary to hit a return in one of the two entry boxes to trigger the Plot Definition option boxes to appear in the menu.
The plot definitions form a Row by Column set of entry boxes. Each entry box defines the contents of one of the output plots. The avialable plot definitions are listed below.
| PLOT OPTION | DESCRIPTION | ||||
|---|---|---|---|---|---|
| EUV | Plot data contained in the the EUV inversion file | MENA# | Plot one of the MENA inversion energy steps. The energy step to output is given by # which must be between 0 and 3. | HENA# | Plot one of the HENA inversion energy steps. The energy step to output is given by # which must be between 0 and 5. |
The figure below shows a fully defined user menu. In the example menu, the output of which is shown in the next section, there are four inversion plots being output in a 2x2 plot matrix. Clockwise from the upper left are the EUV He+ density mapping, the inversion of the MENA E2 energy step, the inversion of the HENA E3 energy step and the inversions HENA E1 energy step. The lowest HENA energy step is to be omitted from both the spectra plots and moment algorithms.
| &larr Previous | TOC | HOME | Next &rarr |
| Overview | Plot Outputs |