Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

campt

Computes geometric and photometric information at a given pixel location

Campt computes geometric and photometric information at a given pixel location or list of pixel locations in the input image cube. The program computes spacecraft and instrument related information, and other types of coordinates as described later in this document. The user will have a choice of coordinates in which to output the information as well as a choice in the output format of the information acquired.

Note the input image cube has preliminary requirements:

  • The input image requires SPICE information (see spiceinit).
  • The input image cube must be a Level0 or a Level1 ISIS cube.
  • To use a Level2 file as the input image (see mappt).

The point of interest in the image can be entered as Latitude/Longitude coordinates or Sample/Line coordinates. Keep in mind that the input Latitude and Longitude values entered will be interpreted as Universal Coordinates (ISIS default) regardless of the target body. In the output, all positions are in Body-Fixed Coordinates. Multiple points of interest may be specified by providing a comma-delimited flatfile of coordinates.

The following is a partial list of coordinates computed in the campt application:

Geometric Information: Latitude, Longitude, Oblique Detector Resolution, Line Resolution, Oblique Line Resolution

Photometric Information: Phase, Emission, and Incidence Angles

In addition, this application will return a list of other spacecraft, sun and instrument-related information including but not limited to Spacecraft Position, Spacecraft Azimuth, Sub-Spacecraft Longitude, SubSolar Latitude, SubSolar Longitude, and Time information (Ephemeris Time, UTC).

You may choose the format of the output file. The option list includes a choice of a PVL file or a flat file. A PVL file is a text file in label format, while the flat file is a comma-delimited text file that is easily imported into most databases and digital spreadsheets such as Microsoft Excel. Below is an example of campt output in PVL format. You can skim the left column of this PVL-formatted output file for a thorough listing of the types of coordinates, sun and instrument-related information computed when using campt. 

    Group = GroundPoint
      Filename = $ISISDATA/base/examples/ab102401.cub
      Sample = 1.0
      Line = 1.0
      PixelValue = 0.060781602
      RightAscension = 65.749350916052 <DEGREE>
      Declination = -18.390093214966 <DEGREE>
      PlanetocentricLatitude = 34.444810271419 <DEGREE>
      PlanetographicLatitude = 34.761015675467 <DEGREE>
      PositiveEast360Longitude = 223.82417212882 <DEGREE>
      PositiveEast180Longitude = -136.17582787118 <DEGREE>
      PositiveWest360Longitude = 136.17582787118 <DEGREE>
      PositiveWest180Longitude = 136.17582787118 <DEGREE>
      BodyFixedCoordinate = (-2015.8679290774, -1934.7810590267, 1916.3847207237) <km>
      LocalRadius = 3388160.511498 <meters>
      SampleResolution = 541.13773952742 <meters/pixel>
      LineResolution = 541.13773952742 <meters/pixel>
      ObliqueDetectorResolution = 172.33974835367 <meters>
      ObliquePixelResolution = 689.35899341468 <meters/pixel>
      ObliqueLineResolution = 689.35899341468 <meters>
      ObliqueSampleResolution = 689.35899341468 <meters>

      # Spacecraft Information
      SpacecraftPosition = (-2025.6211482473, -2130.1420376434, 2009.3189201922) <km>
      SpacecraftAzimuth = 359.99557293251 <DEGREE>
      SlantDistance = 216.55900507971 <km>
      TargetCenterDistance = 3560.6191399537 <km>
      SubSpacecraftLatitude = 34.35489567132 <DEGREE>
      SubSpacecraftLongitude = 226.44073262086 <DEGREE>
      SpacecraftAltitude = 171.90868675387 <km>
      OffNadirAngle = 36.15943479344 <DEGREE>
      Sub Spacecraft Ground Azimuth = 91.645191732289 <DEGREE>

      # Sun Information
      SunPosition = (-177337948.26395, 112957442.92463, -33704750.807723) <km>
      SubSolarAzimuth = 172.26878294333 <DEGREE>
      SolarDistance = 1.4234246106188 <AU>
      SubSolar Latitude = -9.1071701926796 <DEGREE>
      SubSolarLongitude = 147.50443336591 <DEGREE>
      SubSolarGroundAzimuth = 254.69133482343 <DEGREE>

      # Illumination and Other
      Phase = 120.59515634921 <DEGREE>
      Incidence = 84.169474229445 <DEGREE>
      Emission = 38.320209128441 <DEGREE>
      NorthAzimuth = 260.69077053256 <DEGREE>

      # Time
      EphemerisTime = -69382819.160519 <seconds>
      UT = 1997-10-20T10:58:37.6570806
      LocalSolarTime = 17.087982584194 <hour>
      SolarLongitude = 201.83052788083 <DEGREE>

      # Look Direction Unit Vectors in Body Fixed, J2000, and Camera Coordinate Systems.
      LookDirectionBodyFixed = (0.045037236693683, 0.90211431542542, -0.42914031413458)
      LookDirectionJ2000 = (0.3897534785179, 0.86519446501987, -0.3154849658576)
      LookDirectionCamera = (0.0040974504391656, 0.60456812815986,0.79654289860194)
    End_Group

Categories

Related Applications to Previous Versions of ISIS

This program replaces the following applications existing in previous versions of ISIS:
  • levpt
  • lev1pt
  • photostat

Related Objects and Documents

Applications

Documents

History

Jeff Anderson2005-02-04 Original version
Elizabeth Ribelin2005-06-20 Fixed bug in Latitude range
Jacob Danton2005-12-02 Added appTest
Jacob Danton2006-01-23 Fixed appTest to comply to changes in String
Elizabeth Miller2006-03-23 Fixed appTest files to comply with changes to all camera models
Elizabeth Miller2006-03-27 Modified to output a flatfile as well as a pvl, make GUI consistent with skypt
Elizabeth Miller2006-04-19 Added additional output
Elizabeth Miller2006-07-31 Modified to use OffNadirAngle instead of SpacecraftRoll angle due to changes made to the camera class
Sean Crosby2007-04-12 Added RightAscension and Declination to PVL output. Program now requires user to specify a filename when using FLAT option. Increased precision in flatfile output and updated appTest truthdata.
Steven Lambright2008-04-21 Added default values for the lines and samples
Steven Lambright2008-05-12 Removed references to CubeInfo
Steven Koechle2008-08-19 Removed unnecessary duplicate cube creation
Janet Barrett2008-11-15 Added SubSolarGroundAzimuth and SubSpacecraftGroundAzimuth to PVL output. The SubSolarGroundAzimuth is the clockwise angle on the ground between a line drawn from the ground point to the North pole of the body and a line drawn from the ground point to the subsolar point. The SubSpacecraftGroundAzimuth is defined similarly except it uses the subspacecraft point.
Steven Lambright2009-01-05 Added the ALLOWOUTSIDE option
Mackenzie Boyd2009-08-24 Modified to use new class CameraPointInfo
Mackenzie Boyd2009-09-14 Added missed functionality for defaulting to center sample/line
Tammy Becker2012-01-13 Modified documentation and added Glossary links
Janet Richie, Ella Mae Lee2012-11-20 Modified the documentation, fixes #1173
Lynn Weller2013-02-25 Removed links to applications imbedded in text and replaced with italicized application name. Added application links to the "Related Objects and Documents" section of the documentation. Fixes mantis ticket #1525.
Ian Humphrey2014-11-05 Added new parameters, USECOORDLIST, COORDLIST, and COORDTYPE for processing a list of points as input. Reorganized campt. Fixes #1449.
Ian Humphrey2015-03-03 Updated documentation. References #1449.
Tyler Wilson2016-08-17 Checked in new test data, and added support for changes made to the CameraPointInfo and Camera classes that incorporate new estimates for Pixel/Line/Sample/Detetctor resolution and now allow a developer to control the order in which fields are output in both PVL and CSV format. References #476, #4100.
Kaj Williams2017-06-13 Resolved issue where the default value for the "allowoutside" parameter was supposed to be set to "true", but the default _behavior_ of campt was instead consistent with a setting of "false". In addition, corrected behavior where manually setting "allowoutside" to "false" was ignored. Ref # 2258.
Kaitlyn Lee2018-02-16 Removed units on look direction vectors to make them unitless. Fixes #5125.
Kristin Berry, Jesse Mapel, and Stuart Sides2021-02-10 Modified to output Nulls when using a CSM Camera model and some values are not available.
Jacob Cain2026-04-21 Updated output table.

Parameters

Files

Input image, which requires SPICE (see spiceinit) and must be a Level0 or a Level1 ISIS cube.
Type cube
File Mode input
Filter *.cub

Selecting this parameter will enable the 'COORDLIST' and 'COORDTYPE' parameters in the GUI.

Note that this parameter is optional when running campt on the command line.

Type boolean
Default FALSE
Exclusions
  • TYPE
  • SAMPLE
  • LINE
  • LATITUDE
  • LONGITUDE
Inclusions
  • COORDLIST
  • COORDTYPE

An input comma-delimited flatfile of image coordinates or ground coordinates. This allows the program to process multiple coordinates in a single run of campt, and output the results to the specified output file.

Expected order for image coordinates: sample, line
Expected order for ground coordinates: latitude, longitude

The "Error" keyword will only appear when using a coordinate list. The value of "Error" will then be NULL unless an error occurs during the processing of a coordinate in the coordinate list. Then, the value of this keyword will be the error message. This allows for campt to continue processing the remaining coordinates in the coordinate list.

For the input of Latitude and Longitude, campt expects Planetocentric Latitude (within -90 to 90 boundary) and Positive East Longitude (with 0-360 boundary) to find the location in the input camera image.

Type filename
File Mode input
Internal Default None
Exclusions
  • TYPE
  • SAMPLE
  • LINE
  • LATITUDE
  • LONGITUDE

This parameter is used to select the type of coordinates entered in the coordinate list file, which will be used to determine the method to compute the geometric and photometric information.
Type string
Option List:
Option Brief Description
IMAGEInterprets coordinates in 'COORDLIST' as sample/line This option interprets the coordinates provided in the input coordinate list file as sample/line and will compute latitude/longitude and Projection x/y.
GROUNDInterprets the coordinates in 'COORDLIST' as latitude/longitude This option interprets the coordinates provided in the input coordinate list file as latitude/longitude and will compute sample/line and Projection x/y.
Exclusions
  • TYPE

A text file in label format (PVL) which will contain the results of campt. This file can be used in conjunction with the getkey application in order to pass the results to another program when developing scripts.
Type filename
File Mode output
Internal Default None

Format type for output file. PVL format is default.
Type string
Default PVL
Option List:
Option Brief Description
PVL PVL format Output file will be in PVL format
FLAT Flat file format Output file will be a comma-delimited flatfile. This file format can easily be imported into Excel.

If this option is selected, the output from the application will be appended to the output file. If it is not selected, any information in the 'TO' file will be overwritten.
Type boolean
Default TRUE

The Allowoutside parameter influences how campt will report resulting latitude/longitude and sample/line coordinates that fall outside the input cube pixel boundaries.

The default is set to True, which allows campt to return the values that are outside the cube pixel boundaries. For example, a given latitude/longitude might return a sample location of -1.0 (a single whole pixel coordinate off the left side of the image). This is a feature of the ISIS camera models.

When set to False, if a returned coordinate is off the image, campt will fail. This failure can be indicated and ignored within a batch script when only coordinates that fall within the image cube pixel boundaries are desired.

Type boolean
Default TRUE

The Allowerror parameter enables campt to return results despite any errors. Errors will be listed under "Error" in the result table, providing the user with information about points that may lack surface intersection.

By default, campt is set to False, causing it to throw an error if any occur.

If campt is set to True, errors will be displayed in the error section of the results table instead of being thrown.

Type boolean
Default FALSE

Position

This parameter is used to select the type of coordinate entered, which will be used to determine the method to compute the geometric and photometric information.
Type string
Default IMAGE
Option List:
Option Brief Description
IMAGEInterprets the coordinate as sample/line This option interprets the coordinate as sample/line and will compute latitude/longitude and Projection x/y.

Exclusions

  • LATITUDE
  • LONGITUDE
GROUNDInterprets the coordinates as latitude/longitude This option interprets the coordinate as latitude/longitude and will compute sample/line and Projection x/y.

Exclusions

  • LINE
  • SAMPLE

This is the Sample position used to compute information at a given pixel location in the input image cube.
Type double
Internal Default Center sample

This is the Line position used to compute information at a given pixel location in the input image cube.
Type double
Internal Default Center line

This is the Planetocentric Latitude (within -90 to 90 boundary) used to find the location in the input camera image.

Refer to Latitude Type.

Type double
Minimum -90.0 (inclusive)
Maximum 90.0 (inclusive)

This is the Positive East Longitude (with 0-360 boundary) used to find the location in the input camera image.

Refer to Longitude Direction and Longitude Domain.

Type double
Minimum 0.0 (inclusive)
Maximum 360.0 (inclusive)

Example 1

Sample/Line

Get photometric information at pixel (1, 1). TO (optional) specifies a label filename to save output to. FORMAT and APPEND are also used to specify output.

Command Line

campt from=ab102401.cub sample=1 line=1 to=campt_out.pvl

Example 2

Latitude/Longitude

Get photometric information at lat 0, lon 270. To use latitude and longitude, TYPE=GROUND must be specified.

Command Line

campt from=ctx.cub lat=0.0 lon=270.0 type=ground

Example 3

Coordinate List

Get photometric information for a series of points. The points should be in sample, line format for COORDTYPE=IMAGE (or lat, lon for COORDTYPE=GROUND). COORDTYPE is required when COORDLIST is used.
campt_coords.lis
2, 3 2, 13 12, 13 12, 3

Command Line

campt from=ab102401.cub coordlist=campt_coords.lis coordtype=image to=campt_out.pvl