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

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation

outline

Printer Friendly View | TOC | Home

Outlines contiguous regions in a cube

Overview Parameters Example 1

Description

This program will draw boundaries or outline contigous regions in a cube. By contiguous regions we mean those which are all of the same pixel value.

Categories

History

Kris Becker1986-11-04 Original version
Jeff Anderson2003-04-21 Ported to Isis 3.0
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides2003-05-30 Added modifications to apptest by Kim
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Steven Lambright2008-05-13 Removed references to CubeInfo
Kelvin Rodriguez2016-06-27 Added examples

Parameter Groups

Files

Name Description
FROM Input cube to outline
TO Output cube

Options

Name Description
BOUNDARYBoundary pixel value
CLEARClear pixels inside boundaries
EDGESSet pixels at edges of cube
X

Files: FROM

Description

Use this parameter to select the filename. All bands within the file will be outlined.

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

Files: TO

Description

This file will contain the results of the outlined cube.

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

Options: BOUNDARY

Description

This defines pixel value which will be placed at the boundary of contiguous regions. This value should not occur in the input cube.

Type double
Close Window
X

Options: CLEAR

Description

Setting this option to true will case all pixels found inside the boundaries to be set to NULL. Otherwise the pixels will be left alone.

Type boolean
Default TRUE
Close Window
X

Options: EDGES

Description

Setting this option to true will case all pixels around the edge of the cube to be set to the boundary pixel value. Otherwise they will be left alone or set to NULL.

Type boolean
Default TRUE
Close Window

Example 1

Artificial Cube as input.

Description

This example shows how the Outline application draws boundaries around contiguous pixels.

Command Line

outline IN=in.cub OUT=out.cub BOUNDARY=255 CLEAR=False EDGES=True
This will set the borders around the contiguous pixels to 255 and will leave the pixels contained within the regions at their original value.

GUI Screenshot

Outline Gui

Example Gui

Screenshot of GUI for yhr Outline application.

Input Image

Input artificial cube.

Input image for outline

Parameter Name: FROM

This is the 800 by 800 input image for the outline example. This is an artificial cube for the sake of demonstration.

Output Image

Output image clearly demonstrating the boundaries created by Outline.

Output image for outline

Parameter Name: TO

This is the 800 by 800 output image demonstrating the results of Outline. White lines (DN = 255) mark the boundaries between contiguous pixels. This is with Clear=False, Edges=True and Boundary=255.