Convert Polygons (Production Mapping)
Summary
Deletes polygon features that are below a minimum size.
Illustration
Usage
A warning is raised if the input features are not in a projected coordinate system. This tool relies on linear distance units, which will create unexpected results in an unprojected coordinate system. It is strongly suggested that you run this tool on data in a projected coordinate system to ensure valid results. An error is raised and the tool will not process if the coordinate system is missing or unknown.
This tool cannot be run on data that is registered as versioned.
-
This tool is used in situations where topology exists between feature classes. An example is when you have a topology rule that lakes and vegetation should not overlap and a lake feature needs to be removed to accommodate the rule.
If one compare feature class is specified, features that are below the minimum size are deleted from the input polygon feature class and merged with the compare feature class.
When multiple compare feature classes are provided, the input feature is converted to the feature class that shares the longest boundary with the input feature. For instance, if a feature shares longer common boundaries with feature class A and a shorter boundary with feature class B, the feature will be merged with feature class A.
If this tool is run in an edit session in ArcMap, you can stop the edit session without saving changes to restore features that have been deleted.
Caution:This tool modifies the input data. See Tools with no outputs for more information and strategies to avoid undesired data changes.
Syntax
| Parameter | Explanation | Data Type |
Input_Polygon_Features |
The layer that contains polygons to be deleted. | Feature Layer |
Minimum_Size |
Polygons smaller than this will be deleted. | Areal unit |
Compare_Features [Compare_Features,...] |
The polygon features to which the input features are compared. If the input feature is smaller than the minimum size, it becomes part of the input features. | Feature Class |
Code Sample
The following sample script deletes a single building feature and replaces it with the AgricultureA feature class.
# Name: ConvertPolygonExample.py
# Description: Deletes polygons below a specified minimum size
# Author: Esri
# Date: July 2013
# Import arcpy module
import arcpy
# Check out Production Mapping license
arcpy.CheckOutExtension("Foundation")
arcpy.env.workspace="c:/Data/LocalGovernment.gdb"
# Define variables
inPolygons = "ReferenceData/FacilitySite"
inPolylyr="Facility"
where="FCODE='Park'"
size = '3000 SquareFeet'
compareFeatures = "ReferenceData/BuildingFootprint"
# Create feature layer for input features
arcpy.MakeFeatureLayer_management(inPolygons,inPolylyr)
# Compare the workspaces
arcpy.ConvertPolygons_production(inPolylyr,size,compareFeatures)