构造视线 (3D Analyst 工具)

汇总

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

插图

构造视线

用法

视线基于采样距离参数中指定的值，从目标线和面的周长采样。应按输出要素类的 x,y 单位给出采样距离单位。
使用连接字段为给定观察点指定一个或多个目标。如果未使用连接字段，则将所有点连接到所有目标。
如果为观察点和目标要素指定了高度源，将生成三维输出。观察点和目标要素的高度源默认为以下列表中遇到的第一个字段名称：
1. Shape.Z（仅适用于启用 z 值的要素）
2. Spot
3. Z
4. Z_Value
5. Height
6. Elev
7. Elevation
8. Contour
如果不存在适合的高度字段，则使用 <None> 关键字来指示要素不含 Z 值。
如果所需高度字段在默认字段选择中没有更高优先级，将需要显式指定所需字段。同样，如果某个高度字段不是所需字段但要素类包含默认选择列表中的字段之一，则需要指定 <None> 关键字。
以下字段将会添加到包含视线的输出要素类：
- OID_OBSERV—观察点的 OID
- OID_TARGET—目标要素的 OID
- DIST_ALONG—当目标要素为线或面时沿此目标要素的距离
启用输出方向参数时，输出视线将含有两个附加属性字段：
- AZIMUTH—偏离正北的角度，值以顺时针方向增加
- VERT_ANGLE—与地平线的垂直角（以度为单位），90° 是指正上方，而 -90° 是指正下方。仅当指定高度字段时，垂直角才会相关。

标注	说明	数据类型
视点	表示观察点的单点要素。不支持多点要素。	Feature Layer
目标要素	目标要素（点、多点、线和面）。	Feature Layer
输出	包含视线的输出要素类。	Feature Class
观察者高度字段（可选）	从观察点属性表获得的观察点高度值的源。从按优先级顺序列出的以下选项中选择默认的观察者高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级，将需要指定所需字段。 No Height Source—No Z values will be assigned to the resulting sight line features.	String
目标高度字段（可选）	目标的高度字段。从按优先级顺序列出的以下选项中选择默认的目标高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级，将需要指定所需字段。 No Height Source—No Z values will be assigned to the resulting sight line features.	String
连接字段（可选）	使用连接字段将观察者与特定目标相匹配。 No Join Field—No Z values will be assigned to the resulting sight line features.	String
采样距离（可选）	目标为线或面要素类时采样之间的距离。按输出要素类的 XY 单位解释采样距离单位。	Double
输出方向（可选）	指定是否向输出视线添加方向属性。 - 将添加并填充两个附加字段以指示方向：`AZIMUTH` 和 `VERT_ANGLE`（垂直角）。选中—Two additional fields will be added and populated to indicate direction: `AZIMUTH` and `VERT_ANGLE` (vertical angle). 未选中—No direction attributes will be added to the output sight lines. This is the default.	Boolean
采样方法（可选）	指定将如何使用采样距离沿目标要素创建视线。 2D distance—The distance will be evaluated in two-dimensional Cartesian space. This is the default. 3D distance—The distance will be evaluated in three-dimensional length.	String

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 （可选）	从观察点属性表获得的观察点高度值的源。从按优先级顺序列出的以下选项中选择默认的观察者高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级，将需要指定所需字段。 `Shape.Z` `Spot` `Z` `Z_Value` `Height` `Elev` `Elevation` `Contour` `<None>`—No Z values will be assigned to the resulting sight line features.	String
target_height_field （可选）	目标的高度字段。从按优先级顺序列出的以下选项中选择默认的目标高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级，将需要指定所需字段。 `Shape.Z` `Spot` `Z` `Z_Value` `Height` `Elev` `Elevation` `Contour` `<None>`—No Z values will be assigned to the resulting sight line features.	String
join_field （可选）	使用连接字段将观察者与特定目标相匹配。 `<None>`—No Z values will be assigned to the resulting sight line features.	String
sample_distance （可选）	目标为线或面要素类时采样之间的距离。按输出要素类的 XY 单位解释采样距离单位。	Double
output_the_direction （可选）	指定是否向输出视线添加方向属性。 - 将添加并填充两个附加字段以指示方向：`AZIMUTH` 和 `VERT_ANGLE`（垂直角）。 `OUTPUT_THE_DIRECTION`—Two additional fields will be added and populated to indicate direction: `AZIMUTH` and `VERT_ANGLE` (vertical angle). `NOT_OUTPUT_THE_DIRECTION`—No direction attributes will be added to the output sight lines. This is the default.	Boolean
sampling_method （可选）	指定将如何使用采样距离沿目标要素创建视线。 `2D_DISTANCE`—The distance will be evaluated in two-dimensional Cartesian space. This is the default. `3D_DISTANCE`—The distance will be evaluated in three-dimensional length.	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)

环境

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

许可信息

基本: 需要 3D Analyst
标准: 需要 3D Analyst
高级: 需要 3D Analyst

构造视线 (3D Analyst 工具)

汇总

插图

用法

参数

环境

许可信息

相关主题