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

Dashed stroke patterns can be aligned by adding control points at the intersection of lines or polygon outlines.

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 such as 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.

Parameters

Dialog

Label	Explanation	Data Type
Input Features	The line or polygon feature layer.	Feature Layer
Input Secondary Features (Optional)	The line or polygon feature layer with features coincident to the input features.	Feature Layer

Derived Output

Label	Explanation	Data Type
Updated Input Features	The updated input features.	Feature Layer

Python

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

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

Derived Output

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

Code sample

SetControlPointAtIntersect example 1 (Python window)

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

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

SetControlPointAtIntersect example 2 (stand-alone script)

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

# 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