标注 | 说明 | 数据类型 |
输入要素 | 将构成阳光遮挡来源的多面体要素。 | Feature Layer |
地表 | 用于确定阳光遮挡评估位置的栅格地表。 | Raster Layer |
输出阴影栅格 | 其像元值可反映相应地面高度位置被输入要素遮挡的次数的输出栅格。 | Raster Dataset |
输出像元大小 (可选) | 输出栅格的像元大小。 | Linear Unit |
开始时间 (可选) | 将开始计算太阳位置的日期和时间。 默认值为初始化工具的日期和时间。 | Date |
结束时间 (可选) | 将结束计算太阳位置的日期和时间。 时间间隔参数用于迭代评估从开始时间到结束时间的每一天。 因此,结束时间不能早于开始时间。 | Date |
时间间隔 (可选) | 用于计算从开始日期和时间到结束日期和时间的太阳位置的时间间隔。 | Time Unit |
时区 (可选) | 确认与用于确定太阳相对位置的指定输入时间相对应的时区。
| String |
按夏令时调整 (可选) | 用于指定是否按夏令时调整输入时间。
| Boolean |
最大阴影长度 (可选) | 计算过程中从输入要素投射阴影的最大距离。 在太阳位置高度角较低时,请考虑定义该值,如果不定义,则生成的阴影会比较长,可能会增加不必要的处理时间。 | Linear Unit |
摘要
用于计算从某表面上固定位置到太阳的直接视线被多面体要素遮挡的次数。
插图
使用情况
太阳位置将从开始日期和时间计算到结束日期和时间。 如果已指定时间间隔,将针对开始日期与结束日期之间的每一天,从开始时间到结束时间以迭代方式计算太阳位置。 太阳不在地平线上方的任何时间均会被跳过。
输出栅格的像元值表示给定像元位于阴影中的次数。 所有像元的最大可能值均与太阳位于地平线之上的次数相对应。
在针对临近日出和日落时的太阳倾角生成结果时,请考虑定义最大阴影长度,以避免受到长阴影覆盖区的影响。 强制执行距离也有助于提高工具的性能。
参数
arcpy.ddd.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 (可选) | 将开始计算太阳位置的日期和时间。 默认值为初始化工具的日期和时间。 | Date |
end_time (可选) | 将结束计算太阳位置的日期和时间。 time_interval 参数用于迭代评估从开始时间到结束时间的每一天。 因此,结束时间不能早于开始时间。 | 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