search

Esri / military-symbology

A user-focused add-in for searching, creating, and editing military symbols in ArcGIS Pro.
Apache License 2.0
39 stars 10 forks source link
arcgis-defense arcgis-solutions military-overlay-template military-tools-for-arcgis native-development

readme

Military Symbology

This repository is no longer maintained.

Beginning at ArcGIS Pro 2.6 this functionality is installed with ArcGIS Pro.

Military Symbol Editor add-in

A user-focused ArcGIS Pro add-in for quickly creating military symbols and overlays using MIL-STD-2525D, MILSTD-2525B Change 2, and APP-6(D).

Image of Military Symbol Editor Addin

Features

Sections

Requirements

Build Requirements

Run Requirements

Instructions

General Help

Getting Started with the Military Symbol Editor

Developers

Obtain the Dependent Repositories
{Github Clone Location}
+---coordinate-conversion-addin-dotnet
+---military-symbol-editor-addin-wpf

IMPORTANT NOTE: Because of file name length limitations in Visual Studio, the length of the folder name of {Github Clone Location} should not exceed 80 characters

Users

IMPORTANT: This application depends on the Military Overlay Information Model layer package(LPKX) or Military Overlay geodatabase(GDB) that is provided with the Military Overlay Information Model Template or the Military Overlay Template. If you do not have the Military Overlay Information Model GDB already included in your project, you will receive a warning and a prompt to add the LPKX when you attempt to use the application.

Workflows

Open the add-in in ArcGIS Pro

  1. After you've installed the add-in, Open ArcGIS Pro and click the ADD-IN tab.
  2. Click the Military Symbol Editor button. The Military Symbol Editor pane will open. If you don't have the Military Overlay geodatabase in your Pro project, you will be prompted to download or add it. The Military Symbol Editor requires this geodatabase.

Search for a symbol

  1. On the Search tab, type a keyword in the Search box to find the symbol you want (e.g. type "Infantry" to find infantry-related symbols).
  2. Optionally, refine your search by typing other keywords (e.g. type "armor" after infantry to find armored infantry symbols).
  3. Click one of the results in the list that appears below the search box.
  4. Optionally, click Add to Map to add the symbol to the map without further refinement. You can also modify the symbol before you add it, so it will have the text and graphic modifiers that you want.
  5. Optionally, click Add Favorite to add the symbol to your favorites list. You can also modify the symbol before you add it to your Favorites.

Changing a symbol

  1. After you've selected a symbol in the Military Symbol Editor, click the Symbol tab.
  2. Click the dropdown lists to set the Identity/Affiliation, Status, TF, FD, HQ, Echelon, Context, Modifier 1, and Modifier 2 modifier attributes.
  3. Optionally, click Add to Map to add the symbol to the map without further refinement.
  4. Optionally, click Add Favorite to add the symbol to your favorites list.

Add text modifiers to a new symbol

  1. After you've selected a symbol in the Military Symbol Editor, click the Label tab.
  2. Click the Date and Time adjustment buttons to set the Date/Time Valid and Date/Time Expired values for the symbol.
  3. Set the Speed, Unique Designation, Reinforced, Staff Comments, Additional Information, and Higher Formation text modifier attributes.
  4. Optionally, click Add to Map to add the symbol to the map.
  5. Optionally, click Add Favorite to add the symbol to your favorites list.

Add a symbol to the map by clicking on the map.

  1. After you've selected a symbol in the Military Symbol Editor, click Add to Map to add the symbol to the map.
  2. Click the location on the map where you want to add the symbol. If the symbol is for a point feature, the feature is added where you clicked. If the symbol is for a line or area feature, the first vertex is added. Click to add additional vertices. Double-click to finish the feature.
  3. Optionally, click elsewhere on the map to add more instances of the symbol.

Add a symbol to the map by entering coordinates

  1. After you've selected a symbol in the Military Symbol Editor, click the Enter Coordinates tab to add the symbol at a particular coordinate location. Note: The Coordinates box accepts coordinates in a variety of formats, including DD, DMS, MGRS, and UTM.
  2. Type or paste a coordinate value in the Coordinates box. If the symbol is for a line or area feature, press the Enter key and continue adding coordinates.
  3. Click Add Coordinates to Map. The symbol is added to the map at the coordinates you specified.

Add a symbol to your Favorites

  1. After you've selected a symbol in the Military Symbol Editor, click the Add Favorite button.
  2. Click the Favorites tab. You should see the symbol in the favorites box.
  3. Optionally, define other symbols that you will need. Add each one to your Favorites. Click a symbol in your favorites to add it to the map.

Sharing Favorites

  1. To share or save a set of favorites use the "Save As..." and "Import..." buttons on the Favorites tab
  2. Additional information about favorites:
    1. You may copy, import/export, or share favorites files (ex. SymbolFavorites.json) between machines with the same version of the Military Symbol Editor installed
    2. Manually editing or creating favorites files outside of the add-in is not generally supported
      1. This file must match the JSON format/model of the current add-in.
      2. This format/model is JSON-serialized from this class.
    3. The default favorites file used by the application is: SymbolFavorites.json
      1. This file is stored with the add-in at the add-in install location (Note: you may copy/paste this path into File Explorer) at:
      2. Military Symbol Editor Add-in: %LOCALAPPDATA%\ESRI\ArcGISPro\AssemblyCache\{4ff462b0-2910-47f3-b6fd-d1d17e5f7dfc}
      3. Military Tools for ArcGIS Add-in: %LOCALAPPDATA%\ESRI\ArcGISPro\AssemblyCache\{bea7f059-c69e-4e17-84bd-072236629c0c}

Resources

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue.

Please note: if you have an issue that is not specifically related to the User Interface or the add-in form itself, but is related to how the symbol draws on the map (ex. incorrect symbol, missing labels on map, line styles) please log those issues against the symbol data itself at: https://github.com/Esri/military-features-data

Contributing

Anyone and everyone is welcome to contribute. Please see our guidelines for contributing.

Credits

This addin uses the following third-party software.

This software is governed by the Apache V2 License:

Repository Points of Contact

Contact the Military Tools team

Licensing

Copyright 2018 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:

http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's license.txt file.