构造视线 (3D Analyst)

摘要

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

用法

语法

ConstructSightLines_3d (in_observer_points, in_target_features, out_line_feature_class, {observer_height_field}, {target_height_field}, {join_field}, {sample_distance})
参数说明数据类型
in_observer_points

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

Feature Layer
in_target_features

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

Feature Layer
out_line_feature_class

包含视线的输出要素类。

Feature Class
observer_height_field
(可选)

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

从按优先级顺序列出的以下选项中选择默认的观察者高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级,将需要指定所需字段。如果不存在适合的高度字段,将使用 <无> 关键字。同样,如果某个高度字段不是所需字段但要素类具有下列字段中的一个,则需要指定 <无> 关键字。

  1. Shape.Z
  2. Spot
  3. Z
  4. Z_Value
  5. Height
  6. Elev
  7. Elevation
  8. Contour
String
target_height_field
(可选)

目标的高度字段。

从按优先级顺序列出的以下选项中选择默认的目标高度字段字段。如果存在多个字段并且所需字段在默认字段选择上没有更高优先级,将需要指定所需字段。如果不存在适合的高度字段,将使用 <无> 关键字。同样,如果某个高度字段不是所需字段但要素类具有下列字段中的一个,则需要指定 <无> 关键字。如果不存在适合的高度字段,则默认情况下将使用 <无> 关键字。

  1. Shape.Z
  2. Spot
  3. Z
  4. Z_Value
  5. Height
  6. Elev
  7. Elevation
  8. Contour
String
join_field
(可选)

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

String
sample_distance
(可选)

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

Double

代码示例

ConstructSightLines 示例 1(Python 窗口)

The following sample demonstrates the use of this tool in the Python window:

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.ConstructSightLines_3d('observer_pt.shp', 'target.shp', 
                             'sightlines.shp', 'BASEHEIGHT', 
                             'TOP_HEIGHT', 'NAME')
ConstructSightLines 示例 2(独立脚本)

The following sample demonstrates the use of this tool in a stand-alone Python script:

'''*********************************************************************
Name: Sight Line Visibility
Description: This script demonstrates how to calculate visibility
             for sight lines against the obstructions presented by
             terrain elevation & building models in a multipatch.
*********************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env

try:
    arcpy.CheckOutExtension('3D')
    # Set Local Variables
    env.workspace = 'C:/data'
    obs_pts = "Observers.shp"
    target = "Observation_Targets.shp"
    sight_lines = "in_memory/sightlines"
    surface = "sample.gdb/elevation/terrain"
    buildings = "city_buildings.shp"
    outLOS = arcpy.CreateUniqueName("Line_of_Sight.shp")
    obstruction_pts = arcpy.CreateUniqueName("Obstruction_Points.shp")
    arcpy.AddMessage("Constructing sight lines...")
    arcpy.ddd.ConstructSightLines(obs_pts, target, sight_lines)
    arcpy.AddMessage("Calculating line of sight...")
    arcpy.ddd.LineOfSight(surface, sight_lines, outLOS, obstruction_pts, 
                          "CURVATURE", "REFRACTION", 0.35, 0, buildings)
    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)

环境

相关主题

许可信息

ArcView: 需要 3D Analyst
ArcEditor: 需要 3D Analyst
ArcInfo: 需要 3D Analyst

7/10/2012