warp3 Documentation

warp3 - Interpolate values in the third (brightness) dimension
Interpolates elevation (brightness) values given a cube with contour
lines or spot elevations and fills missing (null) values.  The original
elevation values are used in a weighted least-squares fit to a
polynomial equation to create regional elevation interpolations.
(No single polynomial fit is used over the entire cube.)

All elevation values and distances are scaled between 0 and 1.  The
scaled distance is calculated from each point in question to all control
points.  1/(distance**WT) is used for the weighting factor.  A maximum
of 50000 control points can be used.  These control points are found by
reading the cube and counting any non-null pixel as a control point.

WARNING:  This program is unbelievably slow.  For 360 samples and 90
          lines, it takes about 15 minutes.

PROGRAMMER: Kay Edwards, USGS, Flagstaff, AZ

Input cube file name
(default extension is .cub)

NONE

Input subcube specifier

--

Output cube name
(default extension is .cub)

NONE

Degree of fit (1-5)

1

Distance weighting factor

5.0

Output pixel type

--

Minimum and maximum
output pixel range

--

Comment to user

" "

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
SFROM	SFROM specifies the subcube using a single string for all three dimensions of the cube. The order of the three dimensions is always "samples:lines:bands". If a dimension is left blank, all the data for that dimension is selected. The default value of NULL for SFROM selects the entire cube. Any application below can be used for any dimension. To select specific data from any dimension: "10-100(3):11,12,15-20:1-10(2)" This example will select every third sample starting with sample 10 thru 100. It selects lines 11 and 12, and 15-20. It selects every other band, starting with band 1 thru 10. There are special characters that can be used for selecting a subcube efficiently, such as "*","#", and "~". For examples type "help sfrom" in TAE. **NOTE** For more examples and explanation of the many features of the SFROM parameter, refer to Introduction To ISIS, Section 6, of the ISIS User's Manual
TO	Output cube file name. If the file extension is omitted, then ".cub" will be assumed.
DEG	A weighted least-squares fit to a polynomial equation of first to fifth degree is used to create regional interpolations.
WT	All distances on the cube are scaled between 0 and 1. 1/(distance**WT) is used for the weighting factor in the least-squares fit.
OTYPE	Output pixel data type. Permitted values are: NULL = output type is same as input file pixel type 1 = 8-bit (integer with type conversion parameters) 2 = 16-bit (integer with type conversion parameters) 3 = 32-bit (floating point) When processed data are being written back into the input file, the output pixel type must be the same as the existing pixel type in the input file.
ORANGE	Output pixel data range. If ORANGE is NULL, then the CORE_BASE and CORE_MULTIPLIER in the output file will be set to represent the same range of data as the input file. If OTYPE=1 (8-bit) or OTYPE=2 (16-bit), then the CORE_BASE and CORE_MULTIPLIER in the output file will be set to values that allow representing the specified range of output values. Output values outside this range will be stored as a special "representation saturation" value. The ORANGE parameter is ignored if OTYPE=3 (32-bit) since the CORE_BASE and CORE_MULTIPLIER are not applicable to floating point pixel values. **NOTE** For a more detailed explanation of ORANGE, tutor the orange.pdf.
USERNOTE	Comment from the user. This will be recorded in the ISIS session log file and also in the History entry that is put into the History object of the output file.