Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

cathist

Outputs the history of a cube

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.

Parameters

Files

The cube file the history is to be extracted from.
Type cube
File Mode input
Filter *.cub

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

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

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.

Example 1

Full printout of a .cub history

This example shows the cathist application in the full mode. This is the default mode. 
 
Object = mirror
  IsisVersion       = "8.3.0  | 2024-10-01"
  AleVersion        = "0.10.0 | py310hf166250_3"
  ProgramVersion    = 2003-07-29
  ProgramPath       = $ISISROOT/bin
  ExecutionDateTime = 2025-04-03T08:59:57
  HostName          = x86_64-apple-darwin13.4.0
  UserName          = user
  Description       = "Flip a cube from left-to-right"

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

Object = circle
  IsisVersion       = "8.3.0  | 2024-10-01"
  AleVersion        = "0.10.0 | py310hf166250_3"
  ProgramVersion    = 2012-05-25
  ProgramPath       = $ISISROOT/bin
  ExecutionDateTime = 2025-04-03T08:59:17
  HostName          = x86_64-apple-darwin13.4.0
  UserName          = user
  Description       = "Trims data outside of a circle"

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

Command Line

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

Example 2

Brief printout of a .cub history

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

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