描述
用于计算从某表面上固定位置到太阳的直接视线被多面体要素遮挡的次数。
插图
使用方法
输出栅格的像元值表示给定像元位于阴影中的次数。所有像元的最大可能值均与太阳位于地平线之上的次数相对应。
太阳位置将从开始日期和时间计算到结束日期和时间。要从日出开始计算,请指定没有开始时间的开始日期。同样,要计算到日落的太阳位置,请指定没有结束时间的结束日期。如果已指定时间间隔,则会计算从开始时间到结束时间的太阳位置。
在针对临近日出和日落时的太阳倾角生成结果时,请考虑定义最大阴影长度,以避免受到长阴影覆盖区的影响。强制执行距离也有助于提高工具的性能。
语法
SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})
参数 | 说明 | 数据类型 |
in_features [in_features,...] | 将构成阳光遮挡来源的多面体要素。 | Feature Layer |
ground | 用于确定阳光遮挡评估位置的地表。 | Raster Layer |
out_raster | 其像元值可反映相应地面高度位置被输入要素遮挡的次数的输出栅格。 | Raster Dataset |
cell_size (可选) | 输出栅格的像元大小。 | Linear Unit |
start_time (可选) | 将开始计算太阳位置的日期和时间。如果仅提供日期,则开始时间会被定义为指定日期的日出时间, 默认值为工具在应用程序中打开或在 Python 中执行的日期和时间。 | Date |
end_time (可选) | 将结束计算太阳位置的日期和时间。如果仅提供日期,则结束时间会被定义为指定日期的日落时间, | Date |
time_interval (可选) | 用于计算从开始日期和时间到结束日期和时间的太阳位置的时间间隔。 | Time Unit |
time_zone (可选) | 与用于确定太阳相对位置的指定输入时间相对应的时区。可用值的列表由操作系统定义,但其默认设置为计算机上当前时间的时区。 | String |
dst (可选) | 用于指定是否按夏令时调整指定时间。
| Boolean |
max_shadow_length (可选) | 计算过程中从输入要素投射阴影的最大距离。在处理太阳位置高度角较低的时间时,请考虑定义该值,如果不定义,则生成的阴影会比较长,可能会增加不必要的处理时间。 | Linear Unit |
代码示例
下面的示例演示了如何在 Python 窗口中使用此工具。
import arcpy
arcpy.env.workspace = 'd:\\data'
arcpy.ddd.SunShadowFrequency('Buildings.shp', 'DEM.tif', 'June_Shade.tif',
'4 Feet', '6/1/2018 10:00 AM', '6/30/2018 4:00 PM',
'15 Minutes', 'Pacific Standard Time', 'NO_DST')
许可信息
- Basic: 需要 3D Analyst
- Standard: 需要 3D Analyst
- Advanced: 需要 3D Analyst