生成近邻表 (Analysis)

许可等级:BasicStandardAdvanced

摘要

在搜索半径范围内,确定输入要素中的每个要素与邻近要素中的一个或多个附近要素之间的距离。结果将记录在输出表中。

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

插图

Generate Near Table illustration

用法

语法

GenerateNearTable_analysis (in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count})
参数说明数据类型
in_features

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

Feature Layer
near_features
[near_features,...]

用于查找与输入要素距离最近的要素的值。可以有一个或多个邻近要素的条目;每个条目可以是点、折线、面或多点类型。当指定邻近要素的多个条目时,会将新字段 NEAR_FC 添加到输入表中,以存储含有最近要素的源要素类的路径。

Feature Layer
out_table

如有必要,输出表将包含邻近要素和 NEAR_FC 的邻近性信息(例如,IN_FID、NEAR_FID 和 NEAR_DIST)和其他属性(例如,位置 (NEAR_X、NEAR_Y) 和角度 (NEAR_ANGLE))。

Table
search_radius
(可选)

指定用于搜索候选邻近要素的半径。将考虑此半径中的邻近要素来计算最近的要素。如果未指定值,即使用默认(空)半径,将在计算中考虑所有的邻近要素。搜索半径的单位默认为输入要素坐标系的单位。可以将单位更改为任何其他单位。但是,这对 NEAR_DIST 单位不会产生任何影响,后者基于输入要素的坐标系单位。

Linear unit
location
(可选)

指定是否将邻近要素最近位置的 x 和 y 坐标分别写入新字段 NEAR_X 和 NEAR_Y。

  • NO_LOCATION指定不写入最近位置的 x 和 y 坐标。这是默认设置。
  • LOCATION指定将最近位置的 x 和 y 坐标写入 NEAR_X 和 NEAR_Y 字段。
Boolean
angle
(可选)

指定是否计算以十进制度为单位的邻近角度值,以及是否将其写入新字段 NEAR_ANGLE。邻近角测量 x 轴(水平轴)与特定方向的直线(该直线连接输入要素与其最近要素的最近位置)之间的夹角,它的范围在 0 到 180 或 0 到 -180 十进制度之间。0 代表东、90 代表北、180 (-180°) 代表西和 -90 代表南。

  • NO_ANGLE指定将不写入邻近角值。这是默认设置。
  • ANGLE指定将邻近角值写入 NEAR_ANGLE 字段。
Boolean
closest
(可选)

确定是只定位并返回最近的要素,还是定位并返回搜索半径内的所有要素。

  • 最近只定位并返回搜索半径内邻近要素中距离输入要素最近的要素。这是默认设置。
  • ALL定位并返回搜索半径内输入要素周围的所有邻近要素。
Boolean
closest_count
(可选)

仅查找指定数量的最近要素。当选中仅查找最近的要素选项时,此参数将不能使用。

Long

代码实例

生成邻近表 (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 脚本)

以下 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

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

环境

相关主题

许可信息

ArcGIS for Desktop Basic:否
ArcGIS for Desktop Standard:否
ArcGIS for Desktop Advanced:是
9/15/2013