This application is for camera development and is not supported for general public use. See phocube for a public use application that performs similar processes. This program, camdev, creates backplane bands that contain photometric, geometric, and spacecraft instrument information for an image file. The parameter options range from photometric angles (incidence, emission, and phase) to various azimuth angles, and options based on spatial (latitude, longitude, and resolution) information. This program will not work on Level1 images without a camera model, or on mosaics. The input image pixels are not propagated to the output file unless the user selects the "DN" option. The following is a partial list of how users have made use of band output:

• Evaluate the individual bands in order to establish subsequent image processing steps
• Specify as input to other ISIS programs such as fx and photomet
• Demonstrate the result of each selected option
• Determine how the images are mosaicked together after the Level2 images are created from the Level1 images with backplanes

All ISIS applications default to the following geometric reference if a camera model exists:

• Longitude Domain = 360, longitude range reported from 0 to 360
• Latitude System = Ocentric
• Longitude Direction = East, longitude increases to the east

There are instances where the local emission angle and the local incidence angle will have values over 90 degrees. ISIS allows the computation of emission and incidence angles greater than 90 degrees. This feature allows representation of viewing and illumination conditions where there is actual target body surface data beyond the limb or deep terminator boundary areas. Applications such as photomet that applies photometric functions honor the 90 degree boundary. Applications such as photrim can be applied to the camdev output to replace the angle values above 90 degrees to NULL. There are certain processes that need these data, therefore it is allowed.

This program requires a Level1 file that has a successful "spiceinit" applied to it, or a Level2 image cube file. For every valid input pixel, an output pixel is computed based on either the SPICE information, or the map projected spatial information, or a pre-defined equation.

The parameters "morphology" and "albedo" are specifically designed to be used by the ISIS mosaic programs. A mosaic program will automatically compare two pixel values to determine how each pixel is mosaicked into an output file, which depends on whether a morphology-based or an albedo-based product is desired. The program computes a DN value for every input pixel based on the formulas listed below and outputs the value to a backplane band. These backplane bands are used by the ISIS mosaic programs. The following are equations for "morphology" and "albedo" options:

Morphology

Equation = PixelResolution/cos(EmissionAngle)

Albedo

Equation = PixelResolution * [(1/cos(EmissionAngle)) + (1/cos(IncidenceAngle))]

All the options in camdev are applicable if the input file is a Level1 image and has a camera model associated with the file. If the input file is a map-projected Level2 image, only a few options are appropriate and available for selection.

The following options are available for Level1 images that contain a camera model:

• DN
• RADEC
• PLANETOCENTRICLATITUDE
• PLANETOGRAPHICLATITUDE
• POSITIVEEAST360LONGITUDE
• POSITIVEEAST180LONGITUDE
• POSITIVEWEST360LONGITUDE
• POSITIVEWEST180LONGITUDE
• BODYFIXED
• LOCALRADIUS
• PIXELRESOLUTION
• LINERESOLUTION
• SAMPLERESOLUTION
• DETECTORRESOLUTION
• SPACECRAFTPOSITION
• SPACECRAFTAZIMUTH
• SLANTDISTANCE
• TARGETCENTERDISTANCE
• SUBSPACECRAFTLATITUDE
• SUBSPACECRAFTLONGITUDE
• SUBSPACECRAFTGROUNDAZIMUTH
• SPACECRAFTALTITUDE
• OFFNADIRANGLE
• SUNPOSITION
• SUNAZIMUTH
• SOLARDISTANCE
• SUBSOLARLATITUDE
• SUBSOLARLONGITUDE
• SUBSOLARGROUNDAZIMUTH
• PHASE
• EMISSION
• INCIDENCE
• LOCALEMISSION
• LOCALINCIDENCE
• NORTHAZIMUTH
• DISTORTEDFOCALPLANE
• UNDISTORTEDFOCALPLANE
• EPHEMERISTIME
• UTC
• LOCALSOLARTIME
• SOLARLONGITUDE
• MORPHOLOGYRANK
• ALBEDORANK

• DN
• RADEC
• PLANETOCENTRICLATITUDE
• POSITIVEEAST360LONGITUDE
• PIXELRESOLUTION
• DISTORTEDFOCALPLANE
• UNDISTORTEDFOCALPLANE
• EPHEMERISTIME
• UTC
• SPACECRAFTPOSITION

The BandBin group keywords are updated in the labels of the output cube file. The keyword "Name" within the BandBin group, shown below, is populated with the name of each option selected by the user as bands. These bands can be referenced by their names in applications such as "mapmos" and "qview."

    Example:

    camdev from=EW0131773041G_cal.cub to=EW0131773041G_cal.pho.cub morph=true dn=true

    Sample of image label:

    Group = Dimensions
      Samples = 1024
      Lines   = 1024
      Bands   = 7 
    End_Group
    
    Group = BandBin
      Name   = ("750 BW 5", "Phase Angle", "Emission Angle", "Incidence Angle",
        	Latitude, Longitude, Morphology)
      Number = (7, 7, 7, 7, 7, 7, 7)
      Center = (748.7, 748.7, 748.7, 748.7, 748.7, 748.7, 748.7)
      Width  = (5.1, 5.1, 5.1, 5.1, 5.1, 5.1, 5.1)
    End_Group
    

    Note:  The first band retained the BandBin Name value from the input file.
    The program has "Phase Angle," "Emission Angle," "Incidence Angle,"
    "Latitude," and "Longitude" options pre-selected.
    

If the backplane bands generated by camdev are used in the mosaic programs and the mosaic requires the input image pixel, the "DN" parameter name must be set to "true" in camdev. When backplane bands are used in the "fx" or "photomet" program, it is not necessary to propagate the input image to the output file.