太阳辐射图 (Spatial Analyst)

需要 Spatial Analyst 许可。

摘要

获得用于计算直接太阳辐射、散射太阳辐射和整体太阳辐射的半球视域、太阳图和星空图的栅格表达。

使用情况

• 太阳辐射图工具的输出是与太阳辐射区域分析或太阳辐射点分析的输出相对应的栅格表达，而不是地图。 更确切地说，这些输出是从给定位置仰视的方向半球中各方向的栅格表达。 在半球投影中，中心是天顶，圆形地图表达的边是地平线，相对于天顶的角度与半径成比例。 半球投影没有地理坐标系，左下角为 (0,0)。

• 将所有位置的视域存储在 DEM 中是不可行的，所以在未指定输入位置时，仅为输入表面栅格的中心创建一个视域。 指定输入点要素或位置文件时，将为每个输入位置创建多个视域栅格。 指定多个位置时，输出将为多波段栅格，其中每个波段对应于一个特定位置的视域。

• 输入位置表可以是点要素类或是点坐标表。 按表输入位置时，必须通过 x,y 坐标指定位置列表。 该表可以是地理数据库表、.dbf 文件、INFO 表或文本表文件。 如果使用 ASCII 坐标文件，每行均应包含一个由逗号、空格或制表符分隔的 x,y 对。

• 输出图形显示栅格不支持范围或像元大小环境设置。 输出范围始终与星空大小/分辨率有关，而像元大小等于一。 但是，基础分析将使用环境设置并可能影响视域的结果。

• 系统可能生成一两个太阳图栅格，具体情况取决于时间配置在一年中是否包括叠置的太阳位置。 创建两个太阳图时，其中一个太阳图表示冬至到夏至之间的期间，另一个太阳图则表示夏至到冬至之间的期间。 夏至/冬至通常为 6 月/12 月 20 日或 21 日，但有时，也可能为 22 日，具体取决于年份。 当创建多个太阳图时，默认输出为多波段栅格。

• 位置区域的纬度（单位：十进制度，北半球为正，南半球为负）可用于如太阳赤纬和太阳方位的计算。

  分析专门针对局部景观尺度，因此，通常可以针对整个 DEM 使用一个纬度值。 对于更大的数据集（如州、国家或大洲），不同纬度（大于 1 度）处的日照结果将明显不同。 要对更广阔的地理区域进行分析，必须将研究区域分割为具有不同纬度的区域。

• 对于包含空间参考的输入表面栅格数据，会自动计算平均纬度；否则，纬度将默认为 45 度。 如果使用输入图层，则将使用数据框的空间参考。

• 天空大小是辐射计算中使用的视域、天空图和太阳图栅格数据的分辨率（单位：每边像元数）。 这些是天空的仰视半球栅格表示，没有地理坐标系。 这些栅格为正方形（行和列数相等）。

  如果使用一整年或多日时间配置，建议使用以下天空大小值：

  • 如果间隔为 1 天，可使用大于和等于 1000 的天空大小。
  • 如果间隔为 0.25 天，可使用大于和等于 2000 的天空大小。
  • 如果间隔为 0.1 小时，可使用大于和等于 4000 的天空大小。

  增加天空大小会提高计算精度，但也会显著增加计算时间。

• 如果“间隔天数”设置较小（例如，小于 14 天），可使用较大的天空大小。 分析期间，阳光图（取决于天空大小）用于表示特定时间段的太阳位置（轨迹）以计算直接辐射。 对于更小的间隔天数，如果天空大小分辨率不是足够大，太阳轨迹可能重叠，从而导致该轨迹的辐射值为零或更低。 增加分辨率可获得更精确的结果。

• 最大天空大小值为 10,000。 默认值为 200，对于具有大间隔天数（例如，大于 14 天）的整个 DEM 而言，默认值已经足够。 如果某点位置处的计算无需考虑计算时间，512 的天空大小值便已足够。 对于更小的间隔天数（例如，小于 14 天），建议使用更大的值。 例如，要在间隔天数 = 1 的情况下计算赤道上某一位置的日照，可使用大于或等于 2,800 的天空大小。

• 建议间隔天数大于 3，因为三天内的太阳轨迹通常会重叠，具体取决于天空大小和年中的时间。 使用月间隔计算整年的数据时，日间隔将被禁用，并且程序将使用日历月间隔。 默认值为 14。

• 因为视域计算可能极为耗时，因此只针对指定的计算方向数跟踪视角。 有效值必须是 8 的倍数（8、16、24、32，依此类推）。 通常，值 8 或 16 适合于地形平缓的区域，而值 32 适合于复杂地形。 默认值为 32。

• 所需的计算方向数与输入 DEM 的分辨率有关。 分辨率为 30 米的自然地形通常相当平滑，因此多数情况下较小的方向数就足够了（16 或 32）。 对于更精细的 DEM，尤其是当 DEM 中包含有人造建筑时，需要增加方向数。 增加方向数会提升精度，但也会增加计算时间。

• 有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

参数

对话框

标注	说明	数据类型
输入栅格	输入高程表面栅格。	Raster Layer
输入点要素或表 (可选)	指定位置以分析太阳辐射位置的输入点要素类或表。	Feature Layer; Table View
天空大小/分辨率 (可选)	视域、天空图和阳光图栅格的分辨率或天空大小。 单位为像元。 默认为 200 x 200 像元的栅格。	Long
高度偏移 (可选)	将执行计算的 DEM 表面之上的高度（以米为单位）。 高度偏移将应用到所有输入位置。	Double
计算方向 (可选)	计算视域时将使用的方位角方向数。 有效值必须是 8 的倍数（8、16、24、32，依此类推）。 默认值为 32 个方向，该值适用于复杂地形。	Long
纬度 (可选)	位置区域的纬度。 单位为十进制度，北半球为正值，南半球为负值。 对于包含空间参考的输入表面栅格，会自动计算平均纬度；否则，纬度将默认为 45 度。	Double
时间配置 (可选)	指定将用于计算的时间段。 特殊日期 - 将计算夏至、冬至和春秋分（春分和秋分的日照是相同的）的太阳日照。 一天内 - 将对一天内的指定时间段执行计算。 选择儒略日，然后输入起始时间和结束时间。 起始时间和结束时间相同时，将计算瞬时日照。 起始时间在日出前而结束时间在日出后时，将计算全天的日照。 要输入正确日期，可以使用日历按钮打开日历对话框。 多天 - 将对一年中的特定多天时间段执行计算。 指定起始年、起始日和结束日。 如果结束日小于起始日，则将结束日视为在下一年中。 默认时间配置起始于当前儒略年的第 5 天，结束于第 160 天。 要输入正确日期，可以使用日历按钮打开日历对话框。 整年 - 将使用计算的每月间隔对整年执行计算。 如果选中为每种间隔创建输出选项，将为每月创建输出文件；否则，将为整年创建一个输出。	Time configuration
间隔天数 (可选)	用于为太阳图计算天空分区的一年中的时间间隔（单位：天）。 默认值为 14（两周）。	Long
间隔小时数 (可选)	用于为太阳图计算天空分区的一天中的时间间隔（单位：小时）。 默认值为 0.5。	Double
输出太阳图栅格 (可选)	输出太阳图栅格。 该输出是指定太阳轨迹（即，太阳随着时间的推移而发生变化时所处的明显位置）的栅格表达。 输出的分辨率与视域和天空图相同。	Raster Dataset
天顶分割 (可选)	用于创建天空图中的天空分区的天顶分割数。 默认值为八个分割（相对于天顶）。 值必须大于零并且小于天空大小值的一半。	Long
方位角分割 (可选)	用于创建天空图中的天空分区的方位角分割数。 默认值为八个分割（相对于北方）。 有效值必须是 8 的倍数。 值必须大于零且小于 160。	Long
输出星空图栅格 (可选)	输出天空图栅格。 可通过将整个星空分成一系列由天顶分割和方位角分割定义的天空扇区来构造输出。 输出的分辨率与视域和太阳图相同。	Raster Dataset

返回值

标注	说明	数据类型
输出视域栅格	输出视域栅格。 生成的某一位置的视域表示哪些星空方向可见，哪些星空方向模糊不清。 这类似于仰视半球（鱼眼）照片提供的视图。	Raster

Python

SolarRadiationGraphics(in_surface_raster, {in_points_feature_or_table}, {sky_size}, {height_offset}, {calculation_directions}, {latitude}, {time_configuration}, {day_interval}, {hour_interval}, {out_sunmap_raster}, {zenith_divisions}, {azimuth_divisions}, {out_skymap_raster})

名称	说明	数据类型
in_surface_raster	输入高程表面栅格。	Raster Layer
in_points_feature_or_table (可选)	指定位置以分析太阳辐射位置的输入点要素类或表。	Feature Layer; Table View
sky_size (可选)	视域、天空图和阳光图栅格的分辨率或天空大小。 单位为像元。 默认为 200 x 200 像元的栅格。	Long
height_offset (可选)	将执行计算的 DEM 表面之上的高度（以米为单位）。 高度偏移将应用到所有输入位置。	Double
calculation_directions (可选)	计算视域时将使用的方位角方向数。 有效值必须是 8 的倍数（8、16、24、32，依此类推）。 默认值为 32 个方向，该值适用于复杂地形。	Long
latitude (可选)	位置区域的纬度。 单位为十进制度，北半球为正值，南半球为负值。 对于包含空间参考的输入表面栅格，会自动计算平均纬度；否则，纬度将默认为 45 度。	Double
time_configuration (可选)	指定用于计算太阳辐射的时间配置（时段）。 Time 类对象用于指定时间配置。 可用的时间配置的不同类型为 TimeWithinDay、TimeMultipleDays、TimeSpecialDays 和 TimeWholeYear。 格式如下： TimeWithinDay({day},{startTime},{endTime}) TimeMultipleDays({year},{startDay},{endDay}) TimeSpecialDays() TimeWholeYear({year}) 针对当前儒略年，默认时间配置为 TimeMultipleDays，其中 startDay 值为 5，endDay 值为 160。	Time configuration
day_interval (可选)	用于为太阳图计算天空分区的一年中的时间间隔（单位：天）。 默认值为 14（两周）。	Long
hour_interval (可选)	用于为太阳图计算天空分区的一天中的时间间隔（单位：小时）。 默认值为 0.5。	Double
out_sunmap_raster (可选)	输出太阳图栅格。 该输出是指定太阳轨迹（即，太阳随着时间的推移而发生变化时所处的明显位置）的栅格表达。 输出的分辨率与视域和天空图相同。	Raster Dataset
zenith_divisions (可选)	用于创建天空图中的天空分区的天顶分割数。 默认值为八个分割（相对于天顶）。 值必须大于零并且小于天空大小值的一半。	Long
azimuth_divisions (可选)	用于创建天空图中的天空分区的方位角分割数。 默认值为八个分割（相对于北方）。 有效值必须是 8 的倍数。 值必须大于零且小于 160。	Long
out_skymap_raster (可选)	输出天空图栅格。 可通过将整个星空分成一系列由天顶分割和方位角分割定义的天空扇区来构造输出。 输出的分辨率与视域和太阳图相同。	Raster Dataset

返回值

名称	说明	数据类型
out_viewshed_raster	输出视域栅格。 生成的某一位置的视域表示哪些星空方向可见，哪些星空方向模糊不清。 这类似于仰视半球（鱼眼）照片提供的视图。	Raster

代码示例

SolarRadiationGraphics 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何使用此工具。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outViewshedMap = SolarRadiationGraphics("elevation", "observers.shp", 200, 2, 32, 52,
                                 TimeMultipleDays(2009, 91, 212), 14, 0.5, 
                                 "c:/sapyexamples/output/sunmap", 8, 8, 
                                 "c:/sapyexamples/output/skymap")
outViewshedMap.save("c:/sapyexamples/output/viewmap")

SolarRadiationGraphics 示例 2（独立脚本）

创建用于太阳辐射分析的视域、太阳图和天空图。

# Name: SolarRadiationGraphics_Ex_02.py
# Description: Derives raster representations of a hemispherical viewshed, 
#    sunmap, and skymap, which are used in the calculation of direct, diffuse, 
#    and global solar radiation.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
pntFC = "observers.shp"
skySize = 200
zOffset = 2
directions = 32
latitude = 52
timeConfig = TimeMultipleDays(2009, 91, 212)
dayInterval = 14
hourInterval = 0.5
outSunMap = "c:/sapyexamples/output/sunmap"
zenDivisions = 8
aziDivisions = 8
outSkyMap = "c:/sapyexamples/output/skymap"

# Execute SolarRadiationGraphics
outViewshedMap = SolarRadiationGraphics(inRaster, pntFC, skySize, zOffset, 
                                    directions, latitude, timeConfig,
                                    dayInterval, hourInterval, outSunMap,
                                    zenDivisions, aziDivisions, outSkyMap)

# Save the output
outViewshedMap.save("c:/sapyexamples/output/viewmap")

环境

自动提交, 像元大小, 像元大小投影方法, 压缩, 当前工作空间, 范围, 输出配置关键字, 输出坐标系, 临时工作空间, 捕捉栅格, 切片大小

许可信息

• Basic: 需要 Spatial Analyst
• Standard: 需要 Spatial Analyst
• Advanced: 需要 Spatial Analyst