Symbolize by Chart (Business Analyst)

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})

Parameter	Explanation	Data 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\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

try:
  # Acquire extension license 
  arcpy.CheckOutExtension("Business") 
 
  # Defines the parameters for the Symbolize by Chart tool
  Input = "C:/Program Files/ArcGIS/Desktop10.0/Business Analyst/Data/BDS/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

ArcView: Requires Business Analyst

ArcEditor: Requires Business Analyst

ArcInfo: Requires Business Analyst