Isis 3 Application Documentation
Create mapping group template for a projection
Overview
|
Parameters
|
Example 1 |
Example 2 |
Description
This program creates a map group template for map projections. Choose a projection and complete
the highlighted fields in the projection parameters area. An exsiting target definition file can be used
or the user can input target information. If a target name is specified and no value is entered for radius,
the system radii will be used. The helper button located by the radial fields will display the system radii
for the chosen target in the log area. Using the RNGOPT parameter, the user can specify whether they
want no ground range values put into the map file, or if they want the application to calculate them
using the FROMLIST files, or whether they want to enter the values themselves. There is a helper
button next to the RNGOPT parameter that will fill in the range parameters with the calculated values.
The RESOPT parameter works very similar to the RNGOPT parameter. The user can enter a resolution
in pixel resolution(MPP) or scale(PPD). The resolution can also be calculated using the FROMLIST.
If the calculation option is chosen, the user can choose to calculate the highest resolution, the lowest
resolution, or an average resolution. All the calculated values will be in pixel resolution which is meters
per pixel. There is also a helper button on this option that will automatically fill in the resolution value in
the gui. The output templates can be used in applications that use projections, such as cam2map, map2map,
mapsize, skymap, etc. The output file will automatically have the '.map' extension appended to the filename.
Categories
Applications
History
Elizabeth Ribelin | 2005-09-13 |
Original Version
|
Elizabeth Miller | 2005-11-17 |
Added .map extension to TO file and fixed bug with spaces in the projection name
|
Elizabeth Miller | 2006-05-18 |
Depricated CubeProjection and ProjectionManager to ProjectionFactory
|
Robert Sucharski | 2006-06-02 |
Redid GUI, added code to calculate ground range and resolution using FROMLIST, and
added helper buttons
|
Steven Lambright | 2008-04-23 |
Added oblique cylindrical projection
|
Steven Lambright | 2009-02-05 |
Fixed a problem that occurred when using "TARGOPT=USER", "RNGOPT=CALC" and not entering "EQRADIUS" or "POLRADIUS"
|
Steven Lambright | 2011-12-19 |
Updated documentation as per Ella Lee's recommendations in preparation for
the January 2012 release.
|
|
Parameter Groups
Files
Name
|
Description
|
MAP |
Output text file containing mapping keywords and values
|
FROMLIST |
Input list of images used when calculation option is selected
|
Projection
Name
|
Description
|
PROJECTION |
Name of Projection to create mapping group for
|
Projection Parameters
Name
|
Description
|
CLON |
Center Longitude
|
CLAT |
Center Latitude
|
SCALEFACTOR |
Scale Factor
|
PAR1 |
First Standard Parallel
|
PAR2 |
Second Standard Parallel
|
PLAT |
Pole Latitude
|
PLON |
Pole Longitude
|
PROT |
Pole Rotation
|
Target Parameters
Ground Range Parameters
Name
|
Description
|
RNGOPT |
Ground Range Selection Options
|
MINLAT |
Minimum Latitude
|
MAXLAT |
Maximum Latitude
|
MINLON |
Minimum Longitude
|
MAXLON |
Maximum Longitude
|
Resolution Parameters
Name
|
Description
|
RESOPT |
Resolution Selection Options
|
RESOLUTION |
Resolution
|
RESCALCOPT |
Select highest value, lowest value, or average value
|
|
Files:
MAP
Description
This file will contain the mapping group template. If this file currently exists, the application will write over
the file. The '.map' extension will automatically be appended to the entered filename if you do not type
in an extension.
Type
| filename |
File Mode
| output |
Filter
|
*.map
|
Files:
FROMLIST
Description
A list of file names that will be used by the calculation (CALC)
option for the ground range (RNGOPT) and resolution (RESOPT) parameters.
It is also used when a user selects the helper button for the two
parameters.
Type
| filename |
File Mode
| input |
Internal Default
| list of images used when calculation option is selected |
Filter
|
*.lis
|
Projection:
PROJECTION
Description
This is the name of the projection for the mapping group being
created.
Type
| string |
Default
|
SINUSOIDAL
|
Option List:
|
Option |
Brief |
Description |
SINUSOIDAL |
Sinusoidal Projection
|
Create a maptemplate for a sinusoidal projection.
Exclusions
- CLAT
- SCALEFACTOR
- PAR1
- PAR2
- PROT
- PLAT
- PLON
Inclusions
|
MERCATOR |
Mercator Projection
|
Create a maptemplate for a mercator projection.
Exclusions
- SCALEFACTOR
- PAR1
- PAR2
- PROT
- PLAT
- PLON
Inclusions
|
TRANSVERSEMERCATOR |
Transverse Mercator Projection
|
Create a maptemplate for a transverse mercator projection.
Exclusions
Inclusions
|
ORTHOGRAPHIC |
Orthographic Projection
|
Create a maptemplate for an orthographic projection.
Exclusions
- SCALEFACTOR
- PAR1
- PAR2
- PROT
- PLAT
- PLON
Inclusions
|
POLARSTEREOGRAPHIC |
Polar Stereographic Projection
|
Create a maptemplate for a polar stereographic projection.
Exclusions
- SCALEFACTOR
- PAR1
- PAR2
- PROT
- PLAT
- PLON
Inclusions
|
SIMPLECYLINDRICAL |
Simple Cylindrical Projection
|
Create a maptemplate for a simple cylindrical projection
Exclusions
- CLAT
- SCALEFACTOR
- PAR1
- PAR2
- PROT
- PLAT
- PLON
Inclusions
|
EQUIRECTANGULAR |
Equirectangular Projection
|
Create a maptemplate for an equirectangular projection.
Exclusions
- SCALEFACTOR
- PAR1
- PAR2
- PROT
- PLAT
- PLON
Inclusions
|
LAMBERTCONFORMAL |
Lambert Conformal Projection
|
Create a maptemplate for a lambert conformal projection.
Exclusions
- SCALEFACTOR
- PROT
- PLAT
- PLON
Inclusions
|
OBLIQUECYLINDRICAL |
Oblique Cylindrical Projection
|
Create a maptemplate for an oblique cylindrical projection.
Exclusions
- CLON
- CLAT
- SCALEFACTOR
- PAR1
- PAR2
Inclusions
|
|
Projection Parameters:
CLON
Description
The center longitude to use for the mapping group.
Projection Parameters:
CLAT
Description
The center latitude to use for the mapping group.
Projection Parameters:
PAR1
Description
The first standard parallel to use for the mapping group.
Projection Parameters:
PAR2
Description
The second standard parallel to use for the mapping group.
Projection Parameters:
PLAT
Description
The pole latitude to use for the mapping group.
Projection Parameters:
PLON
Description
The pole longitude to use for the mapping group.
Projection Parameters:
PROT
Description
The pole rotation to use for the mapping group.
Target Parameters:
TARGOPT
Description
This option specifies how the target information will be created. The
default is IMAGE. The other options include SYSTEM and USER. The
IMAGE option will not add any target information to the map file,
allowing the target information from the image to be used. The SYSTEM
option will retrieve the target information from the system defaults,
and the USER option allows the user to specify their own target
information.
Type
| string |
Default
|
IMAGE
|
Option List:
|
Option |
Brief |
Description |
IMAGE |
Image Defaults
|
No target information will be put into the map template file.
This information will be retrieved from the image at the time
of projection.
Exclusions
- TARGDEF
- TARGETNAME
- EQRADIUS
- POLRADIUS
- LATTYPE
- LONDIR
- LONDOM
|
SYSTEM |
System Defaults
|
The information needed will be automatically generated from system defaults.
Exclusions
- TARGETNAME
- EQRADIUS
- POLRADIUS
- LATTYPE
- LONDIR
- LONDOM
Inclusions
|
USER |
User Input
|
The information needed is based on the target name, latitude type,
and the longitude direction and domain.
Exclusions
Inclusions
- TARGETNAME
- LATTYPE
- LONDIR
- LONDOM
|
|
Target Parameters:
TARGDEF
Description
This is the Target Definition file that will be used for the projection.
Type
| filename |
Default Path
|
$ISIS3DATA/base/templates/targets/
|
Target Parameters:
TARGETNAME
Description
This is the name of the Target (your planet of interest) for the projection.
Target Parameters:
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 in the mapping template to Planetocentric.
|
PLANETOGRAPHIC |
Planetographic
|
Sets the latitude type in the mapping template to Planetographic.
|
|
Target Parameters:
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
|
Longitude values increase to the east.
|
POSITIVEWEST |
PositiveWest Longitude Direction
|
Longitude values increase to the west.
|
|
Target Parameters:
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 in the mapping template to 360 degrees.
|
180 |
-180 to 180 Degree Longitude Domain
|
Sets the longitude domain in the mapping template to 180 degrees.
|
|
Target Parameters:
EQRADIUS
Description
The equatorial radius value to put in the maptemplate. If this value is left blank, the system default will be used
Type
| double |
Internal Default
| IAU Default |
Target Parameters:
POLRADIUS
Description
The polar radius value to put in the maptemplate. If this value is left blank, the system default will be used.
Type
| double |
Internal Default
| IAU Default |
Ground Range Parameters:
RNGOPT
Description
This option specifies how the ground range information will be
created. IMAGE is the default value. The other options are USER
and CALC. The IMAGE option does not write any ground range
information to the map template file, allowing the range to be
calculated from the image at the time of projection. The USER
option allows the user to enter their own values for the ground
range, and the CALC option will calculate the ground range using
the files listed in the FROMLIST parameter.
Type
| string |
Default
|
IMAGE
|
Option List:
|
Option |
Brief |
Description |
IMAGE |
Image Defaults
|
No ground range values will be put into the mapping template. These values will be computed
from the image at the time of projection.
Exclusions
- MINLAT
- MAXLAT
- MINLON
- MAXLON
|
USER |
User Entered Values
|
The user enters the values to be used for the ground range.
|
CALC |
Calculate Ground Range Using Input Parameter FROMLIST
|
The values used for ground range will be calculated using the files in the from list (FROMLIST).
Exclusions
- MINLAT
- MAXLAT
- MINLON
- MAXLON
|
|
Ground Range Parameters:
MINLAT
Description
The mimimum latitude value in the mapping template will be set to this user entered value.
Type
| double |
Minimum
| -90
(inclusive)
|
Maximum
| 90
(exclusive)
|
Less Than
| MAXLAT
|
Ground Range Parameters:
MAXLAT
Description
The maximum latitude value in the mapping template will be set to this user entered value.
Type
| double |
Minimum
| -90
(exclusive)
|
Maximum
| 90
(inclusive)
|
Greater Than
| MINLAT
|
Ground Range Parameters:
MINLON
Description
The minimum longitude value in the mapping template will be set to this user entered value.
Type
| double |
Less Than
| MAXLON
|
Ground Range Parameters:
MAXLON
Description
The maximum longitude value in the mapping template will be set to this user entered value.
Type
| double |
Greater Than
| MINLON
|
Resolution Parameters:
RESOPT
Description
This option decides how the resolution information will be created.
The default is IMAGE. The other options are MPP, PPD and CALC. The
IMAGE option does not write any resolution information to the map
file, allowing the resolution to be calculated from the image at the
time of projection. The MPP and PPD option allow the user to enter
their own values for the resolution and select the appropriate units.
The CALC option will calculate the resolution using the files listed
in the FROMLIST parameter.
Type
| string |
Default
|
IMAGE
|
Option List:
|
Option |
Brief |
Description |
IMAGE |
Image Defaults
|
No resolution value will be put into the mapping template. It will be computed from the image at the time
of projection.
Exclusions
|
MPP |
User entered Pixel Resolution (MPP)
|
The values used for resolution are user entered in meters per
pixel. This value is the keyword PixelResoution in the map
template file.
Exclusions
|
PPD |
User entered Scale (PPD)
|
The values used for resolution are user entered in pixels per
degree. This value is the keyword Scale in the map template file.
Exclusions
|
CALC |
Calculate Resolution Using Input Parameter FROMLIST
|
The values used for resolution will be calculated using the files in the FROMLIST parameter. The value that
is returned will be in meter per pixel (which is the PixelResolution keyword).
Exclusions
|
|
Resolution Parameters:
RESOLUTION
Description
The values used for resolution in the mapping template. The units are specified by the user as pixels per degree (PPD)
or meters per pixel (MPP).
Resolution Parameters:
RESCALCOPT
Description
This option specifies how the resolution information will be
calculated. The default is HIGH. The other options are LOW and
AVERAGE. The HIGH option gets the highest resolution from the list
of images, the LOW option gets the lowest resolution, and the AVERAGE
option calculates the average resolution from all of the files in the
FROMLIST parameter. All options output the resolution in meters per
pixel.
Type
| string |
Default
|
HIGH
|
Option List:
|
Option |
Brief |
Description |
HIGH |
Calculate Highest / Best Resolution
|
Calculate the highest/best resolution from the images in the input list. Output is in meters per pixel.
|
LOW |
Calculate Lowest / Worst Resolution
|
Calculate the lowest/worst resolution from the images in the input list. Output is in meters per pixel.
|
AVERAGE |
Calculate Average Resolution
|
The average resolution is calculated from the input images. Output is in meters per pixel.
|
|
Example 1
Sinusoidal Map Template
Description
This example shows the contents of a PVL text file generated by the
maptemplate application. The settings are all default for this example,
other than the output filename and center longitude which are entered
by the user.
Group = Mapping
ProjectionName = Sinusoidal
CenterLongitude = 0.0
End_Group
End
The above output is the text file resulting when the following command line is run.
Command Line
maptemplate map=out.txt clon=0.0
Just run maptemplate with an output file name and center longitude.
|
Example 2
Lambert Conformal Map Template
Description
This example shows the contents of a PVL text file for a lambert
conformal map projection based on user selected options. The output
file, projection type, center latitude, center longitude, first and
second standard parallel, target option, and target name are entered.
The rest of the settings are left in their default state.
Group = Mapping
ProjectionName = LambertConformal
CenterLongitude = 0.0
CenterLatitude = 90.0
StandardParallel1 = 45.0
StandardParallel2 = 55.0
TargetName = Mars
EquatorialRadius = 3396190.0 <meters>
PolarRadius = 3376200.0 <meters>
LatitudeType = Planetocentric
LongitudeDirection = PositiveEast
LongitudeDomain = 360
End_Group
The above output is the text file resulting when the following command line is run.
Command Line
maptemplate map=out.txt projection=LambertConformal clon=0.0 clat=90.0 par1=45.0 par2=55.0 targopt=user targetname=MARS
Just run maptemplate with the output file, projection type, center latitude, center longitude,
first and second standard parallel, target option, and target name.
|