GraduatedSymbolsRenderer

Synthèse

The GraduatedSymbolsRenderer class represents the graduated symbols renderer definition that shows qualitative differences in feature values using a range of symbol sizes.

Discussion

The properties behave in a similar manner to the options exposed in the application. For example, changing the number of classes will automatically adjust the break values and their labels. If you change upperBound of a ClassBreak, the classificationMethod automatically changes to ManualInterval. You also need to manually update the labels and/or descriptions properties accordingly.

Propriétés

PropriétéExplicationType de données
backgroundSymbol
(Lecture et écriture)

A symbol that represents the background symbol for the features in the layer. It only applies to polygon feature classes.

Symbol
breakCount
(Lecture et écriture)

An integer that represents the number of classes to be used with the current classification method.

Integer
classBreaks
(Lecture et écriture)

A list of ClassBreak objects that provides access to individual properties such as label and description as well as individual symbol objects.

List
classificationField
(Lecture et écriture)

A string that represents a valid field name used for the layer's classification method.

String
classificationMethod
(Lecture et écriture)

A string that represents a valid classification method. The valid values are as follows:

  • DefinedIntervalDefined Interval
  • EqualIntervalEqual Interval
  • GeometricIntervalGeometric Interval
  • ManualIntervalManual Interval
  • NaturalBreaksNatural Breaks (Jenks)
  • QuantileQuantile
  • StandardDeviationStandard Deviation
String
colorRamp
(Lecture et écriture)

Provides access to the ColorRamp object.

ColorRamp
deviationInterval
(Lecture et écriture)

A double that represents a valid deviation interval that is only available if the classificationMethod is set to StandardDeviation. Valid values are 1.0, 0.5, 0.333, and 0.25. These are the same options available in the application.

Double
intervalSize
(Lecture et écriture)

A double that represents an interval size that is only available if the classificationMethod is set to DefinedInterval. Valid values are 1.0, 0.5, 0.333, and 0.25. These are the same options available in the application.

Double
maximumSymbolSize
(Lecture et écriture)

A double that represents the size of the largest graduated symbol.

Double
minimumSymbolSize
(Lecture et écriture)

A double that represents the size of the smallest graduated symbol.

Double
normalizationField
(Lecture et écriture)

A string that represents a valid layer field name that is used for normalization.

String
normalizationType
(Lecture et écriture)

A specific string that represents a valid normalization key word. For example, to clear the normalization, try gradSymbols.renderer.nomalizationType = "<None>".

  • <None>No normalization
  • <percentage of total>Percentage of total
  • <log>Log
String
symbolTemplate
(Lecture seule)

Returns a symbol that represents the symbol template for all the features in the layer. To set the template use the updateSymbolTemplate method.

Symbol
type
(Lecture seule)

Returns a string that represents the renderer type.

String

Vue d’ensemble des méthodes

MéthodeExplication
updateSymbolTemplate (symbol_template)

updateSymbolTemplate provides a mechanism to change the renderer's symbol template.

Méthodes

updateSymbolTemplate (symbol_template)
ParamètreExplicationType de données
symbol_template

A reference to a symbol.

(La valeur par défaut est None)

Object

The updateSymbolTemplate method allows you to modify the symbol for all the class breaks at once. The symbol template is managed in the application differently than other renderer properties, for example, backgroundSymbol, and therefore requires a method to set the symbol template to the renderer.

Exemple de code

GraduatedSymbolsRenderer example

The following script first tests if the layer's symbology supports a renderer property. It then confirms if the renderer is a GraduatedSymbolsRenderer. Next, it sets up the backgroundSymbol and symbolTemplate. Next, it changes the classificationField and breakCount and also sets the minimum and maximum symbol sizes. Finally, it changes ColorRamp to a color ramp named Black to White.

import arcpy, os, sys
relpath = os.path.dirname(sys.argv[0])

p = arcpy.mp.ArcGISProject(relpath + r"\\GraduatedSymbols.aprx")
m = p.listMaps("Layers")[0]
l = m.listLayers("Natural*")[0]
sym = l.symbology

if hasattr(sym, 'renderer'):
  if sym.renderer.type == "GraduatedSymbolsRenderer":
    #set background symbol
    sym.renderer.backgroundSymbol.applySymbolFromGallery("Extent Transparent Wide Gray")
    #set symbol template
    symTemp = sym.renderer.symbolTemplate
    symTemp.applySymbolFromGallery('Square 1')
    sym.renderer.updateSymbolTemplate(symTemp)
    #modify graduated symbol renderer
    sym.renderer.classificationField = "Shape_Area"
    sym.renderer.breakCount = 6
    sym.renderer.minimumSymbolSize = 10
    sym.renderer.maximumSymbolSize = 25
    sym.renderer.colorRamp = p.listColorRamps("Black to White")[0]

    l.symbology = sym
p.saveACopy(relpath + r"\\SavedOutput.aprx")