Calculate Line Caps (Cartography)


Modifies the cap type (ending style) for representation stroke symbols and stores it as a representation override.


Calculate Line Caps



CalculateLineCaps_cartography (in_features, {cap_type}, {dangle_option})
ParameterExplanationData Type

The input feature layer containing line representations.


Defines how the ends of representation stroke symbols are drawn. The default cap type of representation strokes is round, where the symbol is terminated with a semicircle of radius equal to stroke width is centered at the line endpoint. This tool changes cap type to BUTT or SQUARE.

  • BUTTSpecifies to end the representation stroke symbol exactly where the line geometry ends. This is the default.
  • SQUARESpecifies to end the representation stroke symbol with closed, square caps that extend past the endpoint of the line by half of the symbol width.

The Dangle parameter controls how line caps are calculated for adjoining line features that share an endpoint but are drawn with different representation symbology.

  • CASED_LINE_DANGLEModifies the cap style for dangling lines (those not connected at their endpoints to another line) and also for the lines where a cased-line representation stroke symbol is joined at the endpoint of a single-line representation stroke symbol. This is the default.
  • TRUE_DANGLEModifies the cap style only for endpoints that are not connected to another feature.

Code Sample

CalculateLineCaps tool Example (Python Window)

The following Python Window script demonstrates how to use the CalculateLineCaps tool in immediate mode.

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

arcpy.CalculateLineCaps_cartography("roads.lyr", "BUTT", "CASED_LINE_DANGLE")
CalculateLineCaps tool Example (Stand-alone Python script)

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

# Name:
# Description: calculates a value for the line cap property of a representation stroke layer
# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_features = "roads.lyr"
cap_type = "BUTT"
dangle_option = "CASED_LINE_DANGLE"

# Execute Calculate Line Caps
arcpy.CalculateLineCaps_cartography(in_features, cap_type, dangle_option)


This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcView: No
ArcEditor: Yes
ArcInfo: Yes