Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

maptemplate

Printer Friendly View | TOC | Home

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

Related Objects and Documents

Applications

History

Elizabeth Ribelin2005-09-13 Original Version
Elizabeth Miller2005-11-17 Added .map extension to TO file and fixed bug with spaces in the projection name
Elizabeth Miller2006-05-18 Depricated CubeProjection and ProjectionManager to ProjectionFactory
Robert Sucharski2006-06-02 Redid GUI, added code to calculate ground range and resolution using FROMLIST, and added helper buttons
Steven Lambright2008-04-23 Added oblique cylindrical projection
Steven Lambright2009-02-05 Fixed a problem that occurred when using "TARGOPT=USER", "RNGOPT=CALC" and not entering "EQRADIUS" or "POLRADIUS"

Parameter Groups

Files

Name Description
MAP Output text file containing mapping template
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

Name Description
TARGOPT Target Selection Options
TARGDEF Name of the Target Definition File
TARGETNAME Name of the Target
LATTYPE Latitude type
LONDIR Longitude Direction
LONDOM Longitude Domain
EQRADIUS Equatorial Radius
POLRADIUS Polar Radius

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
X

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
Close Window
X

Files: FROMLIST

Description

A list of file names that will be used by the caluclation option for the ground range and resolution 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
Close Window
X

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

  • CLON
MERCATOR Mercator Projection Create a maptemplate for a mercator projection.

Exclusions

  • SCALEFACTOR
  • PAR1
  • PAR2
  • PROT
  • PLAT
  • PLON

Inclusions

  • CLON
  • CLAT
TRANSVERSEMERCATOR Transverse Mercator Projection Create a maptemplate for a transverse mercator projection.

Exclusions

  • PAR1
  • PAR2
  • PROT
  • PLAT
  • PLON

Inclusions

  • CLON
  • CLAT
  • SCALEFACTOR
ORTHOGRAPHIC Orthographic Projection Create a maptemplate for an orthographic projection.

Exclusions

  • SCALEFACTOR
  • PAR1
  • PAR2
  • PROT
  • PLAT
  • PLON

Inclusions

  • CLON
  • CLAT
POLARSTEREOGRAPHIC Polar Stereographic Projection Create a maptemplate for a polar stereographic projection.

Exclusions

  • SCALEFACTOR
  • PAR1
  • PAR2
  • PROT
  • PLAT
  • PLON

Inclusions

  • CLON
  • CLAT
SIMPLECYLINDRICAL Simple Cylindrical Projection Create a maptemplate for a simple cylindrical projection

Exclusions

  • CLAT
  • SCALEFACTOR
  • PAR1
  • PAR2
  • PROT
  • PLAT
  • PLON

Inclusions

  • CLON
EQUIRECTANGULAR Equirectangular Projection Create a maptemplate for an equirectangular projection.

Exclusions

  • SCALEFACTOR
  • PAR1
  • PAR2
  • PROT
  • PLAT
  • PLON

Inclusions

  • CLON
  • CLAT
LAMBERTCONFORMAL Lambert Conformal Projection Create a maptemplate for a lambert conformal projection.

Exclusions

  • SCALEFACTOR
  • PROT
  • PLAT
  • PLON

Inclusions

  • CLON
  • CLAT
  • PAR1
  • PAR2
OBLIQUECYLINDRICAL Oblique Cylindrical Projection Create a maptemplate for an oblique cylindrical projection.

Exclusions

  • CLON
  • CLAT
  • SCALEFACTOR
  • PAR1
  • PAR2

Inclusions

  • PROT
  • PLAT
  • PLON
Close Window
X

Projection Parameters: CLON

Description

The center longitude to use for the mapping group.

Type double
Close Window
X

Projection Parameters: CLAT

Description

The center latitude to use for the mapping group.

Type double
Close Window
X

Projection Parameters: SCALEFACTOR

Description

The scale factor to use for the mapping group.

Type double
Close Window
X

Projection Parameters: PAR1

Description

The first standard parallel to use for the mapping group.

Type double
Close Window
X

Projection Parameters: PAR2

Description

The second standard parallel to use for the mapping group.

Type double
Close Window
X

Projection Parameters: PLAT

Description

The pole latitude to use for the mapping group.

Type double
Close Window
X

Projection Parameters: PLON

Description

The pole longitude to use for the mapping group.

Type double
Close Window
X

Projection Parameters: PROT

Description

The pole rotation to use for the mapping group.

Type double
Close Window
X

Target Parameters: TARGOPT

Description

This option decides 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 mapfile. 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

  • TARGDEF
USER User Input The user may enter the values for the target name, latitude type, and the longitude direction and domain.

Exclusions

  • TARGDEF

Inclusions

  • TARGETNAME
  • LATTYPE
  • LONDIR
  • LONDOM
Close Window
X

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/
Close Window
X

Target Parameters: TARGETNAME

Description

This is the name of the Target (your planet of interest) for the projection.

Type string
Close Window
X

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.
Close Window
X

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 Sets the longitude direction in the mapping template to PositiveEast.
POSITIVEWEST PositiveWest Longitude Direction Sets the longitude direction in the mapping template to PositiveWest.
Close Window
X

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.
Close Window
X

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
Close Window
X

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
Close Window
X

Ground Range Parameters: RNGOPT

Description

This option decides 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 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.

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 used for the ground range in the mapfile.
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
Close Window
X

Ground Range Parameters: MINLAT

Description

The mimimum latitude value in the mapping template will be set to this user entered value.

Type double
Close Window
X

Ground Range Parameters: MAXLAT

Description

The maximum latitude value in the mapping template will be set to this user entered value.

Type double
Close Window
X

Ground Range Parameters: MINLON

Description

The minimum longitude value in the mapping template will be set to this user entered value.

Type double
Close Window
X

Ground Range Parameters: MAXLON

Description

The maximum longitude value in the mapping template will be set to this user entered value.

Type double
Close Window
X

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 ground range information to the map file, allowing the range 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 ground range and select the appropriate units. The CALC option will calculate the ground range using the files listed in the FROMLIST.

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

  • RESOLUTION
  • RESCALCOPT
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 file and mapping group.

Exclusions

  • RESCALCOPT
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 file and mapping group.

Exclusions

  • RESCALCOPT
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
Close Window
X

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).

Type double
Close Window
X

Resolution Parameters: RESCALCOPT

Description

This option decides how resolution information will be calculated. The defualt 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. 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.
Close Window

Example 1

Sinusoidal Map Template

Description

This example shows how the maptemplate application works. The settings are all default for this example, other than the output filename and center longitude which are entered in. 
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 how the maptemplate application works. For this example, 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.