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

Latest Release
Dev
8.3.0
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

catlab

Standard View | TOC | Home

Outputs the label from a cube

Description
Categories
Groups
Examples
History

Description

This program will output the labels from an Isis cube or its detached label file. If it is run in gui mode, the label will be written to the gui log screen. Otherwise, it will be written to the terminal window. Note: This program is designed to output Isis cube labels. However, it will work on many files with pds like labels.

Categories

Related Applications to Previous Versions of ISIS

This program replaces the following application existing in previous versions of ISIS:

Related Objects and Documents

Applications

Parameter Groups

Files

Name Description
FROM Input cube
TO Optional output file.

Output Options

Name Description
APPEND Append output to file

Files: FROM

Description

This is the input cube file from which the labels will be extracted.

Type cube
File Mode input
Filter *.cub *.lbl

Files: TO

Description

The text file to which the result Pvl will be written.

Type filename
File Mode output
Internal Default None
Filter *.txt *.prt *.pvl

Output Options: APPEND

Description

This option allows output to be appened to an already existing file. If this option is not checked and the file exists, it will be overwritten.

Type boolean
Default TRUE

Examples

Example 1

Default example

Description

This is an example of catlab with no output file.

Command Line

catlab from=peaks.cub
In this example, catlab will extract the labels from the input cube and output them to the terminal window: 
Object = IsisCube
  Object = Core
    /* Location of the core */
    StartByte   = 65537
    Format      = Tile
    TileSamples = 128
    TileLines   = 128

    Group = Dimensions
      Samples = 1024
      Lines   = 1024
      Bands   = 7
    End_Group

    Group = Pixels
      Type       = Real
      ByteOrder  = LSB
      Base       = 0.0
      Multiplier = 1.0
    End_Group
  End_Object

  Group = Bogus
    Key = Wow
  End_Group
End_Object

Object = Label
  Bytes = 65536
End_Object

Object = History
  Name = IsisCube 
  StartByte = 29425665 
  Bytes = 1048 
End_Object
End

GUI Screenshot

Example using GUI

In this example, catlab will extract the labels from the input cube and output them to the GUI log screeen.

Example 2

Example with output file created

Description

This is an example of catlab with an output file.

Command Line

catlab from=peaks.cub to=peaks.pvl
In this example, catlab will extract the labels from the input cube and output them to a pvl file.

GUI Screenshot

Example using GUI

In this example, catlab will extract the labels from the input cube and output them to a pvl file. They will not print in the GUI log screeen.

Data File

Output pvl created by catlab. In this example, the label is printed in a pvl file. This pvl is identical to the terminal interface or GUI log screen outputs in Example 1.

History

Elizabeth Ribelin2005-01-10 Original version
Elizabeth Miller2006-03-01 Modified to output label to gui if it is in interactive mode
Brendan George2006-09-26 Documentation fixes
Steven Koechle2008-05-20 Added TO parameter
Jeannie Walldren2010-06-24 Added more filters for FROM and TO. Updated documentation.
Mackenzie Boyd2010-07-26 Added APPEND option.