ArcMap

Symbolize by Chart

Available with Business Analyst license.

Summary

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

Usage

  • Charts can be effective for comparing several values at once. For example, you could display ZIP Codes as a pie chart, with each wedge representing population by race.

  • Compares only a few areas (20 or 30 at most).

  • Use five or less categories on your chart.

  • Make sure the values between points vary enough to show differences.

Syntax

arcpy.ba.SymbolizeByChart(InputFeatureLayer, ChartType, SelectedFields, {UseSelectedFeatures}, {ColorScheme})
ParameterExplanationData Type
InputFeatureLayer

The input feature layer.

Feature Layer
ChartType

The type of chart to be displayed in the thematic map.

  • Pie Chart —Creates a pie chart for selected variables.
  • Bar Chart —Creates a bar chart for selected variables.
String
SelectedFields
[SelectedField,...]

The attributes to be symbolized in the chart.

Field
UseSelectedFeatures
(Optional)

Defines 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
ColorScheme
(Optional)

Selects a predefined color scheme for the thematic map.

String

Code sample

SymbolizeByChart example (stand-alone script)

# Name: SymbolizeByChart.py
# Description: Symbolizes block groups by total population and total households.
# 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 Chart tool
  InputFeatureLayer = "C:/ArcGIS/Business Analyst/US_2022/Data/Demographic Data/BlockGroups_bg.bds"
  ChartType = "Bar Chart"
  SelectedFields = "TOTPOP_CY;HHPOP_CY"
 
# Thematically symbolizes a layer by chart
  arcpy.SymbolizeByChart_ba (InputFeatureLayer, ChartType, SelectedFields)
 
# 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