生成空间连接属性规则 (数据管理)

摘要

根据从一个或多个要素类查询的字段值生成具有输入属性规则的 .csv 文件。

使用情况

• 使用字段映射参数管理输出数据集中的字段及其内容。

  • 您可以向字段列表中添加和移除字段，重新排序字段列表，并重命名字段。
  • 输出字段的默认数据类型与它遇到的第一个输入字段（具有相同名称的字段）的数据类型相同。 可以将数据类型更改为其他有效的数据类型。
  • 使用操作确定如何将一个或多个输入字段的值合并到单个输出字段中。 可用的操作包括第一个、最后一个、串连、求和、平均值、中位数、众数、最小值、最大值、标准差和计数。
  • 当使用串连操作时，可以指定分隔符，例如逗号或其他字符。 单击分隔符文本框的开始部分以添加分隔符。
  • 单个输入值不支持标准差选项。
  • 使用导出选项 将字段映射另存为 .fieldmap 文件。
  • 使用加载选项 加载 .fieldmap 文件。 文件中指定的要素图层或数据集必须与工具中使用的数据集相匹配。 否则，将重置字段映射参数。
  • 对于文本源字段，使用分割文本按钮 ，可以选择从输入值中提取到输出字段的字符。 要访问分割文本按钮，需将鼠标悬停在输入字段列表中的文本字段上，然后指定起始和结束字符位置。
  • 还可以在 Python 脚本中映射字段。

参数

对话框

标注	说明	数据类型
输入表	将创建属性规则的要素类。	Feature Layer
输出文件夹	用于保存输出 .csv 文件的文件夹。 文件的名称将使用输入表参数值的名称。	Folder
连接类	连接要素的属性将与输入要素的属性相连接。	Feature Layer
字段映射	控制字段从连接类参数值到输入表参数值的传输或映射。	Field Mappings
表达式 (可选)	用于限制参与属性规则的输入要素的 SQL 表达式。	SQL Expression
搜索选项 (可选)	定义输入表和连接类参数值中的要素之间的空间查询。 可以配置几何类型、空间运算符和空间距离来定义每个连接类和输入表之间的匹配。 连接类 - 将运行空间查询的连接类的名称。 输入几何类型 - 用于查询连接类的输入几何部分。 空间运算符 - 将在查询中使用的空间运算。 搜索距离 - 将包含在查询中的几何的距离。 可用的输入几何运算符如下： 几何 - 输入要素的完整几何。 这是默认设置。 起点 - 折线要素内的第一个顶点。 此选项仅支持折线要素。 终点 - 折线要素内的最后一个折点。 此选项仅支持折线要素。 质心 - 输入要素的几何中心。 可用的空间运算符如下： 相交 - 如果连接类中的要素与输入要素相交，则匹配。 这是默认设置。 交叉 - 如果连接类中的要素与输入要素交叉，则匹配。 包含 - 如果输入要素包含连接类中的要素，则匹配。 这与范围内选项相反。 Envelope_Intersects - 如果连接类中要素的边界框（包络）与输入要素的边界框相交，则匹配。 重叠 - 如果连接类中的要素与输入要素重叠，则匹配。 连接类要素不完全包含在输入要素中。 接触 - 如果连接类中的要素具有与输入要素接触的边界，则匹配。 如果输入和连接要素为折线或面，则连接要素的边界只可接触输入要素的边界，且连接要素的任何部分均不可跨越输入要素的边界。 范围内 - 如果输入要素在连接类中要素的范围内，则匹配。 这与包含选项相反。	Value Table

派生输出

标注	说明	数据类型
输出规则 CSV 文件	输出 .csv 文件的文件夹位置和名称。	File

Python

arcpy.management.GenerateSpatialJoinAttributeRule(in_table, out_folder, join_classes, field_map, {where_clause}, {search_options})

名称	说明	数据类型
in_table	将创建属性规则的要素类。	Feature Layer
out_folder	用于保存输出 .csv 文件的文件夹。 文件的名称将使用 in_table 参数值的名称。	Folder
join_classes [join_classes,...]	连接要素的属性将与输入要素的属性相连接。	Feature Layer
field_map	控制字段从 join_classes 参数值到 in_table 参数值的传输或映射。	Field Mappings
where_clause (可选)	用于限制参与属性规则的输入要素的 SQL 表达式。	SQL Expression
search_options [search_options,...] (可选)	定义 in_table 和 join_classes 参数值中的要素之间的空间查询。 可以配置几何类型、空间运算符和空间距离来定义每个连接类和输入表之间的匹配。 连接类 - 将运行空间查询的连接类的名称。 输入几何类型 - 用于查询连接类的输入几何部分。 空间运算符 - 将在查询中使用的空间运算。 搜索距离 - 将包含在查询中的几何的距离。 可用的输入几何运算符如下： GEOMETRY - 输入要素的完整几何。 这是默认设置。 START - 折线要素内的第一个顶点。 此选项仅支持折线要素。 END - 折线要素内的最后一个折点。 此选项仅支持折线要素。 CENTROID - 输入要素的几何中心。 可用的空间运算符如下： INTERSECTS - 如果连接类中的要素与输入要素相交，则匹配。 这是默认设置。 CROSSES - 如果连接类中的要素与输入要素交叉，则匹配。 CONTAINS - 如果输入要素包含连接类中的要素，则匹配。 这与 WITHIN 选项相反。 ENVELOPE_INTERSECTS - 如果连接类中要素的边界框（包络）与输入要素的边界框相交，则匹配。 OVERLAPS - 如果连接类中的要素与输入要素重叠，则匹配。 连接类要素不完全包含在输入要素中。 TOUCHES - 如果连接类中的要素具有与输入要素接触的边界，则匹配。 如果输入和连接要素为折线或面，则连接要素的边界只可接触输入要素的边界，且连接要素的任何部分均不可跨越输入要素的边界。 WITHIN - 如果输入要素在连接类中要素的范围内，则匹配。 这与 CONTAINS 选项相反。	Value Table

派生输出

名称	说明	数据类型
out_rule_csv	输出 .csv 文件的文件夹位置和名称。	File

代码示例

GenerateSpatialJoinAttributeRule 示例（Python 窗口）

以下示例演示了在两个类之间使用 GenerateSpatialJoinAttributeRule 函数。

import arcpy
arcpy.management.GenerateSpatialJoinAttributeRule( 
    in_table=r"C:\temp\test.gdb\in_featureclass", 
    out_folder=r"C:\temp", 
    join_classes=["layer_one", "layer_two"], 
    where_clause="select * from X" 
)

环境

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