ISIS Application Documentation

segment

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

Overview

Parameters

Example 1

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

History

Christopher Austin

2007-10-30

Original version

U.S. Department of the Interior | U.S. Geological Survey
ISIS | Privacy & Disclaimers | Astrogeology Research Program
To contact us, please post comments and questions on the USGS Astrogeology Discussion Board
To report a bug, or suggest a feature go to: ISIS Github
File Modified: 02/21/2025 19:28:13

Parameter Groups

Files

Name	Description
FROM	Input cube file.

Output Parameters

Name	Description
NL	Number of Lines for each new cube segment
OVERLAP	Number of Overlapping Lines for each new cube

Files: FROM

Description

Input cube to be segmented.

Type	cube
File Mode	input
Filter	*.cub

Close Window

Output Parameters: NL

Description

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

Type	integer

Close Window

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

Close Window

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.

Quick Links

Documentation Versions

segment

Description

Categories

History

Parameter Groups

Files

Output Parameters

Files: FROM

Description

Output Parameters: NL

Description

Output Parameters: OVERLAP

Description

Example 1

Description

Command Line

Input Image

Output Images