USGS

Isis 2 Documentation


hilomatch Documentation

hilomatch - Match Clementine uvvis high exposure to low exposure
This program will match a Clementine Uvvis high exposure image to
a low exposure image by computing the average ratio then multiplying
the high exposure image by this multiplicative constant.

Programmer: Tracie Sucharski, U.S.G.S., Flagstaff, AZ


ParmDescriptionDefault
FROM
Input cube file name
High exposure image
  (Default extension is .cub)
NONE
SFROM
Input subcube specifier
--
FROM2
Second input cube file name
Low exposure image
  (Default extension is .cub)
NONE
SFROM2
Second input subcube specifier
--
TO
Output cube file name
New High exposure image
  (Default extension is .cub)
NONE
OTYPE
Output pixel type
 NULL = input type
    1 = 8 bit
    2 = 16 bit
    3 = 32 bit
--
ORANGE
Output min/max data range
--
USERNOTE
User comment
" "
MULT
Returns the multiplicative value
applied to the high exposure.
LOCAL1

ADDITIONAL NOTES:

ParmDescription
FROM
Input cube file name.  This is the high exposure uvvis
image.

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.

For example, "10-100(3):11,12,15-20:1-10(2)" will
select every third sample starting with sample 10 thru 100;
lines 11 and 12, and 15-20; and 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, tutor the sfrom.pdf or
refer to Introduction to ISIS, Section 6, of the ISIS
User's Manual **
FROM2
Second input cube file name.  This is the low exposure uvvis
image.

If the file extension is omitted, then ".cub" will be
assumed.
SFROM2
Input subcube specifier for the second input file.  Refer
to the SFROM parameter help section for examples.
TO
Output cube file name.  If the file extension is omitted,
then ".cub" will be assumed.
This is the new high exposure which is matched to the
low exposure.

TO=" " cannot be used to put the computed hilomatchs back
into an input file.
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 satuhilomatchn" value.

The ORANGE parameter is ignored if OTYPE=3 (32-bit) because
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.
MULT
This is the multiplicative value applied to the high
exposure image to match it to the low exposure image.






Last updated: Jan 31 2005
File: pdfs2.html

Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov

ISIS Documentation Home Page