Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions


ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


mappt

Standard View | TOC | Home

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
TOText file
FORMAT Output Format
APPEND Append Output to File

Position

Name Description
TYPECoordinate 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
IMAGEInterprets 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
GROUNDInterprets the coordinates as latitude/longitude This option interprets the coordinate as latitude/longitude and will compute sample/line and x/y

Exclusions

  • SAMPLE
  • LINE
  • X
  • Y
PROJECTIONInterprets 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.

Type double

Position: LINE

Description

This is the line position used to compute information about the camera state at the pixel.

Type double

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.

Type double

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.

Type double

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.

Type double

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.

Type double

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
  • COORDLIST

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

  • MAP

Inclusions

  • LATTYPE
  • LONDIR
  • LONDOM
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

  • LATTYPE
  • LONDIR
  • LONDOM

Inclusions

  • MAP

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 Anderson2003-02-05 Original version
Stuart Sides2003-11-07 Modified results pvl to not include the results group
Brendan George2005-11-21 Added application test
Elizabeth Miller2006-06-29 Changed name to mappt and made ui look like skypt and campt
Sean Crosby2007-04-12 Changed flatfile output so it duplicates PVL data. User now required to entered a flatfile name.
Steven Lambright2008-05-13 Removed references to CubeInfo
Steven Koechle2008-08-14 Added pixel value to the output group
Mackenzie Boyd2010-01-12 Modified output to include all coordinate systems for latitude and longitude and clearly declare the input files coordinate system. Improved documentation.
Mackenzie Boyd2010-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 Sucharski2012-12-06 Changed to use TProjection instead of Projection. References #775
Kimberly Oyama2013-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 Barrett2014-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.