生成近邻表 (分析工具)

汇总

计算一个或多个要素类或图层中的要素间距离和其他邻近性信息。 与可修改输入的近邻分析工具不同，生成近邻表可将结果写入新的独立表中，并支持查找多个邻近要素。

了解有关如何使用地理处理工具计算邻近值的详细信息

插图

用法

• 输出表将包含以下字段：

  • IN_FID—输入要素的对象 ID。

  • NEAR_FID—最近要素的对象 ID。

  • NEAR_DIST—输入要素至邻近要素的距离。 该值采用输入要素坐标系的线性单位，或者当方法参数设置为测地线且输入位于地理坐标系中时，采用米作为单位。

  • NEAR_FC—包含邻近要素的要素类的目录路径。 仅在指定了多个邻近要素参数值时，才会将此字段添加到输出表中。

  • NEAR_RANK—将所有邻近要素根据其与单独输入要素的邻近性进行排序的整数值。 最近的要素值为 1，其次近的要素值为 2，以此类推。

  如果选中位置参数，则会将以下字段添加至输出表。 字段值单位取决于方法参数值。 如果方法参数设置为平面，则字段值将使用输入要素坐标系的线性单位。 如果其设置为测地线，则字段值将使用与输入要素坐标系相关联的地理坐标系。

  • FROM_X—输入要素中距离邻近要素最近位置的 x 坐标

  • FROM_Y—输入要素中距离邻近要素最近位置的 y 坐标

  • NEAR_X—邻近要素中距离输入要素最近位置的 x 坐标

  • NEAR_Y—邻近要素中距离输入要素最近位置的 y 坐标

  如果选中角度参数，则会将以下字段添加到输出表中：

  • NEAR_ANGLE—连接输入要素和邻近要素的位于 FROM_X 和 FROM_Y 位置处的线的角度。

• 输入要素和邻近要素相交时，则将以下值写入输出表：

  • NEAR_ANGLE 和 NEAR_DIST 将被设置为 0.0。

  • FROM_X 和 FROM_Y 将与 NEAR_X 和 NEAR_Y 相同，并且将为两个要素相交部分内的位置。

• NEAR_DIST 字段的值将采用输入要素坐标系的线性单位。 如果输入位于地理坐标系中，且方法参数设置为测地线，则 NEAR_DIST 字段将以米为单位。

• 输出表可使用 IN_FID 字段连接回输入要素，或使用 NEAR_FID 字段连接到邻近要素。

• 如果指定了搜索半径参数值且未找到任何邻近要素，则不会输出任何记录。

• 如果未指定搜索半径参数值，则将所有邻近要素均视为候选项。

• 如果未指定搜索半径参数值且未选中仅查找最近的要素参数，并且最接近匹配项的最大数量参数设置为默认值（0 或空），则输出表将包含所有输入要素和所有邻近要素间的距离计算结果。 此过程可能需要花费较长时间并创建出一个大型输出表。 例如，如果有 1,000 个输入要素和 1,000 个邻近要素，输出表将包含一百万条记录。

• 要计算单个要素类或图层内的距离和其它邻近性信息，可以使用相同的要素类或图层。 这种情况下，所评估的输入要素将被排除在邻近要素候选项之外，以避免得出所有要素都与其自身最接近的结果。

• 使用方法参数的平面选项时，将适合距离测量的投影用于输入要素，如等距投影。

  了解有关坐标系和投影的详细信息

• 要可视化 FROM_X、FROM_Y、NEAR_X 和 NEAR_Y 字段值，可将输出表用作创建 XY 事件图层 或 XY 转线 工具的输入。

• You can set a unit of measurement for the NEAR_DIST 字段—如米、千米或英里 - 使用距离单位参数。

参数

• Dialog
• Python

标注	说明	数据类型
输入要素	输入要素类型可以是点、折线、面或多点。	Feature Layer
邻近要素	一个或多个包含邻近要素候选项的要素图层或要素类。 邻近要素可以是点、折线、面或多点。 如果指定了多个图层或要素类，则 NEAR_FC 字段将添加到输入表中，并将存储含有找到的最近要素的源要素类的路径。 同一要素类或图层可同时用作输入要素和邻近要素。	Feature Layer
输出表	包含分析结果的输出表。	Table
搜索半径 （可选）	将用于搜索邻近要素的半径。 如果未指定任何值，则会考虑所有邻近要素。 如果指定了距离，但没有指定任何单位或将单位设置为未知，则将使用输入要素的坐标系单位。 如果针对方法参数使用测地线选项，请使用线性单位，例如千米或英里。	Linear Unit
位置 （可选）	指定是否将输入要素的位置以及邻近要素的最近位置的 x 坐标和 y 坐标写入 FROM_X、FROM_Y、NEAR_X 和 NEAR_Y 字段。 选中—这些位置将被写入到输出表中。 未选中—这些位置将不会被写入到输出表中。 这是默认设置。	Boolean
角 （可选）	指定是否计算近邻角并将其写入输出表的 NEAR_ANGLE 字段。 近邻角测量连接了输入要素与其最近要素的最近位置的直线的方向。 在 method 参数中使用 PLANAR 方法时，角度在 -180° 到 180° 的范围内，0° 代表东，90° 代表北，180°（或 -180°）代表西，-90° 代表南。 当针对 method 参数使用 GEODESIC 方法时，角度在 -180° 到 180° 的范围内，0° 代表北，90° 代表东，180°（或 -180°）代表南，-90° 代表西。 选中—将计算邻近角，还将向输出表添加 NEAR_ANGLE 字段。 未选中—不会计算邻近角，也不会向输出表添加 NEAR_ANGLE 字段。 这是默认设置。	Boolean
仅查找最近的要素 （可选）	指定是否仅将最近的要素写入输出表。 选中—仅将最近的邻近要素写入输出表。 这是默认设置。 未选中—将多个邻近要素写入输出表（可在 closest_count 参数中指定上限）。	Boolean
最接近匹配项的最大数量 （可选）	限制对于每个输入要素报告的邻近要素的数量。 如果已选中仅查找最近的要素参数，则不启用此参数。	Long
方法 （可选）	指定是使用椭球体上的最短路径（测地线）还是使用地平（平面）距离方法。 建议您将测地线方法用于在不适合进行距离测量的坐标系（例如 Web 墨卡托或任何地理坐标系）中存储的数据，以及跨较大地理区域的数据集。 平面—要素之间将使用平面距离。 这是默认设置。 测地线—将在要素之间使用测地线距离。 这种方法考虑到椭球体的曲率，并可以正确处理国际日期变更线和两极附近的数据。	String
距离单位 （可选）	指定 NEAR_DIST 字段的测量单位。 未指定测量单位时，NEAR_DIST 字段的值将采用输入要素坐标系的线性单位。 如果输入位于地理坐标系中并且使用了测地线方法，则 NEAR_DIST 字段的单位将为米。 千米—单位将为千米。 米—单位将为米。 国际海里—单位将为国际海里。 法定英里—单位将为法定英里。 国际码—单位将为国际码。 国际英尺—单位将为国际英尺。 美国测量海里—单位将为美国测量海里。 美国测量英里—单位将为美国测量英里。 美国测量码—单位将为美国测量码。 美国测量英尺—单位将为美国测量英尺。	String
匹配字段 （可选）	输入要素和邻近要素中用于属性匹配的字段对。 仅与输入要素共享匹配字段值的邻近要素才会用于邻近计算。 值表列： Input Fields—Fields from the input features that will be used for attribute matching. Near Fields—Fields from the near features that will be used for attribute matching.	Value Table

环境

当前工作空间, 临时工作空间, 范围

许可信息

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

相关主题

• 邻近分析工具集概述
• 查找地理处理工具