ISIS Application Documentation
    Create a SOCET SET Framing Camera or USGSAstro FrameOffAxis settings file.
  
            Description
              Categories
              Groups
              History
          Description
        
    This is an ISIS to SOCET SET (trademark BAE Systems) translation program for Framing Camera
    images.  It calculates keyword values specific to SOCET SET's Framing Camera Settings files
    and generates the settings file for input to USGSAstro SOCET SET program 'import_frame.' 
    
    The input cube must be a "level1" image 
with SPICE data attached to the label (see
    spiceinit). 
    
    The following are supported instruments:
    
       CASSINI ISS
       CLEMENTINE 1 UVVIS
       GALILEO SSI
       MESSENGER NAC
       MESSENGER WAC
       OSIRIS-REX MapCam
       OSIRIS-REX PolyCam
       VIKING ORBITER
    
   
          Categories
        
Applications
                Parameter Groups
            
Files
| 
                    Name
                     | 
                    Description
                     | 
| FROM | 
          Filename of a "level 1" frame camera cube
         | 
| TO | SOCET SET Framing Camera Settings file | 
SOCET SET Parameters
| 
                    Name
                     | 
                    Description
                     | 
| SS_PROJECT | SOCET SET Project name | 
| SS_IMG_LOC | 
        Destination of SOCET SET images as shown in the first column of SOCET SET's location.list
        file
        | 
| SS_INPUT_PATH | 
          Full path to location of input images and Framing Camera settings files on the SOCET SET
          machine
         | 
| SS_CAM_CALIB_PATH | 
          Full path to SOCET SET's camera calibration directory
         | 
Files:
                        FROM
                         Description
                       
          Level 1 input Framing Camera cube with SPICE data attached. Supported instruments are
          CASSINI SSI, CLEMENTINE 1 UVVIS, GALILEO ISS, MESSENGER NAC, MESSENGER WAC,
          OSIRIS-REX MapCam, OSIRIS-REX PolyCam, and VIKING ORBITER.
        
| 
                             Type
                            | cube | 
| 
                               File Mode
                              | input | 
| 
                               Filter
                              | 
          *.cub
         | 
 
Files:
                        TO
                         Description
                       
          Output SOCET SET Framing Camera Settings file. This is a text file that must have a file
          extension of ".set." This file is one of the input files to USGSAstro SOCET SET program
          'import_frame.'
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | output | 
| 
                               Internal Default
                              | None | 
 
SOCET SET Parameters:
                        SS_PROJECT
                         Description
                       
          Name of the SOCET SET project that you will be importing this image into. Including the
          ".prj" extension is optional. As an example, for SOCET SET project named TEST, enter
          SS_PROJECT=TEST.
        
 
SOCET SET Parameters:
                        SS_IMG_LOC
                         Description
                       
          The "logical" location of the SOCET images as shown in the first column of SOCET SET
          internal database file DEVICE/location.list.
        
 
SOCET SET Parameters:
                        SS_INPUT_PATH
                         Description
                       
          Full path on SOCET SET machine where raw images (*.raw) and Framing Camera settings
          files (*.set) will reside for import into SOCET SET, with the ending file path
          delimiter included. This is typically in the SOCET SET project's images directory.
          
          
          Entering the file path delimiters (forward slash for UNIX systems, backslash for Windows
          systems) is straight forward when entering your path into the dialog box. However, special
          handling is required when running this program at the command line or in processing
          scripts.
          
          For SOCET SET running on Windows, an example input path would be
          E:\images\test
          To enter a path in the dialog box, enter the path as it normally appears. For this
          example, enter
          E:\images\test\
          To enter a path on the command line, or in a script, use the escape character (which is a
          backslash) to pass the delimiters to the program.  For this example, enter
          SS_INPUT_PATH=E:\\IMAGES\\TEST\\ 
        
 
SOCET SET Parameters:
                        SS_CAM_CALIB_PATH
                         Description
                       
          Full path to SOCET SET's internal database camera calibration directory, with the
          ending file path delimiter included.
          
          For SOCET SET running on Windows, an example path would be
          C:\SOCET_SET_5.6.0\internal_dbs\CAM
          To enter a path in the dialog box, enter the path as it normally appears. For this
          example, enter
          C:\SOCET_SET_5.6.0\internal_dbs\CAM\
          To enter a path on the command line, or in a script, use the escape character (which is a
          backslash) to pass the delimiters to the program.  For this example, enter
          SS_CAM_CALIB_PATH=C:\\SOCET_SET_5.6.0\\internal_dbs\\CAM\\ 
        
 
              History
          
| Philip Martinez | 2010-07-12 | 
      Original version
     | 
| Elpitha Howington-Kraus | 2010-10-14 | 
      Modified documentation in GUI. Changed OUPUTPNAME to INPUT_DATA_PATH, added CAM_CALIB_PATH
     | 
| O. Thomas | 2012-08-23 | 
      Renamed program from calc_frame_settingsfile to socetframesettings, restructured program to
      use SpiceRotation class, added Messenger, began modifications to meet ISIS coding standards.
     | 
| E. Howington-Kraus | 2013-02-25 | 
      Completed modifications to meet ISIS coding standards for formal installation into ISIS.
      Added check for needed SPICE data (blobs) attached to the cube label. Added parameter TO for
      user control over output settings file name (previously the program generated the output file
      name based on the base name of the FROM cube).  Temporarily removed support for APOLLO METRIC,
      MEX-SRC, and THEMIS-VIS sensors until testing can be completed.  References #1526.
     | 
| Raad A. Saleh | 2013-09-09 | 
      Added support for CLEMENTINE1 UVVIS instrument and updated documentation to reflect the
      changes. Reference #1749.
     | 
| Jeannie Backer | 2016-12-24 | 
      Added support for OSIRIS-REx instrument and updated documentation to reflect the
      changes. Fixes #3898.
     | 
| Brian Carcich | 2018-03-07 | 
      Fixed rotations for OSIRIS-REX instruments. Added documentation and cleaned up
      variable names. References #5235.
     | 
| Jesse Mapel | 2018-10-11 | 
      Changes to better match coding standards and clarify
      documentation. Added OREX test cases. References #5235.
     |