lev1tolev2 Documentation

lev1tolev2 - 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.

PROGRAMMER: Jeff Anderson, USGS, Flagstaff, Az

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

NONE

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

NONE

Target or target definition
file (default=FROM targdef)

--

Latitude range
(default=calculated)

--

Longitude range
(default=calculated)

--

Image resolution (km/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.
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).
TARGDEF	Enter a target definition file, target name (which will be used to generate the default target definition file), or use the default (copy target information from the FROM file. Example: TARGDEF=mars The software will try to find files: $ISISDATA/targets/mars.def.1 $ISISDATA/targets/mars.def.2 $ISISDATA/targets/mars.def.3 etc. Or enter a user written target definition file path and name: TARGDEF=/work1/elee/mars.def.3 If you want radii different from the defaults in the system, you cannot enter the radii numbers here. Copy the system target definition file to your area and edit, putting the radii you want into the definition file. Then TARGDEF=your_ file. Note also that the target definition file name will be written to the cube labels, and you will help yourself if you use a version system as is being done in ISIS. Each time you make edits to your target definition file, rename it and keep the old versions lying around somewhere where you can find them.
LATRANGE	Latitude 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 LONRANGE must be entered as well.
LONRANGE	Longitude 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 LATRANGE must be entered as well.
KM	This specifies the map resolution in kilometers/pixel. If a value is not entered then the average resolution of the cube will be automatically calculated. If a value is entered then a value must not be entered for DEG.
DEG	This specifies the map resolution pixels/degree. If a value is not entered then the average resolution of the cube will be automatically calculated. If a value is entered then a value must not be entered for KM.
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, ....).