Home
About ISIS
Support
Download

ISIS 3

Documentation
Tutorials
Technical Documents

ISIS 2

Documentation
Tutorials
Technical Documents

Search

USGS

ISIS 3 Application Documentation


cathist

Standard View | TOC | Home

Outputs the history of a cube

Description
Categories
Groups
Examples
History


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:

Related Objects and Documents

Applications


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

Files: FROM

Description

The cube file the history is to be extracted from.

Type cube
File Mode input
Filter *.cub

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

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

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.

Examples


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.

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.