ISIS Application Documentation
    Mars Odyssey Themis RDR image cleanup
  
 
          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 isis 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
        
 
              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.
     | 
 
 
 | 
 
 
                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 | 
 
 
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
         |