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 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 Line/Sample 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.
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 End_Group CategoriesRelated Applications in Previous Versions of IsisThis application replaces the following applications existing in previous versions of Isis, which have been deprecated from the current version 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 |
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 |
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 about the input cube at the pixel.
Type | double |
---|---|
Internal Default | Center sample |
This is the Line position used to compute information about the input cube at the pixel.
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) |
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 |