ISIS 3 Application Documentation
Outputs ring radius/longitude at line/sample or reverse
Description
The ringsmappt application computes various coordinate formats using
a map-projected cube.
The following table shows input parameters and the resulting coordinates
that will be computed:
Input Parameters |
Coordinates Computed |
Line and sample |
Ring radius, ring longitude, X, and Y |
Ring radius and ring longitude |
Line, sample, X, and Y |
X and Y |
Line, sample, ring radius, and ring longitude |
The output options are the following:
- Display to the screen only
- PVL format text file
- Comma delimited text file or flat file
The output file (TO) can be used as input to extract keyword values with a script via the getkey program.
Below is an example of the command line to execute the program, and the results that show the keywords and
the computed values:
ringsmappt from=W1591159850_1_cal.lev2.cub sample=1024 line=1024
Group = Results
Filename = W1591159850_1_cal.lev2.cub
Sample = 1024.0
Line = 1024.0
PixelValue = 2.9266113e+11
X = -58752169.950728
Y = -83725336.55945
RingRadius = 102282693.82409
# Input map direction/domain for ring longitude.
CounterClockwise360RingLongitude = 234.9416974425
Clockwise360RingLongitude = 125.0583025575
CounterClockwise180RingLongitude = -125.0583025575
Clockwise180RingLongitude = 125.0583025575
End_Group
The user can specify how the program interprets the rings longitude domain
and rings longitude direction by defining the coordinate system parameters (COORDSYS).
The ring longitude direction can be set to clockwise or counterclockwise.
Categories
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 enter 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 accessible when inputting a lat and 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
|
Debbie A. Cook | 2013-02-25 |
Changed to work for ring plane projections. References #775
|
Jeannie Backer | 2013-03-12 |
Added appTests. Test coverage 96% scope, 94% line, 67% function.
Function coverage is low since there are GUI helper methods.
|
Ella Mae Lee | 2013-12-24 |
Updated user documentation, fixes #1934.
|
|
Parameter Groups
Files
Name
|
Description
|
FROM |
Filename of a projected cube
|
TO | Output text file |
FORMAT |
Output format
|
APPEND |
Append result to output file
|
Position
Coordinate System
Name
|
Description
|
COORDSYS |
The coordinate system of the ring radius and ring longitude
|
MAP |
File containing mapping parameters
|
RINGLONDIR |
Ring Longitude direction
|
RINGLONDOM |
Ring Longitude domain
|
|
Files:
FROM
Description
Specify an input cube that contains Mapping group keywords in the labels.
Type
| cube |
File Mode
| input |
Filter
|
*.cub
|
Files:
TO
Description
Output filename that contains the results of ringsmappt. This file can
be used in conjunction with the getkey program 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:
APPEND
Description
If this option is selected, the output from ringsmappt will be
appended to the output 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 input coordinate. The
options are IMAGE (sample/line), GROUND (ring radius/ring longitude),
and PROJECTION (X/Y).
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 ring radius/ring longitude, and X/Y
Exclusions
- RINGRADIUS
- RINGLONGITUDE
- X
- Y
- COORDSYS
- RINGLONDIR
- RINGLONDOM
- MAP
Inclusions
|
GROUND | Interprets the coordinates as ring radius and ring longitude |
This option interprets the coordinate as ring radius/ring longitude and will
compute sample/line and X/Y
Exclusions
Inclusions
- RINGRADIUS
- RINGLONGITUDE
- COORDSYS
|
PROJECTION | Interprets the coordinate as X/Y |
This option interprets the coordinate as X/Y and will
compute sample/line and ring radius/ring longitude
Exclusions
- SAMPLE
- LINE
- RINGRADIUS
- RINGLONGITUDE
- RINGLONDIR
- RINGLONDOM
- MAP
- COORDSYS
Inclusions
|
|
Position:
SAMPLE
Description
This is the sample position used to compute information about the camera state at the pixel level.
Position:
LINE
Description
This is the line position used to compute information about the camera state at the pixel level.
Position:
RINGRADIUS
Description
This is the ring radius value to use for the target.
Type
| double |
Minimum
| 0.0
(inclusive)
|
Position:
RINGLONGITUDE
Description
This is the ring longitude value. The ring longitude will be interpreted as
either CounterClockwise or Clockwise, and as -180° to 180° or 0°
to 360° ring longitude domain,
depending on the option selected under coordinate system.
Position:
X
Description
This is the X coordinate value in meters.
Position:
Y
Description
This is the Y coordinate value in meters.
Coordinate System:
COORDSYS
Description
This is the coordinate system that the input ring radius and ring
longitude will be interpreted in. There are four possible options
that include using the input cube settings, the ISIS defaults, user
defined settings, or an existing map file template. The values will
be interpreted as counterclockwise or clockwise, and -180° to 180° or
0° to 360° rings longitude domain.
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 four possibilities. This is the default behavior.
Exclusions
- RINGLONDIR
- RINGLONDOM
- MAP
|
UNIVERSAL |
ISIS default
|
The ISIS default coordinate system of counterclockwise
ring longitude direction and rings longitude
domain 0° to 360°.
Exclusions
- RINGLONDIR
- RINGLONDOM
- MAP
|
USERDEFINED |
User defined coordinate system
|
The user defines the rings longitude direction and rings longitude
domain for the coordinate system.
Exclusions
Inclusions
|
MAP |
Use mapping group from another file
|
Use an existing file (NOT THE INPUT FILE) with Mapping group
information to determine the coordinate system for the computations.
Exclusions
Inclusions
|
|
Coordinate System:
MAP
Description
This file can be a cube or a user generated map file template, but
not the input file. This file must contain the mapping group and is
used to determine the coordinate system, if selected.
Type
| filename |
File Mode
| input |
Filter
|
*.map *.cub
|
Coordinate System:
RINGLONDIR
Description
This is the ring longitude direction for the projection. The
direction can be Counterclockwise or Clockwise. COUNTERCLOCKWISE is
the default.
Type
| string |
Default
|
COUNTERCLOCKWISE
|
Option List:
|
Option |
Brief |
Description |
COUNTERCLOCKWISE |
CounterClockwise Ring Longitude Direction
|
Sets the ring longitude direction of the input to be interpreted
as CounterClockwise.
|
CLOCKWISE |
Clockwise Ring Longitude Direction
|
Sets the ring longitude direction of the input to be interpreted as
Clockwise.
|
|
Coordinate System:
RINGLONDOM
Description
The ring longitude domain for the projection can either be
180 or 360. The default setting is 360.
Type
| string |
Default
|
360
|
Option List:
|
Option |
Brief |
Description |
360 |
0 to 360 Degree Ring Longitude Domain
|
Sets the ring longitude domain of the input to be interpreted as 0 to
360 degrees.
|
180 |
-180 to 180 Degree Ring Longitude Domain
|
Sets the ring longitude domain of the input to be interpreted as
-180 to 180 degrees.
|
|