Skip to content

NationalSecurityAgency/qgis-mgrs-plugin

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
doc
 
 
 
 
svg
 
 
ui
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

MGRS Plugin

MGRS provides zoom to and coordinate capture ability for MGRS coordinates separate from the Lat Lon Tools plugin. It was produced for users who want separate tools and to be able to have both MGRS and Lat Lon Tools windows displayed at the same time. It also provides an algorithm to create an MGRS Grid Zone Designator layer. If you need the ability to convert an attribute table with MGRS coordinates to a new point layer or convert a point layer to a new layer with an MGRS attribute string, then use Lat Lon Tools. The MGRS plugin is installed in the QGIS Plugins menu.

MGRS menu

These are the MGRS tools as shown on the MGRS toolbar.

MGRS toolbar
  • Copy MGRS coordinate Copy/Display MGRS Coordinate - This captures MGRS coordinates onto the clipboard when the user clicks on the map. If snapping is enabled under QGIS Project->Snapping Options... menu, then Copy/Display MGRS Coordinate will snap to any close vector vertices according to the parameters set in the snapping options.

  • Zoom-to Zoom to MGRS Coordinate - With this tool, type or paste an MGRS coordinate into the text area and press Enter. QGIS centers the map on the coordinate, highlights the location and creates a temporary marker at the location. The marker can be removed with the Clear marker button. The following shows the dockable zoom to dialog box.

    Zoom Dialog box
  • MGRS Grid Zone Designator MGRS Grid Zone Designator - This will create an MGRS Grid Zone Designator overlay layer.

    Grid Zone Designator Algorithm
    • Include polar regions - If checked the polar grid zones A,B and Y,Z are included in the output.
    • Automatically style output - If checked, the output layer will automatically be styled with colors from the Settings menu.

    The output layer can be saved and reused without needing to run this processing algorithm again. This is an example of the output of the algorithm.

    GZD example

Settings

These are the settings that are available from the QGIS menu Plugins->MGRS->Settings

Settings
  • MGRS precision - This determines the precision of the captured MGRS coordinate. It ranges from 0 to 5 with 5 being the highest resolution.
  • Coordinate prefix - This text string is added to the beginning of the captured MGRS coordinate.
  • Coordinate suffix - This text string is added to the end of the captured MGRS oordinate.
  • GZD line color - This is the outline color used when the MGRS Grid Zone Designator algorithm is executed.
  • GZD font color - This is the font color used for the grid zone labels when the MGRS Grid Zone Designator algorithm is executed.
  • Add spaces to MGRS coordinates - This will add spaces to an MGRS coordinate when checked. Unchecked it looks like "16TDL8016526461" and checked it looks like "16T DL 80165 26461".
  • Use persistent zoom to marker - If this is checked, then when you zoom to an MGRS coordinate a persistent marker is displayed until you exit, zoom to another location, or click on the Clear marker button.
  • Show marker on QGIS map at the captured location - If checked, a temporary marker will be displayed at the location clicked on with the Copy/Display MGRS Coordinate tool.