Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

mapgrid

Printer Friendly View | TOC | Home

Draws a grid of Latitude/Longitude lines for a projection

Overview Parameters Example 1 Example 2

Description

This program will draw a grid of latitude and longitude lines for a projected mapping. The mapfile should contain all necessary keywords and values to create the specific projection. If you are unsure of what keywords are necessary, a template file can be created for the projection using the maptemplate application. The output is a GML file that can be plotted using qgis.

Categories

History

Elizabeth Ribelin2005-09-06 Original version
Brendan George2005-11-01 Fixed application test for all systems
Elizabeth Miler2005-11-03 Fixed bug in xml and made appTest test larger lat/lon increments and spacings to reduce the size of truth files
Elizabeth Miller2005-11-29 Modified mapgrid so the boundary lat lines will always be drawn
Elizabeth Miller2006-05-18 Depricated CubeProjection and ProjectionManager to ProjectionFactory
Steven Lambright2007-06-21 Changed output to be in GML format, fixed bug with bounded option
Steven Lambright2007-07-17 Fixed bug with include files.

Parameter Groups

Files

Name Description
MAPFILE Map File
TO Grid Output

Options

Name Description
STARTLAT Starting Latitude
STARTLON Starting Longitude
ENDLAT Ending Latitude
ENDLON Ending Longitude
LATSPACING Value for Spacing the Latitude Lines
LONSPACING Value for Spacing the Longitude Lines
LATINCREMENT Incrementing value for the Latitude Lines
LONINCREMENT Incrementing value for the Longitude lines
BOUNDED Draw Boundary Lines on Grid
X

Files: MAPFILE

Description

This file contains the mapping projection information necessary to make the grid. This can be a text file or a cube.

Type filename
File Mode input
Filter *.txt *.cub
Close Window
X

Files: TO

Description

The resultant grid. The output is a GML file that can be plotted using qgis.

Type filename
File Mode output
Filter *.gml
Close Window
X

Options: STARTLAT

Description

This is the starting value for the latitude lines in the grid.

Type double
Close Window
X

Options: STARTLON

Description

This is the starting value for the longitude lines in the grid.

Type double
Close Window
X

Options: ENDLAT

Description

This is the ending value for the latitude lines in the grid.

Type double
Close Window
X

Options: ENDLON

Description

This is the ending value for the longitude lines in the grid.

Type double
Close Window
X

Options: LATSPACING

Description

This value will determine how far apart the latitude lines are spaced.

Type double
Default 10.0
Close Window
X

Options: LONSPACING

Description

This value will determine how far apart the longitude lines are spaced.

Type double
Default 10.0
Close Window
X

Options: LATINCREMENT

Description

This value will determine how smooth the latitude lines are drawn. A large value here will create a more rough, jagged line, while a very small value will create a more smooth, curved line.

Type double
Default 0.01
Close Window
X

Options: LONINCREMENT

Description

This value will determine how smooth the longitude lines are drawn. A large value here will create a more rough, jagged line, while a very small value will create a more smooth, curved line.

Type double
Default 0.01
Close Window
X

Options: BOUNDED

Description

If this option is selected, boundry lines will be drawn around the projection grid. If the option is not selected, no boundry lines will be drawn.

Type boolean
Default TRUE
Close Window

Example 1

Sinusoidal Map Grid

Description

This example shows the qgis display of a sinusoidal projection created by this application. The following mapfile was used in the mapgrid application to create the grid. 
Group = Mapping
  ProjectionName     = Sinusoidal
  TargetName         = MARS
  EquatorialRadius   = 3396190.0 <meters>
  PolarRadius        = 3376200.0 <meters>
  LatitudeType       = Planetocentric
  LongitudeDirection = PositiveEast
  LongitudeDomain    = 360
  CenterLongitude    = 180.0
End_Group
End

Command Line

mapgrid mapfile=mapFile1.txt startlat=-90 endlat=90 startlon=0 endlon=360 to=sinuGrid.txt
Create a sinusoidal projection map grid.

Output Image

Output image showing the results of the mapgrid application.

Output image as it appears in qgis for mapgrid

Parameter Name: TO

This is the output image that results.

Example 2

Lambert Confromal Map Grid

Description

This example shows the qgis display of a lambert conformal projection created by this application. The following mapfile was used in the this application to create the grid. 
Group = Mapping
  ProjectionName         = LambertConformal
  TargetName             = MARS
  EquatorialRadius       = 3396190.0 <meters>
  PolarRadius            = 3376200.0 <meters>
  LatitudeType           = Planetocentric
  LongitudeDirection     = PositiveEast
  LongitudeDomain        = 360
  CenterLongitude        = 20.0
  CenterLatitude         = 40.0
  FirstStandardParallel  = 32.0
  SecondStandardParallel = 43.0
End_Group
End

Command Line

mapgrid mapfile=mapFile2.txt startlat=20 endlat=60 startlon=0 endlon=40 to=lambGrid.txt
Create a lambert conformal projection map grid.

Output Image

Output image showing the results of the mapgrid application.

Output image as it appears in qgis

Parameter Name: TO

This is the output image that results