Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Public Release
8.2.0
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


framestitch

Standard View | TOC | Home

Stitches even and odd frames from push frame cubes back into a single cube.

Description
Categories
Groups
History


Description

This program combines the even and odd frames from push frame cubes back into a single interwoven cube. It can also optionally flip the frame order so that adjacent ground features appear adjacent between frames. If the last several rows of a frame have the same data as the first several rows of the next frame, reduntant lines can be eliminated with the num_lines_overlap parameter. This program is designed to be run before processing the data in another software package and the output cube will not produce a valid camera model for further processing in ISIS.

When many push frame images are ingested into ISIS, their frames are separated into two different cubes, one with even frames and one with odd frames. In the odd frame cube, the lines for the even frames are Null and in the even frame cube, the lines for the odd frames are null. This makes processing in other applications difficult because each image only has half the data and covers half the ground. The footprint for each image is also composed of multiple disjoint pieces and can be difficult to work with.


Categories


Related Objects and Documents

Applications


Parameter Groups

Files

Name Description
EVEN Even frame cube
ODD Odd frame cube
TO Output file that contains all frames

Settings

Name Description
FLIP Flip the frame order
FRAMEHEIGHT The number of lines in each frame
NUM_LINES_OVERLAP The number of lines in each frame repeating information present in neighboring frames.

Files: EVEN

Description

This specifies the input cube containing even frames.

Type cube
File Mode input
Filter *.cub

Files: ODD

Description

This specifies the input cube containing odd frames.

Type cube
File Mode input
Filter *.cub

Files: TO

Description

The output filename for the cube containing the combined frames from the input even and odd cubes.

Type cube
File Mode output
Filter *.cub

Settings: FLIP

Description

If true, the order of the frames in the output cube will be reversed. So the firt frame in the output cube will be the last frame in the input cubes and the last frame in the output cube will be the first frame in the input cubes.

This option can be used to correct for adjacent ground points not being adjacent between frames. This occurs when the flight direction and the increasing line direction on the detector are opposite each other.

This option can also be used to undo any flipping in the input cubes.

Type boolean
Default FALSE

Settings: FRAMEHEIGHT

Description

The number of lines in each frame.

If not entered, then the program will attempt to count the number of adjacent NULL and non-NULL lines in each image to determine a frame size.

Type integer
Internal Default Camera
Minimum 1 (exclusive)

Settings: NUM_LINES_OVERLAP

Description

The estimated total number of lines in each frame which have the same pixel values as frames above and below it. During processing, half this amount of lines will be removed from each of the top and bottom of the frame. Must be an even non-negative number.

If not entered, the program will assume the value 0. A value of 2 or 4 works reasonably for LRO WAC images.

Type integer
Internal Default 0
Minimum 0 (exclusive)

History

Jesse Mapel2022-04-22 Original version