ISIS Application Documentation
    Convert camera image to a different camera image
  
 
          Description
        
      This program will convert a input camera cube to a different camera geometry.  For example, given overlapping MGS MOC and Odyssey Themis cubes,
      this program can convert the MOC image to have the same geometric camera characteristics as the Themis cube (or vice versa).  Another use is to align
      bands in a camera cube which has independent bands.  For example, a raw Themis cube (after thm2isis) will not have aligned pixels.  This program can
      be used to align the pixels without going to a map projection.  To prevent pixels from falling off the edge of the cube you can run pad on the cube prior to
      this program.
     
 
          Categories
        
 
            Related Applications to Previous Versions of ISIS
          
          This program replaces the following
          
            application
            
          existing in previous versions of ISIS:
          
 
              History
          
| Jeff Anderson | 2000-05-10 | 
      Original version
     | 
 
| Jeff Anderson | 2004-01-19 | 
      Converted to Isis 3.0
     | 
 
| Jacob Danton | 2005-12-05 | 
      Added an appTest.
     | 
 
| Elizabeth Miller | 2006-03-23 | 
      Fixed appTest to reflect changes in all camera models
     | 
 
| Debbie A. Cook | 2007-06-21 | 
       Corrected setting of output file labels so that the Spice comes from the match cube and not the input cube
      | 
 
| Steven Lambright | 2007-06-22 | 
       Fixed typo in documentation
      | 
 
| Steven Lambright | 2008-01-23 | 
       Fixed an access on an invalid pointer that caused segmentation faults on
       cubes in which the camera is band-dependant.
      | 
 
| Jeff Anderson | 2008-02-12 | 
       Fixed problems with reference bands on band-dependent instruments
      | 
 
| Steven Lambright | 2008-05-12 | 
          Removed references to CubeInfo
     | 
 
| Jesse Mapel | 2018-05-17 | 
          Changed transform to use the local radius computed by the output camera instead of
          having the input camera re-compute it (sometimes incorrectly) from the latitude and
          longitude. Fixes #5425.
     | 
 
 
 | 
 
 
                Parameter Groups
            
Files
| 
                    Name
                     | 
                    Description
                     | 
 
| FROM | 
          Input camera cube
         | 
 
| MATCH | 
          Instrument cube to match
         | 
 
| TO | 
          Output cube
         | 
 
 
Options
| 
                    Name
                     | 
                    Description
                     | 
 
| REFBAND | Reference Band | 
 
| INTERP | Type of interpolation | 
 
 
 | 
 
Files:
                        FROM
                         Description
                       
            The camera cube which will be modified
        
| 
                             Type
                            | cube | 
| 
                               File Mode
                              | input | 
| 
                               Filter
                              | 
          *.cub
         | 
 
 
Files:
                        MATCH
                         Description
                       
            This is the camera cube which will be matched.  It must be only one band so use the input attributes to select the band to match.  For example,
            themis.cub+5.
        
| 
                             Type
                            | cube | 
| 
                               File Mode
                              | input | 
| 
                               Filter
                              | 
          *.cub
         | 
 
 
Files:
                        TO
                         Description
                       
          The resultant cube which will have the same camera geometry and image size as the match cube.
        
| 
                             Type
                            | cube | 
| 
                               File Mode
                              | output | 
| 
                               Filter
                              | 
          *.cub
         | 
 
 
Options:
                        REFBAND
                         Description
                       
            This is the reference band to be used in the MATCH cube.
            That is, all bands in the FROM cube will be matched to
            this band.  The default is to use the middle band; however,
            the user can enter any band number which is valid for the
            instrument, regardless of whether the band is in the cube
            or not.
            This only applies to band dependent camera models such as
            Themis.
        
| 
                             Type
                            | integer | 
| 
                               Internal Default
                              | middle | 
| 
                               Minimum
                              | 1
                                   (inclusive)
                                  | 
 
 
Options:
                        INTERP
                         Description
                       
          This is the type of interpolation to be performed on the input.
        
| 
                             Type
                            | string | 
| 
                               Default
                              | 
          CUBICCONVOLUTION
         | 
| 
                               Option List:
                              | 
| 
                                   Option | 
                                   Brief | 
                                   Description | 
 
| NEARESTNEIGHBOR | Nearest Neighbor | 
              Each output pixel will be set to the pixel nearest the
              calculated input pixel.
             | 
 
| BILINEAR | Bi-Linear interpolation | 
              Each output pixel will be set to the value calculated by
              a bi-linear interpolation of the calculated input pixel.
             | 
 
| CUBICCONVOLUTION | Cubic Convolution interpolation | 
              Each output pixel will be set to the value calculated by
              a cubic convolution interpolation of the calculated input pixel.
             | 
 
 
 |