创建属性域 (数据管理)

摘要

在指定工作空间中创建属性域。

使用情况

  • 属性域管理包括以下内容:

    1. 使用此工具创建属性域。
    2. 使用向属性域添加编码值设置值域范围工具,向属性域添加值或设置属性域的取值范围。
    3. 使用指定字段的属性域工具将属性域和要素类相关联。
  • 编码值属性域仅支持默认值、复制分割策略和默认值合并策略。

  • 范围属性域支持所有分割与合并策略。 执行了分割或合并操作后,会根据输入要素的数值和指定的分割或合并策略来计算输出要素的属性值。

参数

标注说明数据类型
输入工作空间

将包含新属性域的地理数据库。

Workspace
域名称

要创建的属性域的名称。

String
属性域描述
(可选)

要创建的属性域的描述。

String
字段类型
(可选)

指定要创建的属性域的类型。 属性域属性是描述字段类型允许值的规则。 指定的字段类型应与将属性域指定到的字段的数据类型相匹配。

  • 文本将创建一个包含字符串的文本类型字段。
  • 浮点型(单精度)将创建一个包含介于 -3.4E38 和 1.2E38 之间的小数的浮点类型字段。
  • 双精度型(双精度)将创建一个包含介于 -2.2E308 和 1.8E308 之间的小数的双精度类型字段。
  • 短整型(小整数)将创建一个包含介于 -32,768 和 32,767 之间的整数的短整型类型字段。
  • 长整型(大整数)将创建一个包含介于 -2,147,483,648 和 2,147,483,647 之间的整数的长整型类型字段。
  • 日期将创建一个包含日期和/或时间的日期类型字段。
String
属性域类型
(可选)

指定要创建的属性域的类型。

  • 编码值属性域将创建一个包含属性的一组有效值的编码类型属性域。 这是默认设置。 例如,可用编码值属性域指定有效的管道材料值:如 CL - 铸铁管、DL - 球墨铸铁管或 ACP - 石棉混凝土管。
  • 值域范围将创建一个包含数值属性有效值范围的范围类型属性域。 例如,如果给水干管的压力介于 50 和 75 psi 之间,则可用范围属性域指定这些最大值和最小值。
String
分割策略
(可选)

指定将用于所创建属性域的分割策略。 分割要素时,属性值的行为受控于它的分割策略。

  • 使用属性的默认值两个结果要素的属性将使用给定要素类或子类型的默认属性值。
  • 复制属性值两个结果要素的属性使用原始对象的属性值副本。
  • 使用几何比结果要素的属性将是原始要素值的比率。 该比率取决于原始几何的分割比例。 如果几何被分割成相等的两部分,则每个新要素的属性值将是原始对象属性值的一半。 几何比策略仅适用于范围属性域。
String
合并策略
(可选)

指定将用于所创建属性域的合并策略。 在将两个要素合并为一个要素时,合并策略控制着新要素的属性值。

  • 使用属性的默认值结果要素的属性将使用给定要素类或子类型的默认属性值。 这是唯一适用于非数字字段和编码值属性域的合并策略。
  • 值的总和结果要素的属性将使用原始要素属性值的总和。 总和值策略仅适用于范围属性域。
  • 面积加权平均值结果要素的属性将使用原始要素属性值的加权平均值。 此平均值取决于原始要素的几何。 加权面积策略仅适用于范围属性域。
String

派生输出

标注说明数据类型
更新的输入工作空间

已更新的输入工作空间。

Workspace

arcpy.management.CreateDomain(in_workspace, domain_name, {domain_description}, {field_type}, {domain_type}, {split_policy}, {merge_policy})
名称说明数据类型
in_workspace

将包含新属性域的地理数据库。

Workspace
domain_name

要创建的属性域的名称。

String
domain_description
(可选)

要创建的属性域的描述。

String
field_type
(可选)

指定要创建的属性域的类型。 属性域属性是描述字段类型允许值的规则。 指定的字段类型应与将属性域指定到的字段的数据类型相匹配。

  • TEXT将创建一个包含字符串的文本类型字段。
  • FLOAT将创建一个包含介于 -3.4E38 和 1.2E38 之间的小数的浮点类型字段。
  • DOUBLE将创建一个包含介于 -2.2E308 和 1.8E308 之间的小数的双精度类型字段。
  • SHORT将创建一个包含介于 -32,768 和 32,767 之间的整数的短整型类型字段。
  • LONG将创建一个包含介于 -2,147,483,648 和 2,147,483,647 之间的整数的长整型类型字段。
  • DATE将创建一个包含日期和/或时间的日期类型字段。
String
domain_type
(可选)

指定要创建的属性域的类型。

  • CODED将创建一个包含属性的一组有效值的编码类型属性域。 这是默认设置。 例如,可用编码值属性域指定有效的管道材料值:如 CL - 铸铁管、DL - 球墨铸铁管或 ACP - 石棉混凝土管。
  • RANGE将创建一个包含数值属性有效值范围的范围类型属性域。 例如,如果给水干管的压力介于 50 和 75 psi 之间,则可用范围属性域指定这些最大值和最小值。
String
split_policy
(可选)

指定将用于所创建属性域的分割策略。 分割要素时,属性值的行为受控于它的分割策略。

  • DEFAULT两个结果要素的属性将使用给定要素类或子类型的默认属性值。
  • DUPLICATE两个结果要素的属性使用原始对象的属性值副本。
  • GEOMETRY_RATIO结果要素的属性将是原始要素值的比率。 该比率取决于原始几何的分割比例。 如果几何被分割成相等的两部分,则每个新要素的属性值将是原始对象属性值的一半。 几何比策略仅适用于范围属性域。
String
merge_policy
(可选)

指定将用于所创建属性域的合并策略。 在将两个要素合并为一个要素时,合并策略控制着新要素的属性值。

  • DEFAULT结果要素的属性将使用给定要素类或子类型的默认属性值。 这是唯一适用于非数字字段和编码值属性域的合并策略。
  • SUM_VALUES结果要素的属性将使用原始要素属性值的总和。 总和值策略仅适用于范围属性域。
  • AREA_WEIGHTED结果要素的属性将使用原始要素属性值的加权平均值。 此平均值取决于原始要素的几何。 加权面积策略仅适用于范围属性域。
String

派生输出

名称说明数据类型
out_workspace

已更新的输入工作空间。

Workspace

代码示例

CreateDomain 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CreateDomain_management("montgomery.gdb", "Materials", 
                              "Valid pipe materials", "TEXT", "CODED")
CreateDomain 示例 2(独立脚本)

此独立脚本将 CreateDomain 函数用作工作流的一部分,以创建属性域、为其赋值并将属性域分配给要素类的字段。

# Name: MakeDomain.py
# Description: Create an attribute domain to constrain pipe material values
 
# Import system modules
import arcpy
 
# Set the workspace (to avoid having to type in the full path to the data 
# every time)
arcpy.env.workspace = "C:/data"
 
# Set local parameters
domName = "Material4"
gdb = "montgomery.gdb"
inFeatures = "Montgomery.gdb/Water/Distribmains"
inField = "Material"

# Process: Create the coded value domain
arcpy.CreateDomain_management("montgomery.gdb", domName, "Valid pipe materials", 
                              "TEXT", "CODED")

# Store all the domain values in a dictionary with the domain code as the "key" 
# and the domain description as the "value" (domDict[code])
domDict = {"CI":"Cast iron", "DI": "Ductile iron", "PVC": "PVC", 
           "ACP": "Asbestos concrete", "COP": "Copper"}
    
# Process: Add valid material types to the domain
# use a for loop to cycle through all the domain codes in the dictionary
for code in domDict:        
    arcpy.AddCodedValueToDomain_management(gdb, domName, code, domDict[code])
    
# Process: Constrain the material value of distribution mains
arcpy.AssignDomainToField_management(inFeatures, inField, domName)

环境

特殊情况

许可信息

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

相关主题