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


cathist

Printer Friendly View | TOC | Home

Outputs the history of a cube

Overview Parameters Example 1 Example 2

Description

This program will output the full or brief history of a .cub file. The brief mode is especially useful for creating a script for a batch job, because the output is in the command line format.

Categories


Related Applications to Previous Versions of ISIS

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

Related Objects and Documents

Applications


History

Elizabeth Ribelin2005-01-10 Original version
Brendan George2006-09-25 Documentation fixes
Elizabeth Miller2007-02-26 Modified to output results in gui log if the gui is open
Mackenzie Boyd2010-07-26 Added to and append options.

Parameter Groups

Files

Name Description
FROM Input file the history is needed from
TO Output file for the history

Output Options

Name Description
APPEND Append output to file
MODEMode types
X

Files: FROM


Description

The cube file the history is to be extracted from.

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

Files: TO


Description

This is the file which the PVL history for the input cube will go to.

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

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
Close Window
X

Output Options: MODE


Description

Different modes that cathist can run in.

Type string
Default FULL
Option List:
Option Brief Description
FULLFull history listing Lists the full history of the file in the PVL format.
BRIEFBrief history listing Lists a brief history of the file in a command line format.
Close Window

Example 1

Full printout of a .cub history

Description

This example shows the cathist application in the full mode. This is the default mode.
 
Object = mirror
  IsisVersion       = "3.0.2 beta | 2004-11-17"
  ProgramVersion    = 2003-07-29
  ExecutionDateTime = 2005-01-10T13:33:12
  HostName          = orkin
  UserName          = eribelin
  Description       = "Flip a cube from left-to-right"

  Group = UserParameters
    FROM = peaks.cub
    TO   = temp.cub
  End_Group
End_Object

Object = circle
  IsisVersion       = "3.0.2 beta | 2004-11-17"
  ProgramVersion    = 2003-07-29
  ExecutionDateTime = 2005-01-10T13:50:46
  HostName          = orkin
  UserName          = eribelin
  Description       = "Trims data outside of a circle"

  Group = UserParameters
    FROM = temp.cub
    TO   = temp2.cub
  End_Group
End_Object
End
         

Command Line

cathist from=temp2.cub
Run the cathist application on a .cub file.

Example 2

Brief printout of a .cub history

Description

This example shows the cathist application in the brief mode.
mirror from=peaks.cub to=temp.cub
circle from=temp.cub to=temp2.cub
            

Command Line

cathist from=temp2.cub mode=brief
Run the cahist application on a .cub file in brief mode.