Isis 3 Application Documentation
Outputs latitude/longitude at line/sample or reverse
Description
This program requires the user supply a "level 1" cube. That is, a
cube in raw camera geometry.
The user must also enter one of the following coordinates:
line/sample
latitude/longitude
The program will then compute the other coordinates and various other
spacecraft and instrument related information including but not limited to
the north azimuth, solar azimuth,
spacecraft azimuth, incidence angle, phase angle, emission angle, and
resolution. The following is an example of the output given when campt is ran:
Group = GroundPoint
Filename = /usgs/cpkgs/isis3/data/mgs/testData/ab102401.cub
Sample = 1.0
Line = 1.0
PixelValue = 0.0607816
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>
SpacecraftRoll = 0.22118085908063
# Sun Information
SunPosition = (-177337948.13839, 112957442.69098, -33704752.205292) <km>
SubSolarAzimuth = 172.30460990873
SolarDistance = 1.4234246174889 <AU>
SubSolarLatitude = -9.1071705738361
SubSolarLongitude = 147.50443340123
# 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
In the output, all positions are in body fixed coordinates. The
SubSpacecraftLatitude and SubSpacecraftLongitude
make up the subspacecraft point, which is the point on a body which
lies directly beneath the spacecraft. The SubSolarLatitude
and SubSolarLongitude make up the subsolar point, which
is the point on a body's refernce surface where a line from the body
center to the sun center intersects that surface. The
NorthAzimuth, SpacecraftAzimuth, and
SubSolarAzimuth are the values of the angle between a line
from the image center to the relative point (North pole, SubSpacecraft
Latitude/Longitude, SubSolar Latitude/Longitude respectively) and a
reference line in the image plane. The reference line is a horizontal
line from the image center to the middle right edge of the image. The
angles increase in a clockwise direction. The LocalSolarTime
is the time at the current longitude relative to the subsolar longitude,
which has a time of 12 o'clock. The SolarLongitude
is LSubS, or the seasonal angle.
Categories
Related Applications in Previous Versions of Isis
This application replaces the following
applications existing in previous versions of Isis, which have been deprecated
from the current version of Isis:
History
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
|
|
Parameter Groups
Files
Name
|
Description
|
FROM |
Filename of a cube
|
TO | Text file |
FORMAT |
Output Format
|
APPEND |
Append Output to File
|
Position
Name
|
Description
|
TYPE | Coordinate selection |
SAMPLE |
Sample position to report
|
LINE |
Line position to report
|
LATITUDE |
Latitude position
|
LONGITUDE |
Longitude position
|
|
Files:
FROM
Description
Input cube with appropriate camera labels
(Instrument and kernel groups)
Type
| cube |
File Mode
| input |
Filter
|
*.cub
|
Files:
TO
Description
A text file in label format which will contain
the results of this program. This file can
be used in conjunction with the "getkey" program
in order to pass the results to another program
when developing scripts.
Type
| filename |
File Mode
| output |
Internal Default
| None |
Files:
APPEND
Description
If this option is selected, the output from the application will be appended to the file.
If it is not selected, any information in the TO file will be overwritten.
Type
| boolean |
Default
| TRUE |
Position:
TYPE
Description
This parameter is used to select the type of coordinate which will be used to
compute the other two remaining coordinates.
Type
| string |
Default
| IMAGE |
Option List:
|
Option |
Brief |
Description |
IMAGE | Interprets the coordinate as sample/line |
This option interprets the coordinate as sample/line and will
compute latitude/longitude and x/y
Exclusions
|
GROUND | Interprets the coordinates as latitude/longitude |
This option interprets the coordinate as latitude/longitude and will
compute sample/line and x/y
Exclusions
|
|
Position:
SAMPLE
Description
This is the sample position used to compute infomration about the camera state at the pixel.
Type
| double |
Internal Default
| Center sample |
Position:
LINE
Description
This is the line position used to compute infomration about the camera state at the pixel.
Type
| double |
Internal Default
| Center line |
Position:
LATITUDE
Description
This is the planetocentric latitude to try to find in the camera image
Type
| double |
Minimum
| -90.0
(inclusive)
|
Maximum
| 90.0
(inclusive)
|
Position:
LONGITUDE
Description
This is the positive east longitude to try to find in the camera image
Type
| double |
Minimum
| 0.0
(inclusive)
|
Maximum
| 360.0
(inclusive)
|