ArcMap

Symbolize by Line Thickness

Available with Business Analyst license.

Summary

Thematically maps a feature class based on a numeric field and displays it as a symbolized line.

Usage

  • You can display lines at different thicknesses to represent different values.

  • Graduated symbols work best for counts and amounts, since most people associate the size of the symbol with magnitude.

  • You can use this tool to display road segments with different thicknesses based on traffic volume during rush hour.

  • This tool can be used in conjunction with the Desire Lines tool. Desire lines can be displayed by total sales or number of visits for each customer.

Syntax

arcpy.ba.SymbolizeByLineThickness(InputFeatureLayer, Field, ClassificationSchemeParameterName, ColorParameterName, {NameField}, {UseSelectedFeatures})
ParameterExplanationData Type
InputFeatureLayer

The input feature layer.

Feature Layer
Field

The attribute field used to define the thematic map.

Field
ClassificationSchemeParameterName

The classification method to thematically map your input feature class.

  • Natural Breaks —Uses natural breaks classification to produce a thematic map.
  • Std Deviation —Uses standard deviation classification method to a produce a thematic map.
  • Equal Interval —Uses equal interval classification method to produce a thematic map.
  • Quantile —Uses quantile classification method to produce a thematic map.
String
ColorParameterName

The color assigned to the lines to be symbolized.

Long
NameField
(Optional)

The attribute field used in the normalization calculations.

Field
UseSelectedFeatures
true false
(Optional)

Identifies the features that will be used to generate the thematic map.

  • True —Uses only selected features to generate the thematic map.
  • False —Uses all features to generate the thematic map. This is the default.
Boolean

Code sample

SymbolizeByLineThickness example (stand-alone script)

# Name: SymbolizeByLineThickness.py
# Description: Symbolizes road layer by predefined line thickness.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business") 
 
# Defines the parameters for the Symbolize by Line Thickness tool
# Red point is -65536
  InputFeatureLayer = "C:/temp/roads.shp"
  Field = "FID"
  ClassificationSchemeParameterName = "Equal Interval"
  ColorParameterName = -65536
 
# Thematically symbolizes a layer by line thickness
  arcpy.SymbolizeByLineThickness_ba(InputFeatureLayer, Field, ClassificationSchemeParameterName, ColorParameterName)
 
# Release extension license 
arcpy.CheckInExtension("Business")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Requires Business Analyst
  • Standard: Requires Business Analyst
  • Advanced: Requires Business Analyst

Related topics