ArcMap

Polygon Coverage To Region

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.

Learn more about how Polygon Coverage To Region works

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

arcpy.arc.PolyRegion(in_cover, out_cover, out_subclass)
ParameterExplanationData 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

  • Basic: No
  • Standard: No
  • Advanced: Requires ArcInfo Workstation installed

Related topics