ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • 帮助
  • Sign Out
ArcGIS Desktop

ArcGIS Online

专为贵组织打造的制图平台

ArcGIS Desktop

全面的专业性 GIS

ArcGIS Enterprise

面向企业的 GIS

ArcGIS Developers

用于构建位置感知应用程序的工具

ArcGIS Solutions

适用于行业的免费模板地图和应用程序

ArcGIS Marketplace

获取适用于组织的应用程序和数据

  • 文档
  • 支持
Esri
  • 登录
user
  • 我的个人资料
  • 登出

ArcMap

  • 主页
  • 入门
  • 地图
  • 分析
  • 管理数据
  • 工具
  • 扩展模块

生成近邻表

  • 描述
  • 插图
  • 使用方法
  • 语法
  • 代码示例
  • 环境
  • 许可信息

描述

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

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

插图

生成近邻表工具图示

使用方法

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

    • IN_FID- 输入要素的 ObjectID。
    • NEAR_FID- 最邻近要素的 ObjectID。
    • NEAR_DIST- 输入要素至邻近要素的距离。 该字段值的距离单位采用输入要素坐标系的线性单位,当方法参数设置为测地线且输入采用地理坐标系时,该字段值的距离单位为米。
    • NEAR_FC- 包含邻近要素的要素类的目录路径。 仅在指定了多个邻近要素值时,才会将此字段添加到输出表中。
    • NEAR_RANK- 将所有邻近要素根据其与单独输入要素的邻近性进行排序的整数值。 最近的要素值为 1,其次近的要素值为 2,以此类推。

    如果选中位置参数(在 Python 中 location 参数设置为 LOCATION),则以下字段将被添加到输出表中。 字段值的单位取决于用于方法参数的方法。 如果使用平面,则值单位为输入要素坐标系的线性单位。 如果使用测地线,则值单位为与输入要素坐标系相关联的地理坐标系。

    • FROM_X- 输入要素中距离邻近要素最近位置的 x 坐标
    • FROM_Y- 输入要素中距离邻近要素最近位置的 y 坐标
    • NEAR_X- 邻近要素中距离输入要素最近位置的 x 坐标
    • NEAR_Y- 邻近要素中距离输入要素最近位置的 y 坐标

    如果选中角度参数(在 Python 中将 angle 参数设置为 ANGLE),则会将以下字段添加到输出表中。

    • 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 个邻近要素,输出表将包含 1,000,000 条记录。

  • 同一要素类或图层可同时用作输入要素和邻近要素。 这种情况下,所评估的输入要素将被排除在邻近要素候选项之外,以避免得出所有要素都与其自身最接近的结果。

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

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

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

语法

arcpy.analysis.GenerateNearTable(in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count}, {method})
参数说明数据类型
in_features

输入要素可以是点、折线、面或多点类型。

Feature Layer
near_features
[near_features,...]

一个或多个包含邻近要素候选项的要素类的图层。 邻近要素可以是点、折线、面或多点。 如果指定了多个图层或要素类,则 NEAR_FC 字段将被添加到输入表中,并将存储含有找到的最近要素的源要素类的路径。 同一要素类或图层可同时用作输入要素和邻近要素。

Feature Layer
out_table

包含分析结果的输出表。

Table
search_radius
(可选)

将用于搜索邻近要素的半径。 如果未指定任何值,则所有邻近要素都将是候选项。 如果输入了距离,但单位留空或设为未知,则将使用输入要素的坐标系的单位。 如果 method 参数使用了 GEODESIC 选项,则使用线性单位(如公里或英里)。

Linear Unit
location
(可选)

指定是否将输入要素的位置以及邻近要素的最近位置的 x 坐标和 y 坐标写入 FROM_X、FROM_Y、NEAR_X 和 NEAR_Y 字段。

  • NO_LOCATION —这些位置将不会被写入到输出表中。 这是默认设置。
  • LOCATION —这些位置将被写入到输出表中。
Boolean
angle
(可选)

指定是否计算邻近角并将其写入输出表的 NEAR_ANGLE 字段。 邻近角测量与直线(该直线连接输入要素与其最近要素的最近位置)方向之间的夹角。 当 method 参数使用 PLANAR 方法时,角度在 -180° 到 180° 的范围内,0° 代表东,90° 代表北,180°(或 -180°)代表西,-90° 代表南。 当 method 参数使用 GEODESIC 方法时,角度在 -180° 到 180° 的范围内,0° 代表北,90° 代表东,180°(或 -180°)代表南,-90° 代表西。

  • NO_ANGLE —NEAR_ANGLE 字段不会添加到输出表。 这是默认设置。
  • ANGLE —NEAR_ANGLE 字段将添加到输出表。
Boolean
closest
(可选)

指定是否仅将最近的要素写入输出表。

  • CLOSEST —仅将最近的邻近要素写入输出表。 这是默认设置。
  • ALL —多个邻近要素将被写入输出表(可在 closest_count 参数中指定上限)。
Boolean
closest_count
(可选)

限制对于每个输入要素报告的邻近要素的数量。 如果 closest 参数设置为 CLOSEST,则忽略此参数。

Long
method
(可选)

指定是使用椭球体上的最短路径(测地线)还是使用地平(平面)距离方法。 建议将 GEODESIC 方法用于在不适合进行距离测量的坐标系(例如 Web 墨卡托及任何地理坐标系)中存储的数据,以及地理区域跨度较大的数据集。

  • PLANAR —要素之间将使用平面距离。 这是默认设置。
  • GEODESIC —将在要素之间使用测地线距离。 这种方法考虑到椭球体的曲率,并可以正确处理国际日期变更线和极点附近的数据。
String

代码示例

GenerateNearTable 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何使用 GenerateNearTable 函数。

import arcpy

arcpy.env.workspace = "C:/data/input/gnt.gdb"

arcpy.GenerateNearTable_analysis("campsites", ["parks", "trails"], "better_sites")
GenerateNearTable 示例 2(独立脚本)

以下 Python 脚本演示了如何在独立脚本中使用 GenerateNearTable 函数。

# Name: GenerateNearTable.py
# Description: Finds 3 nearest in the near feature class from the input feature class.


# import system modules
import arcpy

# set workspace environment
arcpy.env.workspace = "C:/data/input/gnt.gdb"

# set required parameters 
in_features = "campsites"
near_features = ["parks", "trails"]
out_table = "near_parks_trails"

# optional parameters
search_radius = '1500 Meters'
location = 'NO_LOCATION'
angle = 'NO_ANGLE'
closest = 'ALL'
closest_count = 3

# find crime locations within the search radius
arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius, 
                                 location, angle, closest, closest_count)

环境

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

许可信息

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

相关主题

  • 邻近分析工具集概览

ArcGIS Desktop

  • 主页
  • 文档
  • 支持

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

关于 Esri

  • 关于我们
  • 招贤纳士
  • Esri 博客
  • 用户大会
  • 开发者峰会
Esri
分享您的想法。
Copyright © 2021 Esri. | 隐私政策 | 法律声明