构造视线 (3D Analyst)

描述

创建表示视线（从一个或多个视点到目标要素类的要素）的线要素。

插图

使用方法

• 视线基于采样距离参数中指定的值，从目标线和面的周长采样。应按输出要素类的 x,y 单位给出采样距离单位。

• 使用连接字段为给定观察点指定一个或多个目标。如果未使用连接字段，则将所有点连接到所有目标。

• 如果为观察点和目标要素指定了高度源，将生成三维输出。观察点和目标要素的高度源默认为以下列表中遇到的第一个字段名称：

  1. Shape.Z（只对启用 Z 值的要素可用）
  2. Spot
  3. Z
  4. Z_Value
  5. Height
  6. Elev
  7. Elevation
  8. Contour

  如果不存在适合的高度字段，则使用 <无> 关键字来指示要素不含 Z 值。

• 如果所需高度字段在默认字段选择中没有更高优先级，将需要显式指定所需字段。同样，如果某个高度字段不是所需字段但要素类包含默认选择列表中的字段之一，则需要指定 <无> 关键字。

• 以下字段将会添加到包含视线的输出要素类：

  • OID_OBSERV - 观察点的 OID
  • OID_TARGET - 目标要素的 OID
  • DIST_ALONG - 当目标要素为线或面时沿此目标要素的距离

• 启用输出方向参数时，输出视线将含有两个附加属性字段：

  • AZIMUTH - 偏离正北的角度，值以顺时针方向增加
  • VERT_ANGLE - 与地平线的垂直角，90° 是指正上方，而 -90° 是指正下方。仅当指定高度字段时，垂直角才会相关。

语法

arcpy.3d.ConstructSightLines(in_observer_points, in_target_features, out_line_feature_class, {observer_height_field}, {target_height_field}, {join_field}, {sample_distance}, {output_the_direction}, {sampling_method})

参数	说明	数据类型
in_observer_points	表示观察点的单点要素。不支持多点要素。	Feature Layer
in_target_features	目标要素（点、多点、线和面）。	Feature Layer
out_line_feature_class	包含视线的输出要素类。	Feature Class
observer_height_field （可选）	从观察点属性表获得的观察点高度值的源。 从按优先级顺序列出的以下选项中选择默认的观察者高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级，将需要指定所需字段。 <None> —不会将 Z 值分配至生成的视线要素。 Shape.Z Spot Z Z_Value Height Elev Elevation Contour	String
target_height_field （可选）	目标的高度字段。 从按优先级顺序列出的以下选项中选择默认的目标高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级，将需要指定所需字段。 <None> —不会将 Z 值分配至生成的视线要素。 Shape.Z Spot Z Z_Value Height Elev Elevation Contour	String
join_field （可选）	使用连接字段将观察者与特定目标相匹配。 <None> —不会将 Z 值分配至生成的视线要素。	String
sample_distance （可选）	目标为线或面要素类时采样之间的距离。按输出要素类的 XY 单位解释采样距离单位。	Double
output_the_direction （可选）	向输出视线添加方向属性。将添加并填充两个附加字段以指示方向：AZIMUTH 和 VERT_ANGLE（垂直角）。 NOT_OUTPUT_THE_DIRECTION — 不会向输出视线添加方向属性。这是默认设置。 OUTPUT_THE_DIRECTION — 将添加并填充两个附加字段以指示方向：AZIMUTH 和 VERT_ANGLE（垂直角）。	Boolean
sampling_method （可选）	指定将如何使用采样距离沿目标要素创建视线。 2D_DISTANCE —将在二维笛卡尔空间中评估距离。这是默认设置。 3D_DISTANCE —将以三维长度评估距离。	String

代码示例

ConstructSightLines 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具。

arcpy.env.workspace = 'C:/data'
arcpy.ConstructSightLines_3d('observer_pt.shp', 'target.shp', 'sightlines.shp', 'BASEHEIGHT', 'TOP_HEIGHT', 'NAME', "1", "OUTPUT_THE_DIRECTION")

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

# Set Local Variables:
arcpy.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.ddd.ConstructSightLines(obs, tar, sightlines, height, height,
                              join_field, sampling, direction)
arcpy.ddd.LineOfSight(surface, sightlines, "Parade_LOS.shp",
                      "Obstructions.shp", in_features=bldgs)

环境

当前工作空间, 范围, 输出坐标系, 地理变换, XY 分辨率, XY 容差, 输出 XY 值域, Z 分辨率, Z 容差, 输出 Z 值域, 输出配置关键字, 自动提交

许可信息

• Basic: 需要 3D Analyst
• Standard: 需要 3D Analyst
• Advanced: 需要 3D Analyst