计算颜色定理字段 (制图)

摘要

填充一个整型字段，以便使用少量颜色对多边形进行符号化，并确保相邻面不使用相同颜色。

根据定理，每个面都会被分配一个值，该定理表明，在二维地图中，通常只需四到五种颜色即可确保相邻面的颜色不同。 重叠或多部件的面可能会增加所需颜色数量。 分配的值为 1 到唯一值数量之间的整数。

插图

每个要素将被分配一个整数，用于符号化图层，确保相邻面的颜色不同。

使用情况

• 该工具不会创建新的输出。 它通过在新字段或现有字段中分配整数来修改输入字段，这些值用于在唯一值符号系统中符号化要素。

• 下列情况会被视为面相邻：

  • 面共享包含至少两个这点的边界段。
  • 面重叠。
  • 面之间有少量空白（如相邻的小岛）。

• 仅在单个折点接触的面可以分配相同的值。

• 被少量空白隔开但未接触的面，可能仍根据其形状和距离分配相同值。

• 多部件要素仅能分配一个值，因此在符号化时，多部件要素的所有部件将显示为相同颜色。 若需让每个部件获得不同的值，可以将多部件要素拆分为单独要素。 相反，若需确保多个要素获得相同值，可以将其合并为多部件要素。

• 该工具会尝试平衡每个唯一值的出现次数。 但不保证唯一值的空间分布均匀。

参数

对话框

标注	说明	数据类型
输入要素	输入面将使用工具结果符号化要素。	Feature Layer
字段名称（现有或新建）	用于存储工具结果的字段。 每个要素将被分配一个介于 1 到唯一值之间的整数，确保相邻面分配不同的值。 若字段不存在，工具将创建一个短整型字段。 若指定了现有字段，则其数据类型必须为短整型、长整型或大整型。 现有值将被工具结果覆盖。	Field

派生输出

标注	说明	数据类型
输出要素	更新后的输入要素。	Feature Layer

Python

arcpy.cartography.CalculateColorTheoremField(in_features, field_name)

名称	说明	数据类型
in_features	输入面将使用工具结果符号化要素。	Feature Layer
field_name	用于存储工具结果的字段。 每个要素将被分配一个介于 1 到唯一值之间的整数，确保相邻面分配不同的值。 若字段不存在，工具将创建一个短整型字段。 若指定了现有字段，则其数据类型必须为短整型、长整型或大整型。 现有值将被工具结果覆盖。	Field

派生输出

名称	说明	数据类型
out_features	更新后的输入要素。	Feature Layer

代码示例

CalculateColorTheoremField 示例（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 CalculateColorTheoremField 函数。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.cartography.CalculateColorTheoremField("countries", "color_index")

CalculateColorTheoremField 示例 2（独立脚本）

以下独立脚本演示了如何使用 CalculateColorTheoremField 函数。

# Name: CalculateColorTheorem_standalone_script.py
# Description: Populates a number field to use for symbolizing 
# polygons with a small number of colors and ensuring no two adjacent 
# polygons are the same color.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inPolygonFeatures = "countries"
fieldName = "color_index"

# Execute Calculate Color Theorem Field
arcpy.cartography.CalculateColorTheoremField(inPolygonFeatures, 
                                             fieldName)

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是