 
        ISIS 3 Application Documentation
    Mars Odyssey Themis RDR image cleanup 
  
            Description
              Categories
              Groups
              History
          Description
        
    Themis image cleanup procedure developed for the Mars geologic base 
    map production and the ancillary datasets.  The RDR's or radiometrically
    calibrated images are required as input to the program.  The 12.57um 
    wavelength band is selected for the mosaic, and the 14.88um atmosphere
    band is used as input to "thmdriftcor" program.  The following programs
    are run:
        thm2isis - converts to isis3 format
	spiceinit - updates SPICE information
	camstats - collects camera staistics
	thmdriftcor - applies atmosphere correction using 14.88um band
	cosi - applies a basic photometric normalization using the incidence 
	     angles for improved tone matching
	cubenorm - used to cleanup banding(column) effect on the RDRs
	lineeq - normalize base on line averages for signal drifts and/or
	     correcting for photometric changes during crossover from day to 
	     night.
	findgaps - find gaps in the input image
        Generate statistics file and footprint information for input into GIS 
	     packages
    
    The InstrumentId must be "THEMIS," DETECTOR_ID must be "IR," 
    BandBinCenter must have "12.57um," and "14.88um" for the 
    atmospheric correction. 
 
    If NIGHT is checked then the night time IR images are processed, and
    the incidence angle test is not performed.
   
    The spiceinit program will automatically use nadir pointing if it fails
    to update with reconstructed or predicted ck kernels. 
    
    If RMINPUT is checked then the input file is deleted after processing.
    
    If RMHIGHINC is checked then the input RDR file is deleted from 
    processing if the incidence angle test is not meant.
  
 
          Categories
        
                Parameter Groups
            
Files
| Name | Description | 
| FROMLIST | Input list of Themis PDS RDR files | 
| TOPATH | Output file pathname | 
Processing Options
| Name | Description | 
| NIGHT | Process night time IR image | 
| ATMOSCORR | Ignore the atmospheric correction (thmdriftcorr) | 
Output Information for input into GIS Software package
| Name | Description | 
| INFO | Output selected camera statistics infomation | 
| TOSTAT | Output filename for camera statistics output | 
| FOOTPRINT | Create a GML footprint of RDR image | 
File cleanup and reporting Option
| Name | Description | 
| RMINPUT | Remove the input file | 
| RMHIGHINC | Remove input files with high incidence angles | 
| HIGHINCLIST | Output list of files excluded because of high incidence
          angle | 
| NOFILELIST | Output list of files where there is no matching RDR | 
| NADIRSPCLIST | Output list of files that have Nadir pointing | 
| IMAGEGAPLIST | Output list of files that have gaps | 
Files:
                        FROMLIST
                         Description
                       
          List containing input filenames. The input files in this list need
          to be calibrated PDS formatted Themis RDR.
        
| Type | filename | 
| File Mode | input | 
| Filter | *.lis *.lst | 
 
Files:
                        TOPATH
                         Description
                       
          Output file pathname.  All output files will be written to this
          directory.
        
 
Processing Options:
                        NIGHT
                         Description
                       
          If checked, this option will process a night time image.  For night images 
          the program cosi will be skipped.
        
| Type | boolean | 
| Default | FALSE | 
 
Processing Options:
                        ATMOSCORR
                         Description
                       
          Do not perform the atmospheric correction with thmdriftcorr.  The step
	  will be skipped.
        
| Type | boolean | 
| Default | FALSE | 
 
Output Information for input into GIS Software package:
                        INFO
                         Description
                       
          A selected subset of camera statistics information required for the
	  geologic map bases are output for import into a spreadsheet.
        
| Type | boolean | 
| Default | FALSE | 
| Inclusions |  | 
 
Output Information for input into GIS Software package:
                        TOSTAT
                         Description
                       
          This is the output filename that will contain the camera statistics
	  information for import into a spreadsheet.
        
| Type | filename | 
| File Mode | output | 
| Default | None | 
| Filter | *.txt *.TXT | 
 
Output Information for input into GIS Software package:
                        FOOTPRINT
                         Description
                       
          A footprint polygon information will be output for input into a GIS
	  program.  This is normally required for the geologic base map 
	  packages, but not needed if the files will not be imported into
	  a GIS package.
        
| Type | boolean | 
| Default | TRUE | 
 
File cleanup and reporting Option:
                        RMINPUT
                         Description
                       
          If selected, delete input files after processing is completed.
        
| Type | boolean | 
| Default | FALSE | 
 
File cleanup and reporting Option:
                        RMHIGHINC
                         Description
                       
          If selected, delete input files that have a minimum incidence
	  angle greater than 90 degrees.
        
| Type | boolean | 
| Default | FALSE | 
| Inclusions |  | 
 
File cleanup and reporting Option:
                        HIGHINCLIST
                         Description
                       
          Output list file that will contain the names of files that 
          were deleted because of their high incidence angles.
        
| Type | filename | 
| File Mode | output | 
| Default | None | 
| Filter | *.lis *.lst | 
 
File cleanup and reporting Option:
                        NOFILELIST
                         Description
                       
          Output list file that will contain the names of files that 
          do not have matching RDR files for the EDR files.
        
| Type | filename | 
| File Mode | output | 
| Default | None | 
| Filter | *.lis *.lst | 
 
File cleanup and reporting Option:
                        NADIRSPCLIST
                         Description
                       
          Output list file that will contain the names of files that 
          have only Nadir pointing available to them.
        
| Type | filename | 
| File Mode | output | 
| Default | None | 
| Filter | *.lis *.lst | 
 
File cleanup and reporting Option:
                        IMAGEGAPLIST
                         Description
                       
          Output list file that will contain the names of files that 
          gaps meaning that special pixels were detected by the stats 
          program.
        
| Type | filename | 
| File Mode | output | 
| Default | None | 
| Filter | *.lis *.lst | 
 
              History
          
| Robert Sucharski | 2007-11-01 | Original version | 
| Ella Mae Lee | 2011-11-16 | Modified Isis::iApp->Exec to ProgramLauncher::RunIsisProgram
      Updated parameter for spiceinit and modified documentation | 
| Janet Barrett | 2012-01-03 | Cleaned up program and added tests. | 
| Janet Barrett | 2012-01-23 | Got rid of FROM parameter. The input file(s) must now be
      specified through the FROMLIST parameter. | 
| Lynn Weller | 2012-01-22 | Application category name changed from Utility to Mars Odyssey.  Fixes mantis ticket #951. |