Set Control Point By Angle (Cartography)

Summary

Places a control point at vertices along a line or polygon outline where the angle created by a change in line direction is less than or equal to a specified maximum angle.

Illustration

Set Control Point By Angle tool example
Dash placement can be improved along a line or polygon outline when control points are placed at prominent angles.

Usage

Parameters

LabelExplanationData Type
Input Features

The feature layer containing line or polygon features.

Feature Layer
Maximum Angle (decimal degrees)

The angle used to determine whether a vertex along a line or polygon outline will be set as a control point. The angle value must be greater than zero and less than 180 decimal degrees.

Double

Derived Output

LabelExplanationData Type
Updated Input Features

The updated input features.

Feature Layer

arcpy.cartography.SetControlPointByAngle(in_features, maximum_angle)
NameExplanationData Type
in_features

The feature layer containing line or polygon features.

Feature Layer
maximum_angle

The angle used to determine whether a vertex along a line or polygon outline will be set as a control point. The angle value must be greater than zero and less than 180 decimal degrees.

Double

Derived Output

NameExplanationData Type
out_representations

The updated input features.

Feature Layer

Code sample

SetControlPointByAngle example 1 (Python window)

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

import arcpy
arcpy.env.workspace = "C:\data"

arcpy.SetControlPointByAngle_cartography("trails.lyrx", "135")
SetControlPointByAngle example 2 (stand-alone Python script)

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

# Name: SetControlPointByAngle_standalone_script.py
# Description: Places a control point at vertices along a line or polygon
#              outline where the angle created by a change in line direction is
#              less than or equal to a specified maximum angle

# Import system modules
import arcpy

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

# Set local variables
in_layer = "trails.lyrx"
minimum_angle_deviation = "135"

# Execute Set Representation Control Point At Intersect
arcpy.SetControlPointByAngle_cartography(in_layer, minimum_angle_deviation)

Environments

Licensing information

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

Related topics