Skip to content
This repository has been archived by the owner on Aug 28, 2024. It is now read-only.

Commit

Permalink
Merge pull request #620 from Esri/dev
Browse files Browse the repository at this point in the history 
June 2018 Release
  • Loading branch information
@kgonzago
kgonzago authored Jun 29, 2018
2 parents b1182ae + e2feac4 commit 355e886
Show file tree
Hide file tree
Showing 133 changed files with 3,830 additions and 1,347 deletions.
2 changes: 2 additions & 0 deletions .gitignore
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ NuGet.exe
*-old
*-sav
*-sav.*
*.sav

#############
## Python
Expand Down Expand Up @@ -35,6 +36,7 @@ develop-eggs
[Bb]in/
[Oo]bj/
*.vshost.*
.vs/

#################
## Eclipse
Expand Down
Binary file added DistanceAndDirection.jpg
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
181 changes: 42 additions & 139 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,164 +1,67 @@
# distance-direction-addin-dotnet
# Distance and Direction

The add-in provides the ability to create geodesic features such as lines, circles, ellipses and range rings. Features can be exported to a file geodatabase, shapefile, or KML.
The Distance and Direction component provides the ability to create geodesic features such as lines, circles, ellipses and range rings.

![Image of Distance and Direction Addin](DistanceAndDirection.PNG)
![Image of Distance and Direction](DistanceAndDirection.jpg)

## Features

* Creates geodesy lines, circles, ellipses and range rings.
* Inputs can be entered manually or via a known coordinate.
* Features can be exported to a file geodatabase, shapefile, or KML.
* Addin for ArcMap and ArcGIS Pro
* Add-ins for ArcMap and ArcGIS Pro

## Sections

* [Requirements](#requirements)
* [Instructions](#instructions)
* [Workflows](#workflows)
* [Resources](#resources)
* [New to Github?](#new-to-github)
* [Issues](#issues)
* [Contributing](#contributing)
* [Repository Points of Contact](#repository-points-of-contact)
* [Licensing](#licensing)

## Requirements

### Developers
### Run Requirements

* Visual Studio 2015
* ArcGIS Desktop SDK for .NET 10.3.1+
* [ArcGIS Desktop for .NET Requirements](https://desktop.arcgis.com/en/desktop/latest/get-started/system-requirements/arcobjects-sdk-system-requirements.htm)
* ArcGIS Pro 2.0+ SDK
* Add-Ins for ArcGIS for Desktop
* ArcMap 10.3.1+
* ArcGIS Pro 2.1+

### ArcGIS for Desktop Users
### Build Requirements

* [ArcGIS Desktop 10.3.1](http://desktop.arcgis.com/en/arcmap/10.3/get-started/system-requirements/arcgis-desktop-system-requirements.htm)
* ArcGIS Pro 2.0+
##### Obtain the Dependent Repositories

* Clone this repository
* Clone the following component repository *to the same root folder location*
* [coordinate-conversion-addin-dotnet](https://github.com/Esri/coordinate-conversion-addin-dotnet)
* Your local folder structure should now look like:

```
{Github Clone Location}
+---coordinate-conversion-addin-dotnet
+---distance-direction-addin-dotnet
```

##### Product Requirements

* Add-Ins for ArcGIS for Desktop
* Visual Studio 2015
* ArcGIS for Desktop
* ArcMap 10.3.1+
* ArcGIS Pro 2.1+
* ArcGIS Desktop SDK for .NET 10.3.1+
* [ArcGIS Desktop for .NET Requirements](https://desktop.arcgis.com/en/desktop/latest/get-started/system-requirements/arcobjects-sdk-system-requirements.htm)
* [ArcGIS Pro SDK](http://pro.arcgis.com/en/pro-app/sdk/) 2.1+

## Instructions

### New to Github
Follow the links below to select the desired development/deployment environment.

* [New to Github? Get started here.](https://github.com/Esri/esri.github.com/blob/master/help/esri-getting-to-know-github.html)
### Add-ins for ArcMap and ArcGIS Pro

### Working with the Add-In
## Development Environment

* Building
* To Build Using Visual Studio
* Open and build solution file
* To use MSBuild to build the solution
* Open a Visual Studio Command Prompt: Start Menu | Visual Studio 2013 | Visual Studio Tools | Developer Command Prompt for VS2013
* ` cd distance-and-direction-addin-dotnet\source\DistanceAndDirection\ArcMapAddinDistanceAndDirection `
* ` msbuild ArcMapAddinDistanceAndDirection.sln /property:Configuration=Release `
* To run Unit test from command prompt
* Open a Visual Studio Command Prompt: Start Menu | Visual Studio 2013 | Visual Studio Tools | Developer Command Prompt for VS2013
* ` cd distance-direction-addin-dotnet\source\DistanceAndDirection\ArcMapAddinDistanceAndDirection.Tests\bin\Release `
* ` MSTest /testcontainer:ArcMapAddinDistanceAndDirection.Tests.dll `*
* 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

## Desktop Users
* Running the add-in
* To run from a stand-alone deployment
* ArcMap
* Install the add-in from the [latest Release](http://solutions.arcgis.com/defense/help/distance-direction)
* Add the add-in command to a toolbar via menu option
* **Customize** -> **Customize mode**
* Select **Commands** Tab
* Select **Add-In Controls**
* Drag/Drop **Show Distance and Direction** command onto a toolbar
* Close customize mode
* Open tool by clicking the **Show Distance and Direction** command you just added
* Dockable *Distance and Direction* tool appears
* If you add this to a toolbar that you continually use the add-in will stay. To remove the add-in delete your [Normal.MXT](https://geonet.esri.com/thread/78692) file
## Workflows

### Create Lines Interactively
1. Choose the **Lines** tab on the *Distance and Direction* Tool
2. Choose the type of line that is needed to be created
3. Start an interactive session by selecting the **Map Point Tool** (arrow icon)
4. Enter a starting and ending point on the map by clicking on the map
5. Repeat until all desired graphics have been included
6. Optional - Select the Save As button to export the Line features to a file geodatabase, shapefile, or KML

### Create Lines from Known Coordinates
1. Choose the type of line that is needed to be created
2. Input the **Starting Point** where your line is going to start
3. Input the **Ending Point** of where your line is going to end
4. Press *Enter* key and the graphic will be drawn on the map
5. Repeat until all desired graphics have been included
6. Optional - Select the Save As button to export the Line features to a file geodatabase, shapefile, or KML

### Create a Line with a Range and Bearing
1. Choose the type of line that you would like to create
2. Choose **Distance and Bearing** from the second drop down (*From*) menu
3. Input the **Distance/Length** of the line and choose the unit type
4. Input the azimuth or **Angle** of the line
5. Press *Enter* key and the graphic will be drawn on the map
6. Optional - Select the Save As button to export the Line features to a file geodatabase, shapefile, or KML

### Create a Circle Interactively
1. Choose the **Circles** tab on the *Distance and Direction* Tool
2. Start an interactive session by selecting the **Map Point Tool** (arrow icon)
3. Click on map to enter a centerpoint and then move the cursor out from center, a circle displays on map as you move the cursor.
4. Click map to complete the circle.
5. Optional - Select the Save As button to export the Circle features to a file geodatabase, shapefile, or KML

### Create a Circle using the Distance Calculator
1. Choose the **Circles** tab on the *Distance and Direction* Tool
2. Start an interactive session by selecting the arrow icon
3. Enter a starting point and the distance of the circles radius by clicking on the map
4. Expand the **Distance Calculator** section
5. Enter a **Time**
6. Select a time unit using the drop down box
7. Enter a **Rate**
8. Select a rate unit using the drop down box
9. Press *Enter* key and the graphic will be drawn on the map
10. Optional - Select the Save As button to export the Circle features to a file geodatabase, shapefile, or KML

### Create Ellipses Interactively
1. Choose the **Ellipse** tab on the *Distance and Direction* Tool
2. Start an interactive session by selecting the arrow icon next to the **Center Point** text box
3. Choose the location where you want the ellipse to be started from
4. Drag the cursor to the location where the major axis will end
5. Select the orientation angle of the major axis
6. Select the length of the minor axis
7. Repeat until all desired graphics have been included
8. Optional - Select the Save As button to export the Ellipse features to a file geodatabase, shapefile, or KML

### Create Ellipses Manually
1. Choose the **Ellipse** tab on the *Distance and Direction* Tool
2. Enter a cooridnate into the **Center Point** text box
3. Enter a distance into the **Major Axis** text box
4. Enter a distance into the **Minor Axis** text box
5. Optionally change the axis **Units** using the drop down box
6. Enter the desired angle in the **Angle** text box
7. Optionally change the orientation **Unit** using the drop down box
8. Press the **ENTER** key
9. Repeat until all desired graphics have been included
10. Optional - Select the Save As button to export the Ellipse features to a file geodatabase, shapefile, or KML

### Create Range Rings Interactively
1. Choose the **Rings** tab on the *Distance and Direction* Tool
2. Check **Interactive**
3. Select the **Map Point Tool** (arrow icon) next to the **Center Point** text box
4. *First* click on the map sets the center point (green dot)
5. Subsequent clicks draw rings from the center point
6. Double-click to create final ring or select the **Map Point Tool** a second time to stop adding rings
* To start a second set of range rings, repeat steps 3 through 6.
7. Optional - Select the Save As button to export the Range Ring features to a file geodatabase, shapefile, or KML
8. Uncheck **Interactive** to return to manual entry

### Create Range Rings Manually
1. Choose the **Rings** tab on the *Distance and Direction* Tool
2. Select the **Map Point Tool** (arrow icon) next to the **Center Point** text box
* Optionally copy and paste, or type coordinates in the **Center Point** text box
3. Choose the location of the Range Rings center by selecting the desired location on the map
4. Fill in the associated parameters for **Number of Rings**, **Ring Interval**, **Distance Units**, and **Number of Radials**
5. Press *Enter* key and the graphic will be drawn on the map
6. Repeat until all desired graphics have been included
7. Optional - Select the Save As button to export the Range Ring features to a file geodatabase, shapefile, or KML
[Instructions for the Add-ins for ArcMap and ArcGIS Pro are here.](./source/addins)

## Resources

Expand All @@ -167,11 +70,14 @@ The add-in provides the ability to create geodesic features such as lines, circl
* [Military Tools for ArcGIS Solutions Pages](http://solutions.arcgis.com/defense/help/military-tools/)
* [ArcGIS for Defense Solutions Website](http://solutions.arcgis.com/defense)
* [ArcGIS for Defense Downloads](http://appsforms.esri.com/products/download/#ArcGIS_for_Defense)
* [ArcGIS 10.3 Help](http://resources.arcgis.com/en/help/)
* [ArcGIS Blog](http://blogs.esri.com/esri/arcgis/)
* ![Twitter](https://g.twimg.com/twitter-bird-16x16.png)[@EsriDefense](http://twitter.com/EsriDefense)
* [ArcGIS Solutions Website](http://solutions.arcgis.com/military/)

## New to Github

* [New to Github? Get started here.](https://github.com/Esri/esri.github.com/blob/master/help/esri-getting-to-know-github.html)

## Issues

Find a bug or want to request a new feature? Please let us know by submitting an [issue](https://github.com/ArcGIS/distance-and-direction-addin-dotnet/issues).
Expand All @@ -180,7 +86,7 @@ Find a bug or want to request a new feature? Please let us know by submitting a

Anyone and everyone is welcome to contribute. Please see our [guidelines for contributing](https://github.com/esri/contributing).

### Repository Points of Contact
## Repository Points of Contact

#### Repository Owner: [Kevin](https://github.com/kgonzago)

Expand Down Expand Up @@ -210,6 +116,3 @@ 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](license.txt) file.

[](Esri Tags: Military Analyst Defense ArcGIS ArcObjects .NET WPF ArcGISSolutions ArcMap ArcPro Add-In Military-Tools-for-ArcGIS)
[](Esri Language: C-Sharp)
Loading

0 comments on commit 355e886

Please sign in to comment.