Set Control Point At Intersect (Cartography)

Summary

Creates a control point at vertices that are shared by one or more line or polygon features. This tool is commonly used to synchronize boundary symbology on adjacent polygons.

Illustration

Usage

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

• Control points can be used to control the phasing of patterned symbology like dashed lines. Use this tool to synchronize phased outline symbology on adjacent polygons.

• The primary input must be a line or polygon feature class. The secondary input can be a point, line, or polygon feature class. Secondary features provide geometry for comparison to the primary input features.

• Existing control points will not be removed.

• When only one layer is input, control points will created only where three segments form an intersection. When secondary features are input, control points are added where segments intersect.

• Both input layers can accept multipart geometry.

• Control points cannot be added to shapefiles.

• Processing large datasets may exceed memory limitations. In this case, consider processing input data by partition by identifying a relevant polygon feature class in the Cartographic Partitions environment setting. Portions of the data, defined by partition boundaries, will be processed sequentially. The result will be seamless and consistent at partition edges.

Syntax

arcpy.cartography.SetControlPointAtIntersect(in_line_or_polygon_features, {in_features})

Parameter	Explanation	Data Type
in_line_or_polygon_features	The line or polygon feature layer.	Feature Layer
in_features (Optional)	The feature layer with coincident features.	Feature Layer

Derived Output

Name	Explanation	Data Type
out_representations	The updated input features.	Feature Layer

Code sample

SetControlPointAtIntersect example (Python window)

The following Python window script demonstrates how to use the SetControlPointAtIntersect tool in immediate mode.

import arcpy
arcpy.env.workspace = "C:\data"
arcpy.env.cartographicPartitions = "partitions.lyrx"
arcpy.SetControlPointAtIntersect_cartography("parcels.lyrx", "roads.lyrx")

SetControlPointAtIntersect example (stand-alone script)

This stand-alone script shows an example of using the SetControlPointAtIntersect tool.

# Name: SetControlPointAtIntersect_standalone_script.py
# Description: Creates a control point at vertices that are shared by one or 
#              more line or polygon features. 

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"
arcpy.env.cartographicPartitions = "partitions.lyrx"

# Set local variables
in_line_or_polygon_features = "parcels.lyrx"
in_features = "roads.lyrx"

# Execute Set Representation Control Point At Intersect
arcpy.SetControlPointAtIntersect_cartography(in_line_or_polygon_features, 
                                             in_features)

Environments

Cartographic Partitions

Licensing information

• Basic: No
• Standard: No
• Advanced: Yes