Isis 3 Application Documentation
campt | Standard View | TOC | Home |
Computes geometric and photometric information at a given pixel location
Description
Categories
Groups
History
Campt 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:
Geometric Information: Latitude, Longitude, 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 = /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
Name | Description |
---|---|
FROM | Input cube filename |
TO | Output text filename |
FORMAT | Output format (PVL or FLAT) |
APPEND | Option to append results to output file |
Name | Description |
---|---|
TYPE | Coordinate type selection (Image or Ground) |
SAMPLE | Sample position to report |
LINE | Line position to report |
LATITUDE | Latitude (planetocentric) position |
LONGITUDE | Longitude (Positive East 360) position |
ALLOWOUTSIDE | Allow sample/line values outside the image to be reported |
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 |
Jeff Anderson | 2005-02-04 | Original version |
Elizabeth Ribelin | 2005-06-20 | Fixed bug in Latitude range |
Jacob Danton | 2005-12-02 | Added appTest |
Jacob Danton | 2006-01-23 | Fixed appTest to comply to changes in String |
Elizabeth Miller | 2006-03-23 | Fixed appTest files to comply with changes to all camera models |
Elizabeth Miller | 2006-03-27 | Modified to output a flatfile as well as a pvl, make GUI consistent with skypt |
Elizabeth Miller | 2006-04-19 | Added additional output |
Elizabeth Miller | 2006-07-31 | Modified to use OffNadirAngle instead of SpacecraftRoll angle due to changes made to the camera class |
Sean Crosby | 2007-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 Lambright | 2008-04-21 | Added default values for the lines and samples |
Steven Lambright | 2008-05-12 | Removed references to CubeInfo |
Steven Koechle | 2008-08-19 | Removed unnecessary duplicate cube creation |
Janet Barrett | 2008-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 Lambright | 2009-01-05 | Added the ALLOWOUTSIDE option |
Mackenzie Boyd | 2009-08-24 | Modified to use new class CameraPointInfo |
Mackenzie Boyd | 2009-09-14 | Added missed functionality for defaulting to center sample/line |
Tammy Becker | 2012-01-13 | Modified documentation and added Glossary links |
Janet Richie, Ella Mae Lee | 2012-11-20 | Modified the documentation, fixes #1173 |
Lynn Weller | 2013-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. |