描述
计算天空的可见性,并选择性地生成表和极线图。
所生成的表和图表示从观察点到天际线上每个折点的水平角和垂直角。
插图
使用
评估从观察点到每个折点的方位角和垂直角,并可以通过指定输出角度表将其导出至独立表。此表中会显示下列字段:
- HORIZ_ANG - 水平角。
- ZENITH_ANG - 天顶角。
如果选择了附加字段:
- FEATURE_ID - 遮挡观察点天空视野的天际线要素。
- VERTEX_X - 折点的 X 坐标。
- VERTEX_Y - 折点的 Y 坐标。
- VERTEX_Z - 折点的 Z 坐标。
- DIST_2D - 从观察点到折点的水平距离。
- DIST_3D - 从观察点到折点的坡面距离。
结果窗口将返回所有观察点的可见天空的平均百分比,以及最大垂直角和最小垂直角。该值可表示为 0 到 1 之间的值,其中 0.8 表示天际线可见性的 80%。
算术水平角等于 90 减去方位角,而天顶角等于 90 减去垂直角。(算术水平角为 0 时表示正东,而 90 时表示正北;天顶角为 90 时表示水平,而 0 时表示竖直向上。)
- 可见天空的百分比始终在结果中列出。此值等于天际线上方的区域除以基本可见角(参数之一,默认值为零,表示与观察点在同一高程)上方的区域,并且只能在天际线的方位角范围内进行计算。
语法
SkylineGraph(in_observer_point_features, in_line_features, {base_visibility_angle}, {additional_fields}, {out_angles_table}, {out_graph})
参数 | 说明 | 数据类型 |
in_observer_point_features | 包含一个或多个观察点的输入要素。 | Feature Layer |
in_line_features | 表示天际线的线要素。 | Feature Layer |
base_visibility_angle (可选) | 用作计算可见天空百分比的基线的垂直角。0 表示水平,90 表示竖直向上;-90 表示竖直向下。默认值为 0。 | Double |
additional_fields (可选) | 指定是否有附加字段添加到角度表中。
| Boolean |
out_angles_table (可选) | 创建用于输出角度的表。 | Table |
out_graph (可选) | 指定名称将创建第一个观察点的天际线轮廓的极线图。该图代表可以从观察点的位置看到的潜在天空,并具有由该观察点定义的原点。必须生成一个表以便创建该图,且只有在 ArcMap、ArcGlobe 或 ArcScene 中执行该工具时才能显示该图。 | Graph |
派生输出
名称 | 说明 | 数据类型 |
out_visibility_ratio | 所有观察点的可见天空的平均百分比。该值可表示为 0 到 1 之间的值,其中 0.8 表示天际线可见性的 80%。 | 双精度型 |
代码示例
SkylineGraph 示例 1(Python 窗口)
下面的示例演示了如何在 Python 窗口中使用此工具。
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SkylineGraph_3d("observers.shp", "skyline_outline.shp", 0, "ADDITIONAL_FIELDS", "table.dbf")
SkylineGraph 示例 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"
inLines = "skyline_outline.shp"
baseVisibility = 25
# Ensure output table has unique name
outTable = arcpy.CreateUniqueName("angles_table.dbf")
#Execute SkylineGraph
arcpy.SkylineGraph_3d(inPts, inLines, 0, "ADDITIONAL_FIELDS", outTable)
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