nimsgeom Documentation

nimsgeom - Project NIMS data to map projection
Some other geometry programs are output driven, which means there is a
unique input pixel for every output pixel.  However, this program uses
an input driven algorithm which allows several input pixels to fall on
the same output pixel.  There are several algorithms that could be used
to process multiple input pixels.  This one has two choices:

  OPT=LAST retains only the last input pixel that falls on any one
           output pixel
  OPT=AVE  averages the values of all input pixels that fall on the
           same output pixel

This program also creates a "statistics" plane that maintains a count
of the total number of input pixels that fall on every output pixel.
The user can examine the statistics with HIST and decide to increase the
resolution with the ENLARGE parameter or use a different algorithm for
mapping the data if the results are unsatisfactory.  The statistics
plane can also be used in future processing to show the positions of
original data if some type of filter is used to fill the NULL data.

"nimsgeoplane" and "nimstplane" must be run before this program.

Programmer: Kay Edwards, U.S.G.S., Flagstaff

Input cube name
  (no default extension)

NONE

Subcube specifier

""

Output cube name
  (no default extension)

NONE

processing option (LAST,AVE)

LAST

Create output statistics plane

Y

Factor to increase the output
image resolution

1.

ADDITIONAL NOTES:

Parm	Description
FROM	The name of the cube file that is to be projected.
TO	This is the name given to an output cube file that will contain the transformed NIMS cube.
OPT	OPT=LAST retains only the last input pixel that falls on any one output pixel. OPT=AVE averages the values of all input pixels that fall on the same output pixel.
STAT	This is a 16 bit backplane called 'PIXEL_FREQUENCY' that contains a count of every time an input pixel falls in the same output pixel.
ENLARGE	The user may increase the resolution of the output image (decrease the output map scale) with this parameter. The initial scale was defined in NIMSTPLANE.