Line Coverage To Region (Coverage)

Summary

Converts arcs to preliminary regions in a new or existing coverage or appends preliminary regions to an existing region subclass.

Arcs are grouped into preliminary regions based on the unique value of the Line item and must form closed loops. The unique values are saved in the output subclass Region item.

Learn more about how Line Coverage To Region works

Illustration

Line to Region illustration

Usage

Syntax

RegionClass_arc (in_cover, {out_cover}, out_subclass, {in_region_item}, {out_region_item}, {selection_file}, {method})
ParameterExplanationData Type
in_cover

The coverage containing the arcs from which the preliminary regions are created.

Coverage
out_cover
(Optional)

The coverage that will contain the preliminary regions. If the output coverage is not specified, the preliminary regions are created in the input coverage.

Coverage
out_subclass

The name of the region subclass to be created or appended.

String
in_region_item
(Optional)

Item in the AAT of the input coverage whose values are used to group arcs into preliminary regions. The item is appended to the region PATsubclass. If not specified, each group of arcs becomes a preliminary region.

ArcInfo Item
out_region_item
(Optional)

Output name for the input region Item to be used in the region PATsubclass instead of the Input Region Item name.

String
selection_file
(Optional)

The name of a selection file that can be used to specify a subset of the arcs to be grouped into preliminary regions.

File
method
(Optional)

Determines whether regions will be created from multiple rings of arcs or single rings of arcs.

  • MULTIRINGCreates regions from multiple rings of arcs whose values for the input region item are identical.
  • SINGLERINGEach ring of arcs becomes a region.
String

Code Sample

RegionClass example (stand-alone script)

The following stand-alone script demonstrates how to create a region coverage from a line coverage.

# Name: RegionClass_Example.py
# Description: Creates regions in a line coverage
# Requirements: ArcInfo Workstation
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inCover = "tong_azone"
outSubclass = "districts"
method = "SINGLERING"

# Execute RegionClass
arcpy.RegionClass_arc(inCover, "", outSubclass, "", "", "", method)
arcpy.Build_arc(inCover, "POLY")

Environments

Related Topics

Licensing Information

ArcView: No
ArcEditor: No
ArcInfo: Requires ArcInfo Workstation installed

Published 6/8/2010