ISIS Application Documentation
Outputs latitude/longitude at line/sample or reverse
Description
Categories
Groups
History
Description
This program requires the user supply a cube in a map projection.
The user must also enter one of the following coordinates:
line/sample
latitude/longitude
x/y
The program will then compute the other two coordinates. For example,
entering a line/sample will cause the program to compute a latitude/longitude
and x/y. The output can be sent to a text file using the TO parameter and can
be read in a script via the "getkey" program.
Example output:
Group = Results
Filename = /home/mboyd/mapped.cub
Sample = 400.0
Line = 400.0
PixelValue = Null
X = 36094.582198722
Y = -2602604.7032335
# Input map coordinate system
PlanetocentricLatitude = -85.828401770565
PositiveEast180Longitude = 26.807891885122
# Location in other coordinate systems
PlanetographicLatitude = -85.828401770565
PositiveEast360Longitude = 26.807891885122
PositiveWest360Longitude = 333.19210811488
PositiveWest180Longitude = -26.807891885122
End_Group
Categories
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
|
LINE |
Line Position
|
LATITUDE |
Latitude Value
|
LONGITUDE |
Longitude value
|
X |
X coordinate
|
Y |
Y coordinate
|
USECOORDLIST |
Enable coordinate list parameters in the GUI
|
COORDLIST |
Input comma-delimited file of image or ground coordinates
|
ALLOWOUTSIDE |
Allow sample/line values outside the image to be reported
|
Coordinate System
Name
|
Description
|
COORDSYS |
The coordinate system of the input latitude and longitude.
|
MAP |
File containing mapping parameters
|
LATTYPE |
Latitude type
|
LONDIR |
Longitude Direction
|
LONDOM |
Longitude Domain
|
Files:
FROM
Description
Input cube which must have a Mapping group in the labels.
Type
| cube |
File Mode
| input |
Filter
|
*.cub
|
Files:
TO
Description
A text file 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 if the PVL
format is selected.
Type
| filename |
File Mode
| output |
Internal Default
| None |
Files:
FORMAT
Description
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 |
FlatFile Format
|
Output file will be a comma deliminated flatfile. This file format can easily be
imported into excel.
|
|
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
- LATITUDE
- LONGITUDE
- X
- Y
- COORDSYS
- LATTYPE
- LONDIR
- LONDOM
- MAP
|
GROUND | Interprets the coordinates as latitude/longitude |
This option interprets the coordinate as latitude/longitude and will
compute sample/line and x/y
Exclusions
|
PROJECTION | Interprets the coordinate as x/y |
This option interprets the coordinate as x/y and will
compute sample/line and latitude/longitude
Exclusions
- SAMPLE
- LINE
- LATITUDE
- LONGITUDE
- LATTYPE
- LONDIR
- LONDOM
- MAP
- COORDSYS
|
|
Position:
SAMPLE
Description
This is the sample position used to compute information about the camera state at the pixel.
Position:
LINE
Description
This is the line position used to compute information about the camera state at the pixel.
Position:
LATITUDE
Description
This is the latitude value used to compute the other coordinate values. The latitude
will be interpreted as either Planetographic or Planetocentric
latitude depending on the option selected under coordinate system.
Position:
LONGITUDE
Description
This is the longitude value used to compute the other coordinate values. The longitude
will be interpreted as either PositiveEast or PositiveWest longitude
and -180 to 180 or 0 to 360 domain depending on the option selected
under coordinate system.
Position:
X
Description
This is the x coordinate value used to compute the other coordinate values. It
will be a projection X value in meters.
Position:
Y
Description
This is the y coordinate value used to compute the other coordinate values. It
will be a projection Y value in meters.
Position:
USECOORDLIST
Description
Selecting this parameter will enable the 'COORDLIST' parameter in the
GUI.
Note that this parameter is optional when running mappt on the
command line.
Type
| boolean |
Default
| FALSE |
Exclusions
|
- SAMPLE
- X
- Y
- LINE
- LATITUDE
- LONGITUDE
|
Inclusions
|
|
Position:
COORDLIST
Description
An input comma-delimited flatfile of image, ground or projection coordinates.
This allows the program to process multiple coordinates in a single run of mappt,
and output the results to the specified output file.
Expected order for image coordinates: sample, line
Expected order for ground coordinates: latitude, longitude
Expected order for projection coordinates: X, Y
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 mappt to continue processing the remaining coordinates in the coordinate
list.
For the input of Latitude and Longitude, mappt 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
|
- SAMPLE
- LINE
- X
- Y
- LATITUDE
- LONGITUDE
|
Position:
ALLOWOUTSIDE
Description
The Allowoutside parameter influences how mappt 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 mappt 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,
mappt 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 |
Coordinate System:
COORDSYS
Description
This is the coordinate system the input latitude and longitude will be
interpreted in. There are eight possible options with the variation of
planetocentric or planetographic, positive east or west, 180 to -180
range or 0 to 360.
Type
| string |
Default
| INPUTFILESYS |
Option List:
|
Option |
Brief |
Description |
INPUTFILESYS |
Use coordinate system of input file
|
This option uses the coordinate system of the input cube, this
could be any of eight possibilities. This is the default behavior.
Exclusions
- LATTYPE
- LONDIR
- LONDOM
- MAP
|
UNIVERSAL |
Isis default
|
The Isis default coordinate system of planetocentric, positive
east, domain 0 to 360.
Exclusions
- LATTYPE
- LONDIR
- LONDOM
- MAP
|
USERDEFINED |
User defined coordinate system
|
Accepts latitude and longitude in a user defined coordinate
system, any of eight possible combinations.
Exclusions
Inclusions
|
MAP |
Use mapping group from other file
|
The mapping group of the given file is read in to convert from its
system to universal to be set in the input cube's projection.
Exclusions
Inclusions
|
|
Coordinate System:
MAP
Description
This file can be a cube or a simple hand produced map file. This file
must contain a maping group and is how the coordinate system will be
determined if selected.
Type
| filename |
File Mode
| input |
Filter
|
*.map *.cub
|
Coordinate System:
LATTYPE
Description
The latitude type for the projection. It can either be Planetocentric or Planetographic.
PLANETOCENTRIC is the default.
Type
| string |
Default
|
PLANETOCENTRIC
|
Option List:
|
Option |
Brief |
Description |
PLANETOCENTRIC |
Planetocentric
|
Sets the latitude type of the input to be interpreted as
Planetocentric.
|
PLANETOGRAPHIC |
Planetographic
|
Sets the latitude type of the input to be interpreted as
Planetographic.
|
|
Coordinate System:
LONDIR
Description
The longitude direction for the projection. It can have a direction of Positive East
or Positive West. POSITIVEEAST is the default.
Type
| string |
Default
|
POSITIVEEAST
|
Option List:
|
Option |
Brief |
Description |
POSITIVEEAST |
PositiveEast Longitude Direction
|
Sets the longitude direction of the input to be interpreted as
PositiveEast.
|
POSITIVEWEST |
PositiveWest Longitude Direction
|
Sets the longitude direction of the input to be interpreted as
PositiveWest.
|
|
Coordinate System:
LONDOM
Description
The longitude domain for the projection. It can either have a domain
of 180 or 360. 360 is the default.
Type
| string |
Default
|
360
|
Option List:
|
Option |
Brief |
Description |
360 |
0 to 360 Degree Longitude Domain
|
Sets the longitude domain of the input to be intrepreted as 0 to
360 degrees.
|
180 |
-180 to 180 Degree Longitude Domain
|
Sets the longitude domain of the input to be interpreted as 0 to
180 degrees.
|
|
History
Jeff Anderson | 2003-02-05 |
Original version
|
Stuart Sides | 2003-11-07 |
Modified results pvl to not include the results group
|
Brendan George | 2005-11-21 |
Added application test
|
Elizabeth Miller | 2006-06-29 |
Changed name to mappt and made ui look like skypt and campt
|
Sean Crosby | 2007-04-12 |
Changed flatfile output so it duplicates PVL data. User now
required to entered a flatfile name.
|
Steven Lambright | 2008-05-13 |
Removed references to CubeInfo
|
Steven Koechle | 2008-08-14 |
Added pixel value to the output group
|
Mackenzie Boyd | 2010-01-12 |
Modified output to include all coordinate systems for latitude and
longitude and clearly declare the input files coordinate system. Improved
documentation.
|
Mackenzie Boyd | 2010-02-16 |
Added many parameters accesible when inputing a lat lon, all under
coordinate system. These parameters are to select the input coordinate
system being used. Updated documentation to match.
|
Tracie Sucharski | 2012-12-06 |
Changed to use TProjection instead of Projection. References #775
|
Kimberly Oyama | 2013-11-22 |
Changed the order in which the keywords are output to the csv, not the pvl, so it no longer
depends on the coordinate system of the input cube. Fixes #1614.
|
Janet Barrett | 2014-08-04 |
Added new parameter, ALLOWOUTSIDE, to control the reporting of latitude/longitude
and line/sample information that falls outside the boundaries of the image. Also
added a message to the output results if the line,sample falls outside the image
boundaries, regardless of the setting of the ALLOWOUTSIDE parameter. This will
help the user detect results that fall outside the image even if they are allowing
for it. Fixes #1929.
|