ArcMap

Symbolize by Non-numeric Field

Available with Business Analyst license.

Summary

Thematically maps a feature class based on a nonnumeric field.

Usage

  • This tool generates a map designed to convey information about a single topic or theme, such as population density.

  • Nonnumeric fields are used only when generating the thematic map. These values will be represented on the map as unique values based on the field used to symbolize.

  • Nonnumeric thematic maps cannot be normalized, since they contain no numeric data.

Syntax

arcpy.ba.SymbolizebyNonnumericField(InputFeatureLayer, Field, {UseSelectedFeatures}, {ColorSchemeParameterName})
ParameterExplanationData Type
InputFeatureLayer

The input feature layer.

Feature Layer
Field

The attribute field used to define the thematic map.

Field
UseSelectedFeatures
(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
ColorSchemeParameterName
(Optional)

A predefined color scheme for the thematic map.

String

Code sample

SymbolizeByNonNumericField example (stand-alone script)

# Name: SymbolizeByNonNumericField.py
# Description: Symbolizes customer layer by ID.
# 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 Nonnumeric Field tool
  InputFeatureLayer = "C:/temp/sf_cust.shp"
  Field = "NAME"
 
# Thematically symbolizes a layer by a nonnumeric field
  arcpy.SymbolizeByNonNumericField_ba(InputFeatureLayer, Field)
 
# 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