天际线 (3D Analyst)—ArcMap

描述
插图
使用方法
语法
代码示例
环境
许可信息

描述

生成一个包含天际线或轮廓分析结果的线要素类或多面体要素类。

了解有关“天际线”工作原理的详细信息

插图

使用方法

天际线工具通常与天际线障碍物工具结合使用，但有时也与天际线图工具结合使用。此工具的其他应用在分析对 3D 飞行路径和走廊的威胁中进行了介绍。
天际线工具可以用来创建要素轮廓，通过天际线障碍工具可将这些轮廓拉伸成阴影体。有关详细信息，请参阅天际线工作原理。
以下字段将会添加到包含天际线的输出要素类：
- OBSV_PT_ID - 用于创建天际线的观察点 FID。
- ORIGFTR_ID - 要素的 FID，如建筑物。
以下字段将会添加到包含轮廓的输出要素类：
- OBSV_PT_ID - 用于创建轮廓的轮廓点 FID。
- ORIGFTR_ID - 轮廓表示的原始要素（如建筑物）的 FID。
- DIR_VECT_X - 表示来自观察点的光线方向的单位矢量的 X 分量。
- DIR_VECT_Y - 表示来自观察点的光线方向的单位矢量的 Y 分量。
- DIR_VECT_Z - 表示来自观察点的光线方向的单位矢量的 Z 分量。
- FEAT_CTR_X - 原始要素（如建筑物）包络中心的 X 分量。
- FEAT_CTR_Y - 要素包络中心的 Y 分量。
- FEAT_CTR_Z - 要素包络中心的 Z 分量。
- BHND_CTR_X - 移动到要素后面的要素包络中心的 X 分量。
- BHND_CTR_Y - 移动到要素后面的要素包络中心的 Y 分量。
- BHND_CTR_Z - 移动到要素后面的要素包络中心的 Z 分量。
- USED_PARLL - 是否使用平行光线创建轮廓（1 代表是，0 代表否）。
- MADE_VERT - 是否使轮廓保持竖直，而不是垂直于光线（1 代表是，0 代表否）。
- MOVED_BHND - 是否将轮廓移动到要素后面，而不是将其留在要素中心（1 代表是，0 代表否）。

语法

arcpy.ddd.Skyline(in_observer_point_features, out_feature_class, {in_surface}, {virtual_surface_radius}, {virtual_surface_elevation}, {in_features}, {feature_lod}, {from_azimuth_value_or_field}, {to_azimuth_value_or_field}, {azimuth_increment_value_or_field}, {max_horizon_radius}, {segment_skyline}, {scale_to_percent}, {scale_according_to}, {scale_method}, {use_curvature}, {use_refraction}, {refraction_factor}, {pyramid_level_resolution}, {create_silhouettes})

参数	说明	数据类型
in_observer_point_features	表示观察点的 3D 点。每个要素都将具有自己的输出。	Feature Layer
out_feature_class	表示天际线的线或表示轮廓的多面体的3D 要素。	Feature Class
in_surface （可选）	将用于定义地平线的地形面。如果未提供表面，则会通过使用 virtual_surface_radius 和 virtual_surface_elevation 参数采用一个虚拟表面。	LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer; Terrain Layer
virtual_surface_radius （可选）	未提供地形面时，用于定义地平线的虚拟表面的半径。默认值是 1,000 米。支持的单位如下： UNKNOWN —未知 INCHES —英寸 FEET —英尺 YARDS —码 MILES —英里 MILLIMETERS —毫米 CENTIMETERS —厘米 DECIMETERS —公寸 METERS —米 KILOMETERS —千米	Linear Unit
virtual_surface_elevation （可选）	代替实际表面来定义地平线的虚拟表面的高程。如果提供了实际表面，则可忽略。默认值为 0。支持的单位如下： UNKNOWN —未知 INCHES —英寸 FEET —英尺 YARDS —码 MILES —英里 MILLIMETERS —毫米 CENTIMETERS —厘米 DECIMETERS —公寸 METERS —米 KILOMETERS —千米	Linear Unit
in_features [in_features,...] （可选）	用于测定天际线的要素。如果没有指定要素，则天际线将只由地平线（通过地形面或虚拟表面定义）构成。	Feature Layer
feature_lod （可选）	在天际线分析中检查每个要素的细节层次。 FULL_DETAIL —在天际线分析中考虑要素中的每条边（仅限三角形和外部环的边）。此时，消耗大量时间的操作最为精确，也是默认选项。 CONVEX_FOOTPRINT —天际线分析将使用每个要素轮廓线的凸包（拉伸到要素内最高折点的高程）的上部周长。 ENVELOPE — 天际线分析将使用三维要素包络的周长。这是最快的方法。	String
from_azimuth_value_or_field （可选）	开始天际线分析的方位角，以度为单位。天际线分析以观察点为起点，并从起始方位角向右移动，直到结束方位角。方位角必须大于负 360 且小于 360。默认值为 0。	Double; Field
to_azimuth_value_or_field （可选）	完成天际线分析的方位角，以度为单位。天际线分析以观察点为起点，并从起始方位角向右移动，直到结束方位角。结束方位角必须大于起始方位角，且不得超过 360。默认值为 360。	Double; Field
azimuth_increment_value_or_field （可选）	在起始方位角和结束方位角之间执行天际线分析以计算地平线时的角度间隔，以度为单位。此值不得大于结束方位角与起始方位角的差值。默认值为 1。	Double; Field
max_horizon_radius （可选）	从观察点位置应能搜索到地平线的最大距离。零值表明应没有施加限制。默认值为 0。支持的单位如下： UNKNOWN —未知 INCHES —英寸 FEET —英尺 YARDS —码 MILES —英里 MILLIMETERS —毫米 CENTIMETERS —厘米 DECIMETERS —公寸 METERS —米 KILOMETERS —千米	Linear Unit
segment_skyline （可选）	确定生成的天际线是为每个观察点对应一个要素，还是每个观察点的天际线将按照构成天际线的唯一元素进行分段。如果正在生成轮廓，那么此参数将指示是否使用发散光线；对于太阳阴影体，此参数的状态通常为 NO_SEGMENT_SKYLINE NO_SEGMENT_SKYLINE —每个天际线要素将表示一个观察点。这是默认设置。 SEGMENT_SKYLINE —每个观察点的天际线都将按照构成天际线的唯一元素进行分段。	Boolean
scale_to_percent （可选）	表示放置每个天际线折点应依据的原始垂直角（地平线以上的角或高程角）或高程的缩放百分比。如果输入 0 或 100，则不会进行缩放。默认值为 100。	Double
scale_according_to （可选）	确定缩放所依据的值。 VERTICAL_ANGLE —通过考虑每个折点相对于观察点的垂直角确定缩放。这是默认设置。 ELEVATION —通过考虑每个折点相对于观察点的高度确定缩放。	String
scale_method （可选）	计算折点所依据的缩放方法。 SKYLINE_MAXIMUM —将相对于具有最高垂直角（或高程）的折点的垂直角（或高程）进行缩放。这是默认设置。 EACH_VERTEX —将相对于每个折点的原始垂直角（或高程）进行缩放。	String
use_curvature （可选）	指示根据作用表面生成山脊线时，是否要考虑地球的曲率。 CURVATURE —将考虑地球的曲率。 NO_CURVATURE —将不考虑地球的曲率。这是默认设置。	Boolean
use_refraction （可选）	指示根据作用表面生成山脊线时，是否要考虑应用大气折射。 NO_REFRACTION — 将不考虑大气折射。这是默认设置。 REFRACTION —将考虑大气折射。	Boolean
refraction_factor （可选）	考虑大气折射时使用的折射系数。默认值为 0.13。	Double
pyramid_level_resolution （可选）	此工具将使用 terrain 金字塔等级的 z 容差或窗口大小分辨率。默认值为 0（z 容差），或全分辨率（窗口大小）。	Double
create_silhouettes （可选）	指定输出要素是表示天际线还是轮廓。 NO_CREATE_SILHOUETTES —生成的折线要素表示天际线。这是默认设置。 CREATE_SILHOUETTES —生成的多面体要素表示轮廓。	Boolean

代码示例

Skyline 示例 1（Python 窗口）

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

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.Skyline_3d("observers.shp", "skyline_output.shp", "sample.gdb/featuredataset/terrain")

Skyline 示例 2（独立脚本）

下面的示例演示了如何在独立 Python 脚本中使用此工具。

'''****************************************************************************
Name: Skyline Example
Description: This script demonstrates how to use the 
             Skyline tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    env.workspace = 'C:/data'
    # Set Local Variables
    inPts = "observers.shp"
    # Make sure output has a unique name
    outFC = arcpy.CreateUniqueName("skyline_output.shp")
    inSurface = "sample.gdb/featuredataset/terrain"
    obstructionFCs = "buildings.shp; billboards.shp"
    surfRad = "1000 meters"
    surfElev = "100 meters"
    LOD = "FULL_DETAIL"
    fromAzim = 0
    toAzim = 360
    incAzim = 1
    maxHorizRad = 0
    segSky = "SEGMENT_SKYLINE"
    scale = 100
    scaleAcc = "ELEVATION"
    scaleMethod = "SKYLINE_MAXIMUM"
    
    # Execute Skyline
    arcpy.Skyline_3d(inPts, outFC, inSurface, surfRad, surfElev, 
                     obstructionFCs, LOD, fromAzim, toAzim, incAzim, 
                     maxHorizRad, segSky, scale, scaleAcc, scaleMethod)


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

描述

插图

使用方法

语法

代码示例

Skyline 示例 1（Python 窗口）

Skyline 示例 2（独立脚本）

环境

许可信息

相关主题