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

Set Control Point At Intersect tool example
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

LabelExplanationData 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

LabelExplanationData Type
Updated Input Features

The updated input features.

Feature Layer

arcpy.cartography.SetControlPointAtIntersect(in_line_or_polygon_features, {in_features})
NameExplanationData 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

NameExplanationData 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)

Licensing information

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

Related topics