ISIS Application Documentation
mappt | Standard View | TOC | Home |
Outputs latitude/longitude at line/sample or reverse
Description
Categories
Groups
History
line/sample latitude/longitude x/yThe 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
Name | Description |
---|---|
FROM | Filename of a cube |
TO | Text file |
FORMAT | Output Format |
APPEND | Append Output to File |
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 |
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 |
Input cube which must have a Mapping group in the labels.
Type | cube |
---|---|
File Mode | input |
Filter | *.cub |
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 |
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 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 which will be used to compute the other two remaining coordinates.
Type | string | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | IMAGE | ||||||||||||
Option List: |
|
This is the sample position used to compute information about the camera state at the pixel.
Type | double |
---|
This is the line position used to compute information about the camera state at the pixel.
Type | double |
---|
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.
Type | double |
---|
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.
Type | double |
---|
This is the x coordinate value used to compute the other coordinate values. It will be a projection X value in meters.
Type | double |
---|
This is the y coordinate value used to compute the other coordinate values. It will be a projection Y value in meters.
Type | double |
---|
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 |
|
Inclusions |
|
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 |
|
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 |
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: |
|
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 |
The latitude type for the projection. It can either be Planetocentric or Planetographic. PLANETOCENTRIC is the default.
Type | string | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Default | PLANETOCENTRIC | |||||||||
Option List: |
|
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: |
|
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: |
|
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. |
U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 03/21/2022 07:13:01 |