ISIS Application Documentation
    Converts between sample/line and ra/ dec positions
  
 
          Description
        
    This program requires the user supply a "level 1" cube.  That is, a
    cube in raw camera geometry.
    The user must also enter one of the following coordinates:
     
     sample/line
      ra/dec
    
    The program will then compute the other coordinates and the ephemeris
    time and pixel dn value.
    
    Hint:  If you would like to use this program for multiple points, look into the
    -batchlist option.
    
   
 
          Categories
        
 
              History
          
| Elizabeth Miller | 2006-03-21 | 
      Original version
     | 
 
| Elizabeth Miller | 2006-03-31 | 
      Modified to output pvl and flat format files and added append option
     | 
 
| Elizabeth Miller | 2006-04-14 | 
      Added check for valid samp/line  and ra/dec positions
     | 
 
| Tracie Sucharski | 2006-04-21 | 
        Do not check error on SetImage, because there might not be an intersection
        on the planet when dealing with sky images.
     | 
 
| Sean Crosby | 2007-04-12 | 
      Changed flatfile output so it duplicates PVL data.  User now
      required to enter a flatfile name.
     | 
 
| Debbie A. Cook | 2012-07-06 | 
       Updated Spice members to be more compliant with Isis coding standards. References #972.
     | 
 
| Kelvin Rodriguez | 2016-06-27 | 
       Added functionality to compute celestial north clock angle, References #2365.
     | 
 
 
 | 
 
 
                Parameter Groups
            
Files
| 
                    Name
                     | 
                    Description
                     | 
 
| FROM | 
            Filename of a cube
           | 
 
| TO | 
          Output List
         | 
 
| FORMAT | 
          Output Format
         | 
 
| APPEND | 
          Append Output to File
         | 
 
 
Position
| 
                    Name
                     | 
                    Description
                     | 
 
| TYPE | Coordinate selection | 
 
| SAMPLE | 
          Sample position to report
         | 
 
| LINE | 
          Line position to report
         | 
 
| RA | 
          Right Ascension
         | 
 
| DEC | 
          Declination
         | 
 
 
 | 
 
Files:
                        FROM
                         Description
                       
            Input cube with appropriate camera labels
            (Instrument and kernel groups)
          
| 
                             Type
                            | cube | 
| 
                               File Mode
                              | input | 
| 
                               Filter
                              | 
              *.cub
           | 
 
 
Files:
                        TO
                         Description
                       
          The output list will be a text file and will contain the  filename,
         sample, line, ra, dec, et, and dn values.  The values will be written out
          in pvl or flat format, depending on what the user selects for the FORMAT
          parameter.
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | output | 
| 
                               Internal Default
                              | None | 
 
 
Files:
                        APPEND
                         Description
                       
          If this option is selected, the output from the application will be appended to the file.
          If it is not selected, any information in the TO file will be overwritten.  This option is
         selected by default.
        
| 
                             Type
                            | boolean | 
| 
                               Default
                              | TRUE | 
 
 
Position:
                        TYPE
                         Description
                       
          This parameter is used to select the type of coordinate which will be used to
          compute the other two remaining coordinates.
        
| 
                             Type
                            | string | 
| 
                               Default
                              | IMAGE | 
| 
                               Option List:
                              | 
| 
                                   Option | 
                                   Brief | 
                                   Description | 
 
| IMAGE | Interprets the coordinate as sample/line | 
              This option interprets the coordinate as sample/line and will
              compute teh right ascension/declination
            Exclusions
Inclusions
 | 
 
| SKY | Interprets the coordinates as ra/dec | 
              This option interprets the coordinate as right ascension/declination and will
              compute sample/line
            Exclusions
Inclusions
 | 
 
 
 | 
 
 
Position:
                        SAMPLE
                         Description
                       
            This is the sample position used to compute information about the camera state at the pixel.
        
 
Position:
                        LINE
                         Description
                       
            This is the line position used to compute information about the camera state at the pixel.
        
 
Position:
                        RA
                         Description
                       
            This is the right ascension value used to compute information about the camera state at the pixel.
        
 
Position:
                        DEC
                         Description
                       
            This is the declination value used to compute information about the camera state at the pixel.