Skip to main content
Skip table of contents

Manually Linking a Polygon 🔗

What is the Link Polygons Tool?

The Link Polygons Tool is a GIS tool that exists in the W Energy Spatial Add-In. This is a proprietary extension that lives on top of ArcGIS Desktop similar to how Google Chrome can host 3rd party vendor extensions such as AdBlock.

This tool links polygons to Land Legal Items and rolls that polygon up to the parent Tract and Agreement.

Why would a client use the Link Polygons Tool?

Some Land Legal Descriptions are too complex for the Automapper to automap, thus they need to be manually drawn and linked. For example, the following Metes & Bounds Description is too difficult for a machine to decipher and accurately map.

Beginning at the SW Corner of the West 1/2 of East 1/2 of NE 1/4 of NW 1/4 of Section 18 Township 2 North, Range 14 East and run S 0 degrees 04’09” W 39 feet to the North right of way line of Silver Lake Road and the Point of Beginning.

As a result, the default configuration does not have the Automapper attempt to automap Land Legal Items where the Metes & Bounds field is populated.

How to setup the Link Polygons Tool in the system

The Link Polygons Tool is not setup by Services but rather by a GIS Developer. The tool is a part of the W Energy Spatial Add-In which is a toolbar that includes the Link Polygons tool. This add-in can be requested in a ticket similar to the one referenced below:

WEMAIN-4882

How to Use the Link Polygons Tool

  1. In ArcMap, expand the Folder Connections tab in the Catalog Pane.

  2. Right-click under one of the folder connections and select New / File Geodatabase.

  3. You can rename the file geodatabase if you wish.

  4. Right-click on the newly created file geodatabase.

  5. Select New / Feature Class.

  6. In the window, provide the feature class with a name.

  7. This feature class will hold the legal item polygons that we draw and will manually link to legal items.

  8. Care should be taken in making sure that the correct Coordinate System is selected.

  9. Add the LEGAL_DESCRIPTION_ID field with the corresponding data type to the feature class:

  10. Ensure the LEGAL_DESCRIPTION_ID field is in all caps.

  11. The new feature class should have been added to the dataframe, but if it has not, please add it.

  12. In the Table of Contents, right-click on the feature class.

  13. Select Open Attribute Table.

  14. Right-click on the feature class once more.

  15. Select Edit Features / Start Editing.

  16. In the Editor Toolbar at the top, select the Create Feature icon.

  17. In the Create Features pane, select the feature class followed by a shape in the Construction Tools.

  18. We are ready to draw a polygon.

  19. We will now find which legal items have not been mapped with a Metes & Bounds Description.

  20. In the W main application, navigate to the Land Inquiry / Spatial Report Viewer screen.

  21. Add in the following filters to the following fields:

    1. Map Status - Legal: Not Mapped | NULL(TRUE)

    2. Tract Number - <> NULL

  22. Once the legal item has been selected from the list, copy the id from the legal items table.

  23. This will serve as the identifier for the polygon we will draw.

  24. Drag and drop the grid data that will be used as a stencil to draw the polygon.

  25. Without any reference polygon in the background, I could be drawing a polygon too large to be linked, so I zoomed into a West Virginia tax parcel.

  26. In the Construction Tools, I selected a polygon and drew the shape in the dataframe.

  27. In the Attribute Table of the legals_link feature class, paste the copied id into the LEGAL_DESCRIPTION_ID and Legal_Id fields.

  28. In the Editor Toolbar, select Save Edits followed by Stop Editing.

  29. Close the Create Features pane.

  30. Remove the grid data and the legal_items table from the Table of Contents.

  31. In the Table of Contents, right-click on the feature class with the newly drawn polygon.

  32. Select Selection / Make This The Only Selectable Layer.

  33. In the toolbar at the top, select the Select Features tool.

  34. Selecting records from the Attribute Table is an alternative method as well.

  35. In the dataframe, select the polygon that will be manually linked.

  36. Select the Link Polygons tool in the toolbar.

  37. A window will appear.

  38. In the window, select OK.

  39. The Link Polygons tool will take around 40 seconds base plus some amount of time per polygon.

  40. The Link Polygons tool will have completed once the time elapsed appears at the bottom of the results screen.

  41. Please close out of the window.

  42. Drag and drop the all_legals feature class into the dataframe.

  43. Open the Attribute Table of the all_legals layer.

  44. Notice how the manually drawn and linked polygon is included in the layer.

  45. Under the all_legals layer, each legal item has its own polygon.

  46. For the legal items that share the same tract number (Ex. EXCO 144A), these legal item polygons will be dissolved into wherever these legal item polygons share a border.

  47. By dragging and dropping the all_tracts layer into the dataframe, we can see the 3 legal items that all had EXCO 144A as the tract number were dissolved into 1 polygon.

  48. As we can see in the all_tracts layer, all of the tracts share the same agreement number, thus all of the borders that these polygons share will be dissolved once we drag and drop the all_agreements layer into the dataframe.

  49. Confirm the legal item polygon was included in the ws_* layers by dragging and dropping those layers into the dataframe.

Other items worth noting that would impact the process.

Known issues with the process

The following are not issues with the process but rather common user errors that can arise.

  • The Link Polygons Tool may error out if the size of the polygon being linked is too large. If the polygon is the size of Texas, for example, the tool will not link. Standard 640 acre PLSS Sections are better sizes for linking.

  • If the LEGAL_DESCRIPTION_ID for the polygon that is trying to be linked does not exist in the dbo.legal_items table, then the Link Polygons Tool will error out. The solution is to ensure the LEGAL_DESCRIPTION_ID on the polygon being linked exists in dbo.legal_items.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.