mappt

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
    

Description

Input cube which must have a Mapping group in the labels.

Type	cube
File Mode	input
Filter	*.cub

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

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.

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

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

Description

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

Type	double

Description

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

Type	double

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

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

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

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

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

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

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

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

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

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.

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.

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.