merlev1tolev2 Documentation

merlev1tolev2 - Make tfile for level 1 to level 2 conversion
This program generates a transformation file (tfile) which will
convert a level 1 (raw radiometrically corrected) cube to a
specific level 2 cube (in a map projection).  The tfile and
the level 1 cube must then been input to the program "geom"
which transforms the pixels in the input cube to the proper
position in the output cube.

PROGRAMMERS: Jeff Anderson, Debbie Cook, Tracie Sucharski,
  Jim Torson, USGS, Flagstaff, Az

Input "level 1" cube name
(default extension is .cub)

NONE

Subcube specified for
FROM file

--

Map projection and parameters
(e.g., MAPPARS="SINU:0")

NONE

Projection Plane Definition
File

--

Azimuth range
(default=calculated)

--

Elevation range
(default=calculated)

--

X range
(default=calculated)

--

Y range
(default=calculated)

--

Image resolution (meters/pix)
      or

--

Image resolution (pix/deg)
(default=calculated)

--

Transformation file
(no default extension)

tfile.dat

Trim outside lat/lon boundaries

NO

Sample/line increments

1,1

DEM file for radii source

--

Value to override grid size

--

Grid spacing for retesting

--

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
SFROM	The input subcube specifier. Allows the user to select a subarea of the input cube for processing. The default " " selects the entire cube. For this application only a contiguous subarea will be allowed.
MAPPARS	This parameter is used to specify the map projection and its specific parameters. For example, "SINU:0" implies Sinusoidal map projection with a central longitude of 0. The program will automatically calculate default values for projection specific parameters and therefore "SINU:" is an acceptable input. **NOTE** For a detailed explanation of MAPPARS, tutor the mappars.pdf (i.e., TAE> tutor mappars).
PRJPLANE	Projection Plane Definition File
AZRANGE	Used only for CYLINDRICAL_PERSPECTIVE and SIMPLE-CYLLINDRICAL projections. Azimuth range of the desired output cube which will be produced by "geom". If the range is not entered then it will be automatically computed. If the range is entered then ELRANGE must be entered as well.
ELRANGE	Used only for CYLINDRICAL_PERSPECTIVE and SIMPLE-CYLLINDRICAL projections. Elevation range of the desired output cube which will be produced by "geom". If the range is not entered then it will be automatically computed. If the range is entered then AZRANGE must be entered as well.
XRANGE	Used only for ORTHOGRAPHIC and VERTICAL projections. X range of the desired output cube which will be produced by "geom". If the range is not entered then it will be automatically computed. If the range is entered then YRANGE must be entered as well.
YRANGE	Used only for ORTHOGRAPHIC and VERTICAL projections. Elevation range of the desired output cube which will be produced by "geom". If the range is not entered then it will be automatically computed. If the range is entered then XRANGE must be entered as well.
METERS	Used only for ORTHOGRAPHIC and VERTICAL projections. This specifies the map resolution in meters/pixel. If a value is not entered then the average resolution of the cube will be automatically calculated.
DEG	Used only for CYLINDRICAL_PERSPECTIVE and SIMPLE-CYLLINDRICAL projections. This specifies the map resolution pixels/degree. If a value is not entered then the average resolution of the cube will be automatically calculated.
TFILE	This is the name of the transformation file (tfile) to be generated. The input cube, along with this tfile must be input into the program "geom" in order to produce a level 2 cube.
TRIM	If TRIM=YES, the program will create a TFILE that will cause "geom" to project only the area within the latitude/longitude boundaries defined by the user via LATRANGE/LONRANGE or determined by the program in the event the user did not enter a range. If TRIM=NO, no trimming will be done.
INC	This parameter allows the user to specify a sample/line increment which is used only when the program attempts to automatically calculate the lat/lon range and/or pixel resolution. By sub-sampling using the INC parameter the program will run faster; however, the results for the lat/lon range may not be valid (e.g., for images with limbs).
DEM	Enter a level 2 file to be used as a source for the local radius for each projected point. The default is to project onto the ellipsoid defined by the radii in the targdef file.
OVERRIDE	This parameter is used to enter a grid spacing that will override the computed grid spacing. It should not be used in most cases. If a tile in a cube is not projecting correctly because of undetected changes within the tile, then OVERRIDE should be set to force a finer grid. Valid values are 16, 4, and 1.
RETEST	This parameter is used to request retesting of tiles whose corners and center value map off the input image. If this parameter is set the program will retest the tile searching for valid data every RETEST pixels across and down the tile. This parameter should be used if the data contains fine pieces that extend outside a box region. Only values equal to 4 to the n power can be used for tilesize (1, 4, 16, 64, ....).