Polygon Coverage To Region (Coverage)
Summary
Converts polygons to regions in a one-to-one mapping in a region subclass.
Each polygon in the Input Coverage becomes a region in the Output Subclass. Attributes in the polygon attribute table (PAT) are copied to the corresponding region PATsubclass. The Output Coverage can be the same as the Input Coverage; if so, the Output Subclass is then created in the Input Coverage.
Usage
-
This tool can be used on an Input Coverage that does not have arc topology; however, the Input Coverage must have polygon topology.
-
The tool builds region topology for the Output Subclass. Topology in the Input Coverage is maintained in the Output Coverage.
-
When the Output Coverage is not the same as the Input Coverage, a new coverage will be created, and the Input Coverage is copied to the Output Coverage.
-
The Output Coverage cannot refer to an existing coverage unless it's the Input Coverage.
-
Polygon attributes are copied to the region subclass.
-
Region subclass names may be from 1 to 13 characters and cannot start with a numeric character.
Syntax
| Parameter | Explanation | Data Type |
in_cover |
The polygon coverage to be converted to a region subclass. Each polygon of the <in_cover> is made into a region. | Coverage |
out_cover |
The coverage that will contain the new subclass. | Coverage |
out_subclass |
The name of the region subclass that will be created. | String |
Code Sample
The following stand-alone script demonstrates how to create a region coverage from a polygon coverage.
# Name: PolyRegion_Example.py
# Description: Creates a region coverage from a polygon coverage
# Requirements: ArcInfo Workstation
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inCover = "citylim"
outCover = "C:/output/cityregions"
outSubclass = "city"
# Execute PolyRegion
arcpy.PolyRegion_arc(inCover, outCover, outSubclass)