Available with Advanced license.
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
PolyRegion_arc (in_cover, out_cover, out_subclass)
| 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
PolyRegion example (stand-alone script)
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)
Environments
Licensing Information
- ArcGIS for Desktop Basic: No
- ArcGIS for Desktop Standard: No
- ArcGIS for Desktop Advanced: Requires ArcInfo Workstation installed