Main User Interface

Invoking the EUVSim application brings up the main User Interface shown below unfilled.

The actions and options defined through the main User Interface are described below.

Run

Runs the application after the menu options have been filled in.

NEXT

Used to advance to the next inversion when the program is being run in interactive mode. The button begins MUTED (blue text) and becomes activated (black text) when an inversion finishes and the next can be begun.

MENU

In this location the processing status will be output. This gives the position in the program being executed. The EUV image being inverted, with 0 being the first first image read, is given in parenthesis at the end of the status.

IDLE

The beginning time of the current EUV image being processed is output in this location.

QUIT

Quit the application

Output To

Clicking on this button brings up a list of output devices to which the screen plots can be directed. At this time Tk Canvas is the only option.

ColorTable To

Clicking on this button brings up a list of available color tables which can be used when displaying the data.

Print Mesh

This option defines whether to print out the He+ inversion map. The option toggles between NO and YES each time it is clicked. When YES the inversion data is placed in a file with the name YYYYDDDHHMMSS.sim where YYYY, DDD, HH, MM, SS are the starting year, day of year, hour, minute, and second, of the source EUV image respectively. The mesh is output prior to any decimation or filtering which may be applied prior to its display if being plotted. The mesh is printed in the coordinates which are specified under the Solution Grid option.

Masks

Clicking on this button menu brings up the Mask User Interface. This allows various regions in the measured image to be zeroed out. The masks allow areas of background which are not able to be suppressed by other methods to be removed. This option should only be used when inverting single images and not when running multiple inversions. The interface and its options are presented under its own section. Note: defining a mask is a two step process. First EUVSim is run to bring up the measured image on which the masks are defined. The masks are then saved and implemented in the next call to EUVSim where the full inversion is run.

Grid Options

Clicking on this button menu brings up the Grid Options User Interface from which background subtraction, hot spot rejection, and other filtering algorithms are managed. The interface and its options are presented under its own section.

Plot Options

Clicking on this button menu brings up the Plot Definition User Interface from which plots to be output are selected and their scalings set. The interface and its options are presented under its own section.

Read Menu

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.

Save Menu

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.

Start Time

This is the time at which to start the the inversions. The EUV image which was assembled closest to this time will be the first image to be inverted. The time is specified as a 4 digit Year, Day of year, Hour, Minute, and Second.

Stop Time

This is the time at which to stop the inversions. Inversions will be done until the start time of the EUV image read in exceeds this time. The time is specified as a 4 digit Year, Day of year, Hour, Minute, and Second.

Solution Grid

A set of three options which define how to set up the density solution grid. The density solution grid is a mesh setup in the SM equatorial plane in which the inversion is solved. The first option specifies the coordinate system used in establishing the grid: either POLAR or RECTANGULAR. With a POLAR grid the grid columns (X) represent geomagnetic longitude while the grid rows (Y) represent radial distance. In a RECTANGULAR grid the grid the grid columns (X) and grid rows (Y) represent SM X and Y distances respectively. The differnce between the two definitions is a matter of resolution. In a polar grid the azimuthal resolution decreases with radius while in a rectangular grid the resolution is constant throughout.

The second two options on the line establish the grid resolutions along X and Y. This is equivalent to defining the number of bins in the grid in the two directions. The X resolution always has units of Re while the Y resolution has units of Radians for a polar grid and Re for a rectangular grid.

Fit Options

A set of three options associated with the inversion algprithm. The first of these is the convergence criteria to use when integrating over the instrument lines of sight to compute the column density. The integration method is basically a iterative trapazoidal algorithm in which the number of intervals used in the integration are increased at each step. The integration ends when the change in the total integrated value varies by less than the integral resolution given in the option. Mathematically the integral terminates at the iteration step where:

abs(nV) - abs(oV · [1.0 + R]) < 0
where nV is the current integral value, oV is the integral value from the previous step, and R is required resolution.

The second option specifies the number of interation steps to use in the inversion.

The last option specifies the upper bounds in the L-Shell is include in the inversion. L-shell values above this are assumed to have 0 density. A positive value indicates a user specified upper limit. A negative value indicates that the maximum L-shell should be set within the algorithm to the nominal Kp dependent L-shell plasmasphere location plus the absolute value of the option. The current algorithm used is

MaxL = -.46666 · kP + 5.76 - IncrL
where IncrL is the value specified in the option.

Shifts

The inversion works on the tacit assumption that the center of the Earth in the EUV image is located at (0° , 0° ) in phase and elevation. While is this the norm at times it can be shifted off the origin in either or both directions. When this occurs these options can be used to recenter the image. The effects of these options are illustated below.

EUV image with no shift. Note that this image the Earth is centered at a slightly positive phase. The Earths outline is essentially given by the inner edge of the dayglow.
EUV image with a +2° shift in phase. This centers the image. A positive phase shift moves the image down in phase.
EUV image with a -2° shift in phase. A negative phase shift moves the image up in phase.
EUV image with a +4° shift in elevation and a 0° shift in phase. A positive elevation shift moves the image right in elevation.
EUV image with a -4° shift in elevation and a 0° shift in phase. A negative elevation shift moves the image left in elevation.

Latitudinal Density Profile

These options are unimplemented at this time. When implemented it will allow the user to specify a latitudinal density profile to use in the inversion. At the current time the density is assumed to be constant in along L.


&larr Previous TOC HOME Next &rarr
Invoking Correction Menu