ISIS Application Documentation
    Imports a PDS4-formatted CaSSIS image into an ISIS-formatted cube.
  
 
          Description
        
    
      The application, tgocassis2isis, takes a PDS4 formatted Colour and Stereo Surface 
      Imaging System (CaSSIS) image and outputs an ISIS cube from the image data. 
     
    
      Note that the corresponding .dat file containing the image data must be placed in the 
      same directory as the XML file in order for this program to work as intended. 
      Furthermore, this program is specific to CaSSIS formatted image data.
    
 
    
      Below is an example of part of a CaSSIS XML label for one of the images that this
      program is capable of importing. It is vital that the XML label that is being imported 
      has its labels formatted the same way in order for tgocassis2isis to work properly.
     
    
       
        <File_Area_Observational>
          <File>
            <file_name>G:\CaSSIS\data\COM\160407_commissioning_1\level0\CAS-COM-2016-04-07T09.44.06.839-PAN-01006-00</file_name>
            <creation_date_time>2016-06-14T07:30:17</creation_date_time>
            <comment>CaSSIS specific XML header</comment>
          </File>
          <Array_2D_Image>
            <axes>2</axes>
            <Axis_Array>
            <axis_name>Line</axis_name>
              <sequence_number>1</sequence_number>
              <elements>1536</elements>
            </Axis_Array>
            <Axis_Array>
              <axis_name>Sample</axis_name>
              <sequence_number>2</sequence_number>
              <elements>255</elements>
            </Axis_Array>
            <Element_Array>
              <data_type>SignedInteger</data_type>
              <idl_data_type>2</idl_data_type>
              <unit>DN</unit>
              <scaling_factor> 1.00</scaling_factor>
              <value_offset> 0.00</value_offset>
            </Element_Array>
          </Array_2D_Image>
        </File_Area_Observational>
      
    
 Filters
    
       The following table provides the nominal specifications for each of the 4
       CaSSIS filters. Updated measured values may be available from the mission team. 
     
      
            
                CaSSIS Filter Nominal Specifications
              
          
            | Name | 
            Wavelength (nm) | 
            Equivalent Bandwidth (nm) | 
           
          
              | PAN | 
              675 | 
              250 | 
           
          
              | BLU | 
              485 | 
              165 | 
           
          
              | RED | 
              840 | 
              100 | 
           
          
              | NIR | 
              985 | 
              220 | 
           
       
   
 
          Categories
        
 
              History
          
| Kelvin Rodriguez | 2016-08-15 | 
      Original version
     | 
 
| Marjorie Hahn | 2016-08-17 | 
      Added user documentation. Fixes #4251.
     | 
 
| Kristin Berry, Jeannie Backer, Jesse Mapel | 2017-01-13 | 
      Updated to be a standalone ingestion program which does not use ImageImporter. Changed app 
      name to tgocassis2isis. Added filter table to documentation. References #4586
     | 
 
| Makayla Shepherd | 2017-05-30 | 
      Updated to work with XmlToPvlTranslationManager rename. Fixes #4889.
     | 
 
| Jeannie Backer | 2017-09-05 | 
      Added check to verify input input xml file corresponds to valid filter image. 
     | 
 
| Summer Stapleton | 2018-02-16 | 
      Added handling for image file extesnions of either .dat or .img. Fixes #5334. 
     | 
 
| Kristin Berry and Makayla Shepherd | 2018-05-15 | 
     Updated to ingest images which have been exported using tgocassisrdrgen. Fixes #5418.
     | 
 
| Kristin Berry and Makayla Shepherd | 2018-05-15 | 
     Updated to ingest Mapping groups from images have been exported using tgocassisrdrgen. Fixes #5418.
     | 
 
| Kristin Berry and Makayla Shepherd | 2018-05-22 | 
     Updated to ingest mosaics exported from tgocassisrdrgen #5418.
    | 
 
| Summer Stapleton | 2018-05-22 | 
      Stripped the "Z" from the StartTime value in the "Instrument" group to handle re-ingestion 
      of PDS4 compliant .xml files.
     | 
 
| Jeannie Backer | 2018-08-12 | 
      Added ObservationId to Archive group.
     | 
 
 
 | 
 
 
                Parameter Groups
            
Files
| 
                    Name
                     | 
                    Description
                     | 
 
| FROM | 
          Input PDS4 CaSSIS formatted XML file
         | 
 
| TO | 
           Output ISIS cube
          | 
 
 
 | 
 
Files:
                        FROM
                         Description
                       
          The PDS4 CaSSIS formatted XML file containing the metadata on the image. 
          The corresponding .dat file for the XML must be inside of the same 
          directory that the XML is in before running the program. 
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | input | 
| 
                               Filter
                              | 
          *.xml
         | 
 
 
Files:
                        TO
                         Description
                       
           Use this parameter to select the filename for the output ISIS cube. 
           This cube will be the ISIS equivalent of the imported CaSSIS image.
         
| 
                             Type
                            | cube | 
| 
                               File Mode
                              | output | 
| 
                               Filter
                              | 
           *.cub
          |