smigen

Description: This program reads in a Level-3 space-binned
or time-binned file and generates a Standard Mapped Image
(SMI) HDF product containing one of 5 possible statistical measures.
SMI products are image representations of binned data products.
This image is a two-dimensional array of an Equidistant
Cylindrical projection of the globe. The resolution of the default
9km grid is approximately 0.08789 degrees and a global SMI product
is 4096x2048 pixels. Each SMI product contains one image of a
geophysical parameter and is stored in one physical HDF file.

The SMI default data value format is 8-bit integer, lacking the full
precision of the original retrieval. Also, the SMI format presents
the data in an equirectangilar grid, which means the spatial
resolution varies with latitude. In contrast, the binned products
maintain the data in an equal-area projection. Generally speaking,
it is recommended that you use the binned products when doing
detailed, quantitative analysis, and you use the SMI products
when you just want easy access to a global image.

Examples: Note that to specify multiple products, you may
either run smigen several times in succession, or specify several products
at once. If you specify several products at once, and wish to override the
product defaults, all arguments will accept arrays of values (see example
2 below).

The main SMI widget can be accessed under then main SeaDAS
Process pull down menu or from the seadas command line by typing "smigen".

Input File Selection Section:

Level-3 binned file

The input Level-3 binned file. It can be either a space-binned
or time-binned file. This entry can be typed in manually or interactively
selected with the Select button.

Select

To interactively select an input file using the File Selection Widget.
The file selected will be displayed in the Level-3 binned file input field.

Help

Display this HTML help file in local Netscape or Mosaic HTML viewer.

Quit

Quit the smigen GUI.

Current Working Product Entry Section: In this section, SMI output
products are defined. The user can change all the output parameters such as
product, latnorth, latsouth, lonwest, loneast, projection, resolution, measure,
scaling and output filename until a desired output product is defined.
Once an output product is defined, pressing the Add to Process List
button adds the current product to the list for processing. As many output
products can be added to the process list as desired. In addition, once
an item has been added to the process list, it can be edited further by
selecting the item with the left mouse button, modifying the information
and then pressing the Update Process List button.

Products

The current working geo-physical parameter. When a product button is selected,
the defaults for Measure and Scaling for that product
are automatically loaded. A default output file name is also automatically
generated. (See Command Mode for a list of the scaling
defaults.)

The statistical measure desired for the geo-physical parameter selected.
Note that measures pixels and scenes will produce exactly the same output
across all geo-physical parameters for a given input file. The following
variables are stored for every bin in the L3-binned input file and are
used in calculating the measures:

s = sums of all values input to the bin
ssq = sums of the squares of all input values to the bin
wt = weight assigned to that bin
ns = number of scenes input to that bin

Mean

s/wt

Variance

tmp_var = (ssq/wt)-(mean**2)
var = (tmp_var * wt**2) / ((wt**2)-ns)

Standard Deviation

sqrt(var)

Pixels

Number of Level-2 input values that went into creating the
Level-3 bin selected for each grid point

Scenes

Number of Level-2 input files that went into creating the
Level-3 bin selected for each grid point

Scaling

The inputs to use for scaling the geo-physical product. Modifying any
of the scaling parameters will cause the others to automatically recalculate.
***NOTE: You must hit the enter key after entering these values!***
(See Command Mode for a list of the scaling
defaults).

File Out

The name of the SMI HDF output file. (One output file per geo-physical product).

ASCII Palette File

The name of an alternate color palette to use instead of the default
color table. (A blank denotes using the SMI default color palette).

Add To Process List

Add the current working product entry to the processing list.

Update Process List

Update the highlighted item in the processing list with the current
information in the working product entry.

Products Selected For SMI Processing Section:

Products Selected List

Selecting an item in the processing list, will cause all the fields to be loaded
back into the working product entry.

Delete Entry

Delete the highlighted item in the processing list.

Clear All

Delete all items from the processing list.

Job Submission Section:

Submit

Submit all items in the processing list for SMI processing in the background.
Output messages will be printed to the specified Log File. If the log file
entry is left blank, messages will print to the screen.

Run

Process all items listed in the processing list in the foreground. All
output messages will be printed to the terminal screen. This option will
tie up your terminal and may take several minutes depending on the number
of bins in the input file. It is not advisable to use this option.

Log File

The name of the logfile for smigen job submission. If blank, any log
information will be printed to the screen.