ISIS Application Documentation
 
    Outputs the label from a cube
  
             Overview
            
              Parameters
               
              Example 1 
              Example 2 
 
 
 
          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:
          
 
Applications 
 
 
              History
           
Elizabeth Ribelin 2005-01-10 
      Original version
     
 
Elizabeth Miller 2006-03-01 
      Modified to output label to gui if it is in interactive mode
     
 
Brendan George 2006-09-26 
      Documentation fixes
     
 
Steven Koechle 2008-05-20  
      Added TO parameter
     
 
Jeannie Walldren 2010-06-24  
      Added more filters for FROM and TO.  Updated documentation.
     
 
Mackenzie Boyd 2010-07-26  
      Added APPEND option.
     
 
 
 
 
 
 
                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 
 
 
 
 
                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
                  
                  Links open in a new window.
                   
            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.