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.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

segment

Standard View | TOC | Home

Divides a cube object into multiple output cubes in the line direction.

Description
Categories
Groups
Examples
History

Description

This program takes an input cube and divides it into multiple output cubes in the line direction. The total number of lines in these output cubes, as well as the number of lines these output cubes overlap, are be determined by user given parameters. If the overlap parameter is greater than the total line number parameter, then a User Errror will be thrown. If the final segment does not end on the same line that the input cube ends, then the final segment will be smaller than the other segments. In other words, the final segment will simply be created to the end of the original cube, not being filled with null lines.

Note: The output cubes (which will here on be referred to as segments) will be created in the naming form of (InputCubeName).segment(#).cub
i.e. peaks.segment1.cub, peaks.segment2.cub, peaks.segment3.cub, peaks.segment4.cub, etc

Categories

Parameter Groups

Files

Name Description
FROM Input cube file.

Output Parameters

Name Description
NLNumber of Lines for each new cube segment
OVERLAPNumber of Overlapping Lines for each new cube

Files: FROM

Description

Input cube to be segmented.

Type cube
File Mode input
Filter *.cub

Output Parameters: NL

Description

Specifies the total number of lines each segment will contain. This parameter must always be specified.

Type integer

Output Parameters: OVERLAP

Description

Specifies the total number of lines of overlap each segment will have with the previous segment as well as the next segment. This parameter must always be specified.

Type integer

Examples

Example 1

Segmented Peaks

Description

This example shows how segment works on peaks.cub, a cube of Flagstaff's peaks. It also demonstrates the automatic resizing of the final segment.

Command Line

segment FROM=peaks.cub NL=531 OVERLAP=88
Creates segments from peaks.cub which have a total of 531 lines each, and overlap by 88 lines.

Input Image

peaks.cub

The original image

Parameter Name: FROM

This is the input image peaks.cub

Output Images

peaks.segment1.cub

The first segment.

This is the first segment created from peaks.cub

It has the same sample width and band depth as peaks.cub, and has a total number of lines equal to the NL parameter, which is 531 in this example.
peaks.segment2.cub

The second segment.

This is the second segment created from peaks.cub

Like peaks.segment1.cub, it has 531 lines and the same sample width and band depth as peaks.cub. The first 88 lines of this cube (peaks.segment2.cub) are identical to the last 88 lines of its previous cube (peaks.segment1.cub). In the same manner, the last 88 lines of peaks.segment2.cub are identical to the first 88 lines of peaks.segment3.cub
peaks.segment3.cub

The third segment.

This is the third segment created from peaks.cub

Notice how this segment is smaller than the other 2 segements. This is due to the fact that it reached the end of peaks.cub, nevertheless, it still has the same sample width and band depth as peaks.cub
This shortening of the segment will only happen in the final segment created from the input cube.

History

Christopher Austin2007-10-30 Original version