构造视线 (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° 是指正下方。 仅当指定高度字段时,垂直角才会相关。

参数

标注说明数据类型
视点分析

表示观察点的单点要素。 不支持多点要素。

Feature Layer
目标要素

目标要素(点、多点、线和面)。

Feature Layer
输出

包含视线的输出要素类。

Feature Class
观察者高度字段
(可选)

从观察点属性表获得的观察点高度值的源。

从按优先级顺序列出的以下选项中选择默认的观察者高度字段字段。 如果存在多个字段并且所需字段在默认字段选择上没有更高优先级,将需要指定所需字段。

  • 无高度源不会将 Z 值分配至生成的视线要素。
String
目标高度字段
(可选)

目标的高度字段。

从按优先级顺序列出的以下选项中选择默认的目标高度字段字段。 如果存在多个字段并且所需字段在默认字段选择上没有更高优先级,将需要指定所需字段。

  • 无高度源不会将 Z 值分配至生成的视线要素。
String
连接字段
(可选)

使用连接字段将观察者与特定目标相匹配。

  • 无连接字段不会将 Z 值分配至生成的视线要素。
String
采样距离
(可选)

目标为线或面要素类时采样之间的距离。 按输出要素类的 XY 单位解释采样距离单位。

Double
输出方向
(可选)

指定是否向输出视线添加方向属性。 - 将添加并填充两个附加字段以指示方向:AZIMUTHVERT_ANGLE(垂直角)。

  • 未选中 - 不会向输出视线添加方向属性。 这是默认设置。
  • 选中 - 将添加并填充两个附加字段以指示方向:方位角和垂直角。
Boolean
采样方法
(可选)

指定将如何使用采样距离沿目标要素创建视线。

  • 2D 距离将在二维笛卡尔空间中评估距离。 这是默认设置。
  • 3D 距离将以三维长度评估距离。
String

arcpy.ddd.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 值分配至生成的视线要素。
  1. Shape.Z
  2. Spot
  3. Z
  4. Z_Value
  5. Height
  6. Elev
  7. Elevation
  8. Contour
String
target_height_field
(可选)

目标的高度字段。

从按优先级顺序列出的以下选项中选择默认的目标高度字段字段。 如果存在多个字段并且所需字段在默认字段选择上没有更高优先级,将需要指定所需字段。

  • <None>不会将 Z 值分配至生成的视线要素。
  1. Shape.Z
  2. Spot
  3. Z
  4. Z_Value
  5. Height
  6. Elev
  7. Elevation
  8. Contour
String
join_field
(可选)

使用连接字段将观察者与特定目标相匹配。

  • <None>不会将 Z 值分配至生成的视线要素。
String
sample_distance
(可选)

目标为线或面要素类时采样之间的距离。 按输出要素类的 XY 单位解释采样距离单位。

Double
output_the_direction
(可选)

指定是否向输出视线添加方向属性。 - 将添加并填充两个附加字段以指示方向:AZIMUTHVERT_ANGLE(垂直角)。

  • NOT_OUTPUT_THE_DIRECTION不会向输出视线添加方向属性。 这是默认设置。
  • OUTPUT_THE_DIRECTION- 将添加并填充两个附加字段以指示方向:AZIMUTHVERT_ANGLE(垂直角)。
Boolean
sampling_method
(可选)

指定将如何使用采样距离沿目标要素创建视线。

  • 2D_DISTANCE将在二维笛卡尔空间中评估距离。 这是默认设置。
  • 3D_DISTANCE将以三维长度评估距离。
String

代码示例

ConstructSightLines 示例 1(Python 窗口)

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.ConstructSightLines('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)