描述
创建表示视线(从一个或多个视点到目标要素类的要素)的线要素。
插图
使用
视线基于采样距离参数中指定的值,从目标线和面的周长采样。应按输出要素类的 x,y 单位给出采样距离单位。
使用连接字段为给定观察点指定一个或多个目标。如果未使用连接字段,则将所有点连接到所有目标。
如果为观察点和目标要素指定了高度源,将生成三维输出。观察点和目标要素的高度源默认为以下列表中遇到的第一个字段名称:
- Shape.Z(只对启用 Z 值的要素可用)
- Spot
- Z
- Z_Value
- Height
- Elev
- Elevation
- Contour
如果不存在适合的高度字段,则使用 <无> 关键字来指示要素不含 Z 值。
如果所需高度字段在默认字段选择中没有更高优先级,将需要显式指定所需字段。同样,如果某个高度字段不是所需字段但要素类包含默认选择列表中的字段之一,则需要指定 <无> 关键字。
以下字段将会添加到包含视线的输出要素类:
- OID_OBSERV - 观察点的 OID
- OID_TARGET - 目标要素的 OID
- DIST_ALONG - 当目标要素为线或面时沿此目标要素的距离
启用输出方向参数时,输出视线将含有两个附加属性字段:
- AZIMUTH - 偏离正北的角度,值以顺时针方向增加
- VERT_ANGLE - 与地平线的垂直角,90° 是指正上方,而 -90° 是指正下方。仅当指定高度字段时,垂直角才会相关。
语法
ConstructSightLines(in_observer_points, in_target_features, out_line_feature_class, {observer_height_field}, {target_height_field}, {join_field}, {sample_distance}, {output_the_direction})
参数 | 说明 | 数据类型 |
in_observer_points | 表示观察点的单点要素。不支持多点要素。 | Feature Layer |
in_target_features | 目标要素(点、多点、线和面)。 | Feature Layer |
out_line_feature_class | 包含视线的输出要素类。 | Feature Class |
observer_height_field (可选) | 从观察点属性表获得的观察点高度值的源。 从按优先级顺序列出的以下选项中选择默认的观察者高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级,将需要指定所需字段。
| String |
target_height_field (可选) | 目标的高度字段。 从按优先级顺序列出的以下选项中选择默认的目标高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级,将需要指定所需字段。
| String |
join_field (可选) | 使用连接字段将观察者与特定目标相匹配。
| String |
sample_distance (可选) | 目标为线或面要素类时采样之间的距离。按输出要素类的 XY 单位解释采样距离单位。 | Double |
output_the_direction (可选) | 向输出视线添加方向属性。将添加并填充两个附加字段以指示方向:AZIMUTH 和 VERT_ANGLE(垂直角)。
| Boolean |
代码示例
ConstructSightLines 示例 1(Python 窗口)
下面的示例演示了如何在 Python 窗口中使用此工具。
arcpy.CheckOutExtension('3D')
arcpy.env.workspace = 'C:/data'
arcpy.ConstructSightLines_3d('observer_pt.shp', 'target.shp', 'sightlines.shp',
'BASEHEIGHT', 'TOP_HEIGHT', 'NAME', 1)
ConstructSightLines 示例 2(独立脚本)
下面的示例演示了如何在独立 Python 脚本中使用此工具。
'''*********************************************************************
Name: Sight Line Visibility of Parade Path
Description: This script demonstrates how to create a sight line feature class
from a pair of observer and target points.
*********************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env
try:
# Checking out 3D Analyst Extension:
arcpy.CheckOutExtension('3D')
# Set Local Variables:
env.workspace = 'C:/data'
# Setting up input and output variables:
obs = "observer_pts.shp"
tar = "parade_path.shp"
sightlines = "output_sightlines.shp"
height = "<None>"
join_field = "#"
sampling = 0.5
direction = "OUTPUT_THE_DIRECTION"
surface = 'elevation.tif'
bldgs = 'buildings.shp'
arcpy.AddMessage("Building sightlines...")
arcpy.ddd.ConstructSightLines(obs, tar, sightlines, height, height,
join_field, sampling, direction)
arcpy.ddd.LineOfSight(surface, sightlines, "Parade_LOS.shp",
"Obstructions.shp", in_features=bldgs)
arcpy.GetMessages(0)
arcpy.CheckInExtension("3D")
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)
环境
许可信息
- Basic: 需要 3D Analyst
- Standard: 需要 3D Analyst
- Advanced: 需要 3D Analyst