ISIS 3 Application Documentation
campt | Printer Friendly View | TOC | Home |
Computes geometric and photometric information at a given pixel location
Overview | Parameters |
DescriptionCampt 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 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: 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 = /usgs/cpkgs/isis3/data/mgs/testData/ab102401.cub Sample = 1.0 Line = 1.0 PixelValue = 0.0607816 RightAscension = 65.749350916052 Declination = -18.390093214966 PlanetocentricLatitude = 34.444196777763 PlanetographicLatitude = 34.760399604837 PositiveEastLongitude = 223.84999971299 PositiveWestLongitude = 136.15000028701 BodyFixedCoordinate = (-2015.9595225544, -1936.6155808127, 1917.2574858384) <km> LocalRadius = 3389756.4767145 <m> SampleResolution = 536.05556350077 <m> LineResolution = 536.05556350077 <m> # Spacecraft Information SpacecraftPosition = (-2025.6211429076, -2130.1417975758, 2009.318879871) <km> SpacecraftAzimuth = 0.006855593033889 SlantDistance = 214.52515878961 <km> TargetCenterDistance = 3560.6189705415 <km> SubSpacecraftLatitude = 34.354896748841 SubSpacecraftLongitude = 226.44072947174 SpacecraftAltitude = 170.83335389965 <km> OffNadirAngle = 36.149255932304 SubSpacecraftGroundAzimuth = 91.64525294858 # Sun Information SunPosition = (-177337948.13839, 112957442.69098, -33704752.205292) <km> SubSolarAzimuth = 172.30460990873 SolarDistance = 1.4234246174889 <AU> SubSolarLatitude = -9.1071705738361 SubSolarLongitude = 147.50443340123 SubSolarGroundAzimuth = 254.69139701227 # Illumination and Other Phase = 120.59515694473 Incidence = 84.106289446623 Emission = 38.288719431206 NorthAzimuth = 261.46910874636 # Time EphemerisTime = -69382819.160519 <seconds> UTC = 1997-10-20T10:58:37.6570806 LocalSolarTime = 17.089704420784 <hour> SolarLongitude = 201.83159041209 Error = NULL End_Group Note: The "Error" keyword will only appear when using a coordinate list. The value of "Error" will 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. CategoriesRelated Applications to Previous Versions of ISISThis program replaces the following applications existing in previous versions of ISIS:
Related Objects and DocumentsApplicationsHistory
|
Parameter GroupsFiles
Position
|
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 |
|
Inclusions |
|
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 |
|
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: |
|
|||||||||
Exclusions |
|
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: |
|
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 |
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: |
|
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) |