Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search

USGS

Isis 3 Application Documentation


histitch

Printer Friendly View | TOC | Home

Merge a HiRISE channel pair to make a single image

Overview Parameters Example 1

Description

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.


Categories


History

Eric Eliason2004-07-31 Original version
Elizabeth Ribelin2005-02-22 Added obsevation id, ccd id, and channel number tests
Kris Becker2006-02-22 Made FROM2 optional and allow creation of full CCD with just one channel file.
Brendan George2006-08-24 Added StitchedChannels keyword to Instrument Group, to identify which channels were used.
Brendan George2006-09-01 Added StitchedProductIds keyword to Instrument group, to identify which images were used.
Brendan George2006-09-28 Documentation fixes
Stacy Alley2007-08-16 Added the balance option.
Steven Lambright2008-05-13 Removed references to CubeInfo

Parameter Groups

Files

Name Description
FROM1 First HiRISE Channel file.
FROM2 Second HiRISE Channel file.
TO Output HiRISE CCD image.

Balance Channels

Name Description
BALANCEOption to balance channel 0 and channel 1
SKIP Number of Pixels to skip on the edges of the image.
SEAMSIZE Number of Pixels on the seam
X

Files: FROM1


Description

This is the first 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.

Type cube
File Mode input
Filter *.cub
Close Window
X

Files: FROM2


Description

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.

Type cube
File Mode input
Internal Default None
Filter *.cub
Close Window
X

Files: TO


Description

The output cube is a HiRISE CCD image with the two channel files combined. The channel number for this cube is set to 2.

Type cube
File Mode output
Filter *.cub
Close Window
X

Balance Channels: BALANCE


Description

A feature which calculates the average on each channel and multiplies one side with the ratio of the averages

Type string
Default FALSE
Option List:
Option Brief Description
TRUEBalance On Enables balance feature.
FALSEBalance Off Disables balance feature.

Exclusions

  • SEAMSIZE
  • SKIP
Close Window
X

Balance Channels: SKIP


Description

Number of pixels to skip on each side of the seam before the program starts to accumulate pixel DN's to calculate the seam average value.

Type integer
Default 7
Close Window
X

Balance Channels: SEAMSIZE


Description

Number of pixels (after skipping 'SKIP' number of pixels) used to compute the averages on each side of the seam.

Type integer
Default 11
Close Window

Example 1

HiRISE image

Description

This example shows the hiStitch application.

Command Line

histitch from1=IN/Channel0.cub from2=IN/Channel1.cub to=OUT/output.cub balance=true skip=7 seamsize=11
hiStitch gui example

GUI Screenshot

hiStitch Gui

Example Gui

Screenshot of GUI with parameters filled in to perform a hiStitch operation on the input images.

Input Image

Input HiRISE images

Input images for hiStitch

Parameter Name: FROM1,FROM2

These are input images stitched together without the balance option on.

Output Image

Output image showing results of the hiStitch application.

Output image for hiStitch

Parameter Name: TO

This is the output image with the balance option TRUE.