/military-symbol-editor-addin-wpf

A user-focused add-in for searching, creating, and editing military symbols in ArcGIS Pro.

Primary LanguageC#Apache License 2.0Apache-2.0

military-symbol-editor-addin-wpf

A user-focused addin for searching, creating, and editing military symbols in ArcGIS Pro 1.2.

Image of Military Symbol Editor Addin

Features

  • Addin for ArcGIS Pro 1.2
  • Quickly and easily search, modify attributes, and preview multilayer military symbols using ArcGIS Pro
  • Add created symbols to the map through clicking/drawing or by typing in coordinates

Sections

Requirements

Developers

  • Visual Studio 2015
  • ArcGIS Pro 1.2
  • ArcGIS Pro 1.2 SDK

Users

  • ArcGIS Pro 1.2

Instructions

General Help

Getting Started with the Military Symbol Editor

Developers

  • Building
    • To Build Using Visual Studio 2015
      • Open and build solution file
    • To Build Using Visual Studio 2013
      • Install the .NET 4.5.2 Dev Pack
      • Open and build solution file
    • To use MSBuild to build the solution
      • Open a Visual Studio Command Prompt: Start Menu | Visual Studio 2015 | Visual Studio Tools | Developer Command Prompt for VS2015
      • cd military-symbol-editor-addin-wpf\source
      • msbuild ProSymbolEditor.sln /property:Configuration=Release
      • This will build to the location: source\ProSymbolEditor\bin\Release and register the add-in
    • Note : Assembly references are based on a default install of the SDK, you may have to update the references if you chose an alternate install option
      • There is a Pro SDK Utilities Visual Studio Extension that can be used to quickly fix Pro SDK assembly references.
    • To run unit tests from the command prompt:
      • Open a Visual Studio Command Prompt: Start Menu | Visual Studio 2013/2015 | Visual Studio Tools | Developer Command Prompt
      • cd military-symbol-editor-addin-wpf\source
      • vstest.console.exe SymbolEditorUnitTests\bin\Release\SymbolEditorUnitTests.dll /InIsolation /platform:x64
        • Note: vstest must be used instead of mstest in order to run as an x64 process (required by the Pro SDK dependencies)

Users

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

  • Running
    • To run from a stand-alone deployment in ArcGIS Pro
      • Obtain the add-in. The add-in may be obtained from
      • Download the and install the add-in by double clicking it
      • Open ArcGIS Pro 1.2
      • Open a project that contains the Military Overlay geodatabase (MilitaryOverlay.gdb)
      • The ADD-IN appears under the "ADD-IN" tab in Pro
      • Click the "Military Symbol Designer" button and the tool will appear
      • The Search tab is the first tab:
        • Type a search term into the bar, and click Search (or hit enter)
        • The tool will return matches to that term in the Military style file
        • Selecting a search result will show a preview and associated tags with that symbol
        • Click the next arrow button or the modify tab when you have selected a style
      • The Modify tab is the second tab:
        • Use the select tool in ArcGIS Pro to select already existing features
        • When selected, this will populate a list on this tab
        • Select a feature in this list to start editing it. The feature's data will be loading into the other tabs for editing.
      • The Favorites tab is the third tab:
        • Users can save a symbol that they've created so that they can easily go back to it against
        • The favorites save in a user's account, and show up on this tab
        • Selecting a favorite from the list will load it into the pre-existing workflow.
      • The Symbol tab is the fourth tab:
        • The application will display all attributes associated with the chosen style, with combo boxes for selecting values
        • As you select values, the symbol will update to incorporate those changes
        • A table below has a summary of the values you select
        • After you are finished loading values, click the next arrow or the Text tab
      • The Label tab is the fifth tab:
        • Various values that will be saved into the feature are available for edit here. These values will appear around the symbol on the map.
        • After you are finished populating any text values, you can click the next arrow button to go the last tab.
      • The Coordinate tab is the sixth tab:
        • Coordinates can be entered in DD, DMS, DD, or other coordinate systems.
        • Once valid coordinates are entered, a button can be clicked to add a feature to those coordinates.
        • Invalid coordinates will show with a red box around it.
        • At any time in this process, the "Add to Map" button, which is on every tab, could be clicked to graphically add the feature to the map by clicking.

Please note: if you have an issue that is not specifically related to the User Interface or the Addin 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

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 Designer button. The Military Symbol Designer 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 Designer 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.

Modify a new symbol

  1. After you've selected a symbol in the Military Symbol Designer, 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.

    Note: The Military Symbol Designer is for designing symbols before you add them to the map. It is not for editing existing features on the map. If you want to change a feature that you've already added to the map, select the feature, click the Edit tab in ArcGIS Pro, click Attributes, and edit the feature's attributes in the Attributes pane.

Add text modifiers to a new symbol

  1. After you've selected a symbol in the Military Symbol Designer, 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 Designer, 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 Designer, 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 Designer, 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.

Edit the symbol for a military feature that is already on the map

  1. In an ArcGIS Pro map or table, select the military feature that you want to change with the select tool.
  2. Click the Modify tab in in the Military Symbol Designer.
  3. Click the appropriate feature in the list on this tab.
  4. The feature's attribute data will load into the Symbol and Label tabs for editing.
  5. Click the Save Edits button to write the edits back to the feature.

Resources

Issues

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

Contributing

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

Repository Points of Contact

Repository Owners

Primary - Travis
  • Merge Pull Requests
  • Creates Releases and Tags
  • Manages Milestones
  • Manages and Assigns Issues
Secondary: Chris
  • Backup when the Owner is away

Credits

This addin uses the following third-party software.

This software is governed by the Apache V2 License:

This software is governed by the Microsoft Public License (Ms-PL):

Licensing

Copyright 2016 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.

[](Esri Tags: Military Analyst Defense ArcGIS ArcObjects .NET WPF ArcGISSolutions ArcMap ArcPro Add-In Symbol Editor) [](Esri Language: C#)