GraduatedColorsRenderer

描述

GraduatedColorsRenderer 类表示分级色彩渲染器定义,即使用一系列色彩显示要素值的定性差异。

讨论

这些属性的行为类似于应用程序中显示的选项。例如,更改分类数会自动调整间隔值及其标注。如果更改 ClassBreakupperBound,则 classificationMethod 会自动更改为 ManualInterval。您同样需要相应地手动更新 labels 和/或 descriptions

属性

属性说明数据类型
breakCount
(可读写)

表示与当前分类方法配合使用的分类数的整数。

Integer
classBreaks
(可读写)

ClassBreak 对象列表用于访问诸如 labeldescription 的单个属性以及单个符号对象。

List
classificationField
(可读写)

表示用于图层分类方法的有效字段名称的字符串。

String
classificationMethod
(可读写)

表示有效分类方法的字符串。有效值如下:

  • DefinedInterval定义的间隔
  • EqualInterval相等间隔
  • GeometricInterval几何间隔
  • ManualInterval手动间隔
  • NaturalBreaks自然间断点分级法 (Jenks)
  • Quantile分位数
  • StandardDeviation标准差
String
colorRamp
(可读写)

提供对 ColorRamp 对象的访问权限。

ColorRamp
deviationInterval
(可读写)

表示有效差间隔的双精度值,仅当 classificationMethod 被设为 StandardDeviation 时才可用。有效值为 1.0、0.5、0.333 和 0.25。这些是应用程序提供的相同选项。

Double
intervalSize
(可读写)

表示间隔大小的双精度值,仅当 classificationMethod 被设为 DefinedInterval 时才可用。

Double
normalizationField
(可读写)

表示用于归一化的有效图层字段名称的字符串。

String
normalizationType
(可读写)

表示有效归一化关键字的特定字符串。例如,要清除归一化,请尝试 gradColors.renderer.nomalizationType = "<None>"

  • <None>无归一化
  • <percentage of total>总值百分比
  • <log>日志
String
type
(只读)

返回表示渲染器类型的字符串。

String

代码示例

GraduatedColorsRenderer 示例 1

以下脚本首先测试图层的符号系统是否支持 renderer 属性,然后确认渲染器是否为 SimpleSymbolRenderer。接下来,将该渲染器更改为 GraduatedColorsRenderer,它将更改 classificationFieldbreakCount。最后,将 ColorRamp 更改为名为青色到紫色的色带。

import arcpy, os, sys

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

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

if hasattr(sym, 'renderer'):
  if sym.renderer.type == 'SimpleRenderer':
    sym.updateRenderer('GraduatedColorsRenderer')
    sym.renderer.classificationField = 'Shape_Area'
    sym.renderer.breakCount = 10
    sym.renderer.colorRamp = p.listColorRamps('Cyan to Purple')[0]

    l.symbology = sym

p.saveACopy(relpath + r'\\SavedOutput.aprx')
GraduatedColorsRenderer 示例 2

以下脚本用于对使用分级色彩渲染器的面图层的符号系统进行修改。它将设置 classificationFieldbreakCount,遍历每一个分类间隔并修改 upperBoundlabeldescription,以及诸如 coloroutlineColorsize 等符号属性。每一个间隔的标注都格式化为包含上千个分隔符。填充颜色由红色向蓝色渐变,轮廓颜色由蓝色变为红色且每个间隔处的尺寸会增加。

# -*- coding: utf-8 -*-
import arcpy, os, sys, locale

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

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

sym = l.symbology
sym.renderer.classificationField = "Shape_Area"
sym.renderer.breakCount = 7

breakVal = 100000000000
cv = 0
lw = 1
for brk in sym.renderer.classBreaks:
  brk.upperBound = breakVal
  brk.label = "\u2264" + str(locale.format("%d", breakVal, grouping=True))
  brk.description = "Description " + str(cv)
  brk.symbol.color = {'HSV' : [cv, 100, 100, 100]}
  brk.symbol.outlineColor = {'HSV' : [240-cv, 100, 100, 100]}
  brk.symbol.size = lw

  breakVal +=100000000000
  cv += 40
  lw += 0.5
l.symbology = sym

p.saveACopy(relpath + r'\\SavedOutput.aprx')