Skip to main content

添加空间连接 (数据管理工具)

汇总

根据空间关系将一个要素的属性连接到另一个要素。 系统将连接目标要素和来自连接要素的被连接属性。

有关详细信息，请参阅按位置选择图形示例。

用法

  • 连接的属性聚合并保存为单独的副本。 对连接数据的任何更新都不会反映出来，因为它们是静态的。 要更新数据，请删除连接并再次运行工具。

  • 此工具可创建以下字段：

    • Join_Count—与每个目标要素匹配的连接要素的数量

    • TARGET_FID—目标要素的对象 ID

  • 此工具不支持一对多连接。 要实现一对多连接，请使用空间连接工具。

  • 默认情况下，连接要素的所有属性均被连接到目标要素的属性。 您可以使用字段映射参数定义将显示在连接输出中的属性。

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

    • 您可以向字段列表中添加和移除字段，重新排序字段列表，并重命名字段。

    • 输出字段的默认数据类型与它遇到的第一个输入字段（具有相同名称的字段）的数据类型相同。 可以将数据类型更改为其他有效的数据类型。

    • 使用操作确定如何将一个或多个输入字段的值合并到单个输出字段中。 可用的操作包括第一个、最后一个、串连、求和、平均值、中位数、众数、最小值、最大值、标准差和计数。

    • 当使用串连操作时，可以指定分隔符，例如逗号或其他字符。 单击分隔符文本框的开始部分以添加分隔符。

    • 单个输入值不支持标准差选项。

    • 使用导出选项 将字段映射另存为 .fieldmap 文件。

    • 使用加载选项 加载 .fieldmap 文件。 文件中指定的要素图层或数据集必须与工具中使用的数据集相匹配。 否则，将重置字段映射参数。

    • 对于文本源字段，使用分割文本按钮 ，可以选择从输入值中提取到输出字段的字符。 要访问分割文本按钮，需将鼠标悬停在输入字段列表中的文本字段上，然后指定起始和结束字符位置。

    • 还可以在 Python 脚本中映射字段。

  • 在字段映射参数中指定的操作仅应用于连接要素中的属性，并且仅当多个要素与目标要素相匹配 (Join_Count > 1) 时应用。 例如，如果连接 DEPTH 属性值分别为 15.5、2.5 和 3.3 的三个要素，并应用平均值操作，则输出字段的值为 6.1。 进行统计计算时，将忽略连接字段中的空值。 例如，15.5、null 值和 2.5 将得出的结果为：“平均值”为 9.0，“计数”为 2。

  • 将匹配选项参数设置为最近或最近测地线时，可能会出现两个或多个连接要素与目标要素距离相等的情况。 如果发生这种情况，系统会随机选择其中一个连接要素作为匹配要素（连接要素的对象 ID 不会影响此随机选择）。 如果要查找排在第 2 位、第 3 位或第 n 位的最近要素，使用生成近邻表工具。

    了解有关如何计算邻近值的详细信息

  • 如果选中永久连接字段参数，则即使未选中保留所有目标要素参数，也将保留目标数据集中的所有记录。

    当使用共享相同名称的连接要素参数值多次运行该工具时，请使用永久连接字段参数。 临时连接需要唯一的表名和字段名，才能正常工作。

  • 如果连接要素与多个目标要素具有空间关系，则在根据目标要素对其进行匹配时进行多次计数。 例如，如果点位于三个面内，则该点将计数三次，即每个面计数一次。

  • 有关使用 3D 相交和在某一 3D 距离范围内空间关系的详细信息，请参阅按 3D 位置关系选择。

参数

标注 说明 数据类型

目标要素

目标要素的属性和连接要素的属性将连接到目标要素图层。 但是，可以在字段映射参数中定义属性的子集。

Feature Layer

连接要素

连接要素的属性将被连接到目标要素的属性中。 有关连接操作的类型对所连接属性聚合的影响的详细信息，请参阅连接操作参数的说明。

Feature Layer

连接操作

（可选）

该参数处于隐藏状态，其不受支持。 所有连接都将作为一对一连接执行。

要在输出要素类中创建输出时实现一对多连接，请使用空间连接工具。

String

保留所有目标要素

（可选）

指定是仅保留与连接要素（称为内部连接）具有空间关系的目标要素，还是保留所有目标要素，即使与连接要素不存在空间关系（称为外部连接）也是如此。

  • 选中—将保留目标要素图层中的所有要素。 这是默认设置。

  • 未选中—仅保留目标要素图层中与连接要素具有空间关系的要素。

Boolean

字段映射

（可选）

将字段及其各自属性和源字段暂时连接到目标数据集。 默认情况下，将包含连接数据集中的所有字段。

使用字段映射来添加、删除、重命名和重新排序字段，以及更改其他字段属性。

字段映射可以用于将两个或多个输入字段的值合并为单个输出字段。

Field Mappings

匹配选项

（可选）

指定用于匹配行的条件。

  • 相交—如果连接要素与目标要素相交，将匹配连接要素中相交的要素。 这是默认设置。 在搜索半径参数中指定距离。

  • 3D 相交—如果连接要素中的要素与三维空间（x、y 和 z）中的某一目标要素相交，则将匹配这些要素。 在搜索半径参数中指定距离。

  • 在某一距离范围内—如果连接要素在目标要素的指定距离之内，将匹配处于该距离内的要素。 在搜索半径参数中指定距离。

  • 在某一测地线距离范围内—与在某一距离范围内相同，不同之处在于采用测地线距离而非平面距离。 将使用测地线公式计算要素间的距离，这种方法考虑到椭球体的曲率，并可以正确处理跨越日期变更线和两极及其附近的数据。 如果您的数据涵盖较大地理范围或输入的坐标系不适合进行距离计算，请使用此选项。

  • 在某一 3D 距离范围内—在三维空间内，如果连接要素中的要素与目标要素间的距离在指定范围内，则匹配这些要素。 在搜索半径参数中指定距离。

  • 包含—如果目标要素中包含连接要素中的要素，将匹配连接要素中被包含的要素。 目标要素必须是面或折线。 对于此选项，目标要素不能为点，且仅当目标要素为面时连接要素才能为面。

  • 完全包含—如果目标要素完全包含连接要素中的要素，将匹配连接要素中被包含的要素。 面可以完全包含任意要素。 点不能完全包含任何要素，甚至不能包含点。 折线只能完全包含折线和点要素。

  • 包含 (Clementini)—该空间关系产生的结果与完全包含相同，但有一种情况例外：如果连接要素完全位于目标要素的边界上（没有任何一部分完全位于内部或外部），则不会匹配要素。 Clementini 将边界面定义为用来分隔内部和外部的线，将线的边界定义为其端点，点的边界始终为空。

  • 位于—如果目标要素位于连接要素内，将匹配连接要素中包含目标要素的要素。 这与包含相反。 对于此选项，只有当连接要素也为面时目标要素才可为面。 仅当目标为点时，点才可以作为连接要素。

  • 完全在其他要素范围内—如果目标要素完全在连接要素范围内，则匹配连接要素中完全包含目标要素的要素。 这与完全包含相反。

  • 位于 (Clementini)—结果与位于相同，但下述情况例外：如果连接要素中的整个要素均位于目标要素的边界上，则不会匹配要素。 Clementini 将边界面定义为用来分隔内部和外部的线，将线的边界定义为其端点，点的边界始终为空。

  • 与其他要素相同—如果连接要素与目标要素相同，将匹配连接要素中相同的要素。 连接要素和目标要素必须具有相同的形状类型 - 点到点、线到线或者面到面。

  • 边界接触—如果连接要素中具有边界与目标要素相接的要素，将匹配这些要素。 如果目标和连接要素为线或面，则连接要素的边界只可接触目标要素的边界，且连接要素的任何部分均不可跨越目标要素的边界。

  • 与其他要素共线—如果连接要素中具有与目标要素共线的要素，将匹配这些要素。 连接要素和目标要素必须是线或面。

  • 与轮廓交叉—如果连接要素中具有轮廓与目标要素交叉的要素，则将匹配这些要素。 连接要素和目标要素必须是线或面。 如果将面用于连接或目标要素，则会使用面的边界（线）。 将匹配在某一点交叉的线，而不会匹配共线的线。

  • 中心在要素范围内—如果目标要素的中心位于连接要素内，将匹配这些要素。 要素中心的计算方式如下：对于面和多点，将使用几何的质心；对于线输入，则会使用几何的中点。 在搜索半径参数中指定距离。

  • 最近—将匹配连接要素中与目标要素最近的要素。 有关详细信息，请参阅使用提示。 在搜索半径参数中指定距离。

  • 最近测地线—与最近相同，不同之处在于采用测地线距离而非平面距离。 如果您的数据涵盖较大地理范围或输入的坐标系不适合进行距离计算，请使用此选项

  • 最大重叠—连接要素中的要素将与具有最大重叠的目标要素进行匹配。

String

搜索半径

（可选）

如果连接要素与目标要素的距离在此范围内，则有可能进行空间连接。 仅当指定空间关系时，搜索半径才有效（匹配选项参数设置为相交、在某一距离范围内、在某一测地线距离范围内、中心在要素范围内、最近或最近测地线）。 例如，当搜索半径设置为 100 米且使用在某一距离范围内空间关系时，将会连接距离目标要素 100 米以内的要素。 对于在某一距离范围内的三种关系而言，如果未指定搜索半径的值，则将使用距离 0。

Linear Unit

距离字段名称

（可选）

包含目标要素与最近连接要素间距的字段的名称。 该字段将被添加到连接中。 仅当指定空间关系（匹配选项设置为最近或最近测地线）时，此参数才有效。 如果搜索半径中没有匹配的要素，则此字段的值为 -1。 如果未提供字段名称，则不会将该字段添加到连接中。

String

永久连接字段

（可选）

指定连接要素类中的字段是临时添加到图层中，还是永久添加到目标要素类中。

  • 选中—连接要素类的字段将永久添加到目标要素类中。

  • 未选中—连接要素类的字段将通过内部连接暂时添加到图层。 这是默认设置。

Boolean

匹配字段

（可选）

连接要素和目标要素之间的字段对将用于属性匹配。 仅与目标要素具有匹配字段值的连接要素记录才会参与空间连接。

值表列：

  • Join Fields—Fields from the join features that will be used for attribute matching.

  • Target Fields—Fields from the target features that will be used for attribute matching.

Value Table

派生输出

标注 说明 数据类型

更新的目标要素

已更新的输入数据集。

Feature Layer

环境

默认输出 Z 值, M 分辨率, M 容差, 输出配置关键字, 输出 M 值域, 输出 XY 值域, 输出 Z 值域, 输出坐标系, 范围, 输出包含 M 值, 输出包含 Z 值, XY 分辨率, XY 容差, Z 分辨率, Z 容差

许可信息

  • 基本: 是
  • 标准: 是
  • 高级: 是