ISIS Application Documentation
    Processes a MOC image through Levels 0, 1, and/or 2
  
            Description
              Categories
              Groups
              History
          Description
        
    
    Runs Mars Global Surveyer, Mars Obital Camera (MGS/MOC) images through the
    applications necessary to create a map projected product. There are three
    stages of processing, ingestion, calibration, and mapping. Each stage can
    be disabled and runs all the programs necessary to complete that stage if
    not disabled.
    
    
    All intermediate files will be generated in the users Isis temporary
    directory and deleted after they are no longer needed. In case of a catastrophic
    failure the intermediate files should be deleted.
    
   
          Categories
        
                Parameter Groups
            
Files
| 
                    Name
                     | 
                    Description
                     | 
| FROM | 
          Input MOC EDR, Level0, or Level1 image file
         | 
| TO | 
            Final output filename.
           | 
Level Processing
| 
                    Name
                     | 
                    Description
                     | 
| Ingestion | 
          Import and initialize a moc EDR or RDR file.
         | 
| Calibration | 
          Process the input file through the calibration phase.
         | 
| Mapping | 
          Process the input file through the map phase.
         | 
Ingestion Parameters
| 
                    Name
                     | 
                    Description
                     | 
| PCK | 
          User defined target attitude and shape kernel file.
         | 
| CK | 
          User defined spacecraft pointing kernel file.
         | 
| SPK | 
          User defined spacecraaft position kernel file.
         | 
| CKNADIR | 
          Compute nadir pointing if no other kernels exist
         | 
| SHAPE | 
          Select the definition of the shape model for spiceinit
         | 
| MODEL | 
          User defined ISIS cube shape model.
         | 
Mapping parameters
| 
                    Name
                     | 
                    Description
                     | 
| MAP | 
          File containing mapping parameters
         | 
| PIXRES | Pixel resolution in meters | 
Files:
                        FROM
                         Description
                       
          Input filename. This file can be in one of four stages. A compressed
          PDS formatted MOC EDR, an uncompressed PDS formatted MOC EDR,
          a Level0 Isis cube with a complete kernels group in its label, or a
          Level1 radiometriclly calibrated Isis cube.
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | input | 
| 
                               Filter
                              | 
          *.imq *.img
         | 
 
Files:
                        TO
                         Description
                       
            Output filename from the last enabled processing sequence. By
            default the filename will be generated from the input filename with
             ".lev#" appended to the name, where "#" is the last level of
             processing (i.e., INGESTION = "lev0", CALIBRATION = "lev1",
             or MAPPING = "lev2").
          
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | output | 
| 
                               Internal Default
                              | Automatic | 
 
Level Processing:
                        Ingestion
                         Description
                       
          Process the input file through all level0 steps. This includes "moc2isis" and "
          spiceinit".
          "moc2isis" will uncompress a compressed EDR automatically.
        
| 
                             Type
                            | boolean | 
| 
                               Default
                              | 
          YES
         | 
| 
                               Inclusions
                              | 
 | 
 
Level Processing:
                        Calibration
                         Description
                       
          Process the input file through level1. This includes moccal,
          mocnoise50, and mocevenodd,
        
 
Level Processing:
                        Mapping
                         Description
                       
          Process the input file through level2. This include cam2map.
        
| 
                             Type
                            | boolean | 
| 
                               Default
                              | 
          YES
         | 
| 
                               Inclusions
                              | 
 | 
 
Ingestion Parameters:
                        PCK
                         Description
                       
          Naif kernel file to be used for the target attitude and shape.
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | input | 
| 
                               Default Path
                              | 
          $BASE/kernels/pck/
         | 
| 
                               Internal Default
                              | none | 
| 
                               Inclusions
                              | 
 | 
 
Ingestion Parameters:
                        CK
                         Description
                       
          Naif kernel file to be used for the spacecraft pointing.
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | input | 
| 
                               Default Path
                              | 
          $MGS/kernels/ck/
         | 
| 
                               Internal Default
                              | none | 
| 
                               Inclusions
                              | 
 | 
 
Ingestion Parameters:
                        SPK
                         Description
                       
          Naif kernel file to be used for the spacecraft position.
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | input | 
| 
                               Default Path
                              | 
          $MGS/kernels/spk/
         | 
| 
                               Internal Default
                              | none | 
| 
                               Inclusions
                              | 
 | 
 
Ingestion Parameters:
                        CKNADIR
                         Description
                       
          Compute nadir pointing if no other kernels exist
        
| 
                             Type
                            | boolean | 
| 
                               Default
                              | false | 
 
Ingestion Parameters:
                        SHAPE
                         Description
                       
	    ISIS camera models can use a shape model (a projected ISIS cube that defines 
	    the radii for a global or regional area).  You can choose
            to select a shape model or to use the definition of the ellipsoid found 
	    in the planetary constants (PCK) file.
        
| 
                             Type
                            | string | 
| 
                               Default
                              | SYSTEM | 
| 
                               Option List:
                              | 
| 
                                   Option | 
                                   Brief | 
                                   Description | 
 
| ELLIPSOID | Use triiaxial ellipsoid from PCK | 
		The camera will use the radii defined in the planetary constants file (PCK) 
		when determining intersections of the body surface
	    Exclusions
 | 
 
| SYSTEM | Search system for a default shape model | 
		This option will search the default system data area ($ISISDATA/base/dems) 
		for a shape model that matches the target of the input cube.  If none are
                found then no shape model will be used and the default ellipsoid parameters 
		found in the planetary constants (PCK) file define the shape.
            Exclusions
 | 
 
| USER | User specified shape model file | 
		The camera will use shape model defined by the parameter MODEL
	     | 
 
 
 | 
| 
                               Inclusions
                              | 
 | 
 
Ingestion Parameters:
                        MODEL
                         Description
                       
	    A map projected ISIS cube which contains the radii of the target.  The file 
	    can cover more than the input cube
            (FROM) but must minimally cover the data in the input cube.
        
| 
                             Type
                            | cube | 
| 
                               File Mode
                              | input | 
| 
                               Default Path
                              | $base/dems/ | 
| 
                               Filter
                              | *.cub | 
 
Mapping parameters:
                        MAP
                         Description
                       
          A file containing the desired output mapping parameters in PVL form.  This
          file can be a simple hand produced label file.  It can also be an existing cube
          label which contains a Mapping group.
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | input | 
| 
                               Internal Default
                              | Sinusoidal | 
| 
                               Inclusions
                              | 
 | 
| 
                               Filter
                              | *.map | 
 
Mapping parameters:
                        PIXRES
                         Description
                       
          Specifies the resolution in meters per pixel. If not
          entered the resolution will 
          be obtained from the MAP file.
          If not in the MAP file the resolution will be computed from
          the input camera cube.
        
| 
                             Type
                            | double | 
| 
                               Internal Default
                              | Automatic | 
| 
                               Minimum
                              | 0.0
                                   (exclusive)
                                  | 
| 
                               Inclusions
                              | 
 | 
 
              History
          
| Eric Eliason | 2001-01-01 | 
      Original version
     | 
| Stuart Sides | 2004-01-16 | 
      Converted from Perl to C++ for conversion to Isis 3.0
     | 
| Jeff Anderson | 2004-02-27 | 
      Added extra error messages
     | 
| Jeff Anderson | 2004-03-01 | 
      Made use of the IsisProcessExecutable class
     | 
| Jacob Danton | 2006-02-08 | 
      Fixed a filename bug that occured with the no mapping option and crosstrackSumming not equal to 1.
     | 
| Elizabeth Miller | 2006-05-18 | 
      Fixed UI and parameters to be consistent with changes made to spiceinit
     | 
| Elizabeth Miller | 2006-07-25 | 
      Removed the AUTOLON parameter (no longer an option in cam2map)
     | 
| Brendan George | 2006-09-26 | 
        Documentation fixes
     | 
| Elizabeth Miller | 2006-09-28 | 
      Fixed PIXRES handling issue caused by changes in cam2map
     | 
| Steven Lambright | 2006-11-06 | 
      Added CKNADIR functionality
     | 
| Steven Lambright | 2008-05-13 | 
      Removed references to CubeInfo 
     | 
| Steven Lambright | 2008-10-27 | 
      This program now uses the Pipeline class to accomplish its processing.
      The 'Map' parameter now actually accepts projected cubes, as the documentation
      specifies. In the past, an error would be thrown if a cube was specified. The 'Map'
      parameter is also now set to be an input, as it is not being modified. This program also
      ran "cam2map" with "DEFAULTRANGE=CAMERA," but is now using the default (MINIMIZE).
     |