太阳阴影频率 (3D Analyst)

摘要

用于计算从某表面上固定位置到太阳的直接视线被多面体要素遮挡的次数。

插图

太阳阴影频率工具图示

使用情况

  • 太阳位置将从开始日期和时间计算到结束日期和时间。 如果已指定时间间隔,将针对开始日期与结束日期之间的每一天,从开始时间到结束时间以迭代方式计算太阳位置。 太阳不在地平线上方的任何时间均会被跳过。

  • 输出栅格的像元值表示给定像元位于阴影中的次数。 所有像元的最大可能值均与太阳位于地平线之上的次数相对应。

  • 在针对临近日出和日落时的太阳倾角生成结果时,请考虑定义最大阴影长度,以避免受到长阴影覆盖区的影响。 强制执行距离也有助于提高工具的性能。

参数

标注说明数据类型
输入要素

将构成阳光遮挡来源的多面体要素。

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
(可选)

将结束计算太阳位置的日期和时间。

Date
time_interval
(可选)

用于计算从开始日期和时间到结束日期和时间的太阳位置的时间间隔。

Time Unit
time_zone
(可选)

与用于确定太阳相对位置的指定输入时间相对应的时区。 可用值的列表由操作系统定义,但其默认设置为计算机上当前时间的时区。

String
dst
(可选)

用于指定是否按夏令时调整指定时间。

  • DST按夏令时调整输入时间。
  • NO_DST不按夏令时调整输入时间。 这是默认设置。
Boolean
max_shadow_length
(可选)

计算过程中从输入要素投射阴影的最大距离。 在太阳位置高度角较低时,请考虑定义该值,如果不定义,则生成的阴影会比较长,可能会增加不必要的处理时间。

Linear Unit

代码示例

SunShadowFrequency example 1 (Python window)

下面的示例演示了如何在 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

相关主题