Help

Symbolize by Chart

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

SymbolizeByChart_ba (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 arcpy

arcpy.AddToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.3\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business") 
 
# Defines the parameters for the Symbolize by Chart tool
  Input = "C:/ArcGIS/Business Analyst/US_2014/Data/Demographic Data/esri_bg.bds"
  Flds= "TOTPOP_CY;HHPOP_CY"
 
# Thematically symbolizes a layer by chart
  arcpy.SymbolizeByChart_ba (Input, "Bar Chart", Flds)
 
# Release extension license 
  arcpy.CheckInExtension("Business")
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Licensing Information

  • ArcGIS for Desktop Basic: Requires Business Analyst
  • ArcGIS for Desktop Standard: Requires Business Analyst
  • ArcGIS for Desktop Advanced: Requires Business Analyst

Related Topics

Feedback on this topic?