Merge a HiRISE channel pair to make a single image
The program allows the user to combine two HiRISE channels to form a
single CCD image. Histitch will typically be run after radiometric
correction and prior to geometric processing. The two input files
must be the individual channel files (channels 0 and 1) of the
same CCD observation. The program will test to make sure the
Observation IDs and CCD IDs of the input cubes match, and that one
cube is channel 0 and the other is channel 1. The program is clever enough
to figure out the channels associated with each input file and correctly
order them in the output file. Any ancillary data "blobs"
will not be propagated to the output file. The channel number on
the output cube is set to 2 to signify that it is the combination of channels
0 and 1.
histitch can create a CCD image if when only one channel is provided.
The proper placement, left half of CCD for channel 1 images, right half for
channel 0, is determined from the input file and the remainder of the CCD
is filled with Nulls.
Added obsevation id, ccd id, and channel number tests
Made FROM2 optional and allow creation of full CCD with just one
Added StitchedChannels keyword to Instrument Group, to identify
which channels were used.
Added StitchedProductIds keyword to Instrument group, to identify
which images were used.
Added the balance option.
Removed references to CubeInfo
Added new EQUALIZE balance option that has utilizes new options WIDTH,
FILL, CHANNEL and OPERATOR parameters. This new option applies a
line-by-line equalization of the CCD channels using and addative or
Replaced references to DataInterp class with NumericalApproximation.
Set channel 1 (left) as the default to hold instead of channel 0.
Added reporting of results to label in the Histitch group. Also added
creation of a Table of data when the EQUALIZE BALANCE option is
The BALANCE=TRUE option now honors the CHANNEL parameter and applies the
coefficient/ratio to the other channel.
Steven Lambright & Stacy Alley
Added error checking to SKIP and SEAMSIZE parameters. Fixed problem
with accessing out of array bounds.
This is the second of a pair of input HiRISE channel
image files. This file can be either the channel 0
or 1 file. The pair of input files must correspond
to the the same observation of a HiRISE CCD.
If the user does not provide a file for the second file, histitch
will create a full CCD and map the FROM1 file into the proper
location in the CCD. This allows creation of the full CCD without
both channels being required.
A feature which calculates the average on each channel and multiplies one side with
the ratio of the averages
Enables balance feature.
Disables balance feature.
Enables line-by-line equalization feature. This feature uses
the SEAMSIZE and SKIP parameters to generate an average of each
line for both channels. These averages can be filtered (using
an LPF) and missing data filled (using spline interpolation).
The results can be subtracted or multiplied to correct for
downtrack differences in the channels.
When this option is selected, an ISIS Table is created
called HistitchStats. This table contains four fields:
Channel1Original, Channel0Original, Channe1Correction, and
Channel0Correction. If the MULTIPLY OPERATOR is selected,
then one channel corrected column will be all 1.0. For the
ADD OPERATOR one column will contain all 0.0.
The two original columns will contain the results of
averaging the specified window with the values of SEAMSIZE
and SKIP parameters. The correction columns will contain
the ratio (MULTIPLY) or additive (ADD) component of the
correction that was appled to channel 0 or 1, whichever one
is not designated the hold channel in the CHANNEL
The ISIS program tabledump can be used to extract the
contents of this table to an ASCII file.