要素太阳辐射 (Spatial Analyst)

需要 Spatial Analyst 许可。

摘要

计算输入点或面要素相对于地球或月球表面(地面)的日照入射量。

输入要素可表示位置或工程表面,通过指定属性来定义分析相对于地面的大小、高度和方向。 日照量计算为每个要素一定时间内接收到的太阳辐射能量。 数值表示要素区域的总和与平均值,并分别以千瓦时 (kWh) 和每平方米的千瓦时 (kWh/m2) 为单位。

了解有关要素太阳辐射工作原理的详细信息

使用情况

  • 输入表面栅格参数定义的空间参考用于指定是针对地球还是月球进行分析。

  • 太阳辐射计算要求输出坐标系环境值为投影坐标系 (PCS)。 建议数据采用 PCS(单位:米)。 如果使用球面坐标系进行分析,则必须将输出坐标系环境设置为有效 PCS。

  • 输入要素必须为点或面要素数据。 不支持对 3D 或多面体进行分析。

    通过如为所有或单个要素指定方向、倾斜度、面积和偏移量,可以使用输入要素参数包括附加细节,从而表示工程表面,例如,将一组点表示为地面上或建筑物屋顶上的太阳能电池板。

  • 建议将输出表格式指定为地理数据库。 这样可以改善性能和功能。 dBase 文件格式 (.dbf) 的表中包含精度、字段名称长度以及日期和时间格式方面的已知限制。

  • 计算的总日照值、直接日照值、散射日照值和直射时长将作为属性添加到输出表中。 这些值包括每个要素的总日照值(在整个区域范围内)和平均日照值(每单位面积)。 单位分别为千瓦时 (kWh) 和每平方米千瓦时 (kWh/m2)。 时长单位为小时。

  • 总日照值通过分析与要素(或部分要素)相交的输入表面栅格的每个像元位置,并将其乘以该要素的面积来计算。 而不是计算要素的单个中心位置。

  • 如果对大范围进行分析,并且面要素很少或分散程度很高,则由于需要对分辨率进行栅格化处理,这可能延长处理时间。

  • 要素坡度要素坡向要素面积要素偏移参数可用于提供额外的细节,以表示可能拦截入射太阳辐射的工程表面,例如方向、倾斜度、面积和偏移量。 这些细节可以是静态的,也可以随时间而变化位置和方向。 例如地面上或建筑物屋顶上的太阳能电池板,或者移动车辆上的电池板。

    默认情况下,如果未指定要素参数,则将从输入表面栅格或各个要素计算值。 除非另有说明,否则点的面积为零。

    如果为这些参数中的任何一个提供了值,它将应用于所有输入要素。 或者,您可以提供输入要素中的字段属性,以便逐个分析每个要素。 如果指定了字段并且值缺失 (Null),则该值将被设置为零。

  • 仅支持地球的夏令时。 对于月球,时间必须以协调世界时 (UTC) 指定。

  • 结束日期和时间参数值必须大于或等于开始日期。 时间跨度不能超过一年。 开始和结束日期时间可以跨越日历年。

  • 将为每个相应的时间间隔计算输出辐射值。 如果某个时间间隔未接收到太阳辐射,则该位置的结果值将为零。

    如果在开始和结束时间之间指定的总时间不能被时间间隔等分,则将在内部延长总持续时间,以提供所需数量的时间片。 例如,如果时间间隔参数设置为覆盖三天,但指定的开始和结束时间之间的差距为八天,则时间间隔将延长为九天。 不会返回时间的部分结果。

  • 地球数据的最小时间间隔为 30 分钟,且必须是 30 的倍数。 月球数据的最小时间间隔为四小时,且必须是 2 的倍数。

  • 邻域距离Python 中的 neighborhood_distance)参数可确定邻域大小,并根据与目标像元中心之间的这一距离计算表面参数。 该值不能小于输入栅格像元大小。

    较小邻域距离可捕获地表中的更多局部变化(例如,较小地表要素的特征)。 对于高分辨率高程数据,更大的距离可能更合适。

  • 如果选中使用自适应邻域参数(Python 中的 use_adaptive_neighborhood = "ADAPTIVE_NEIGHBORHOOD"),邻域距离将随地形的变化而变化。 如果计算窗口中的内容变化过大,则邻域距离将缩小。

  • 地球的月球没有大气层,辐射参数散射比例和透过率在分析中不相关。 因此,入射的漫射太阳辐射为零,总辐射等于直接太阳辐射。

  • 散射比例是总正常辐射通量的散射部分。 值的范围介于 0 到 1 之间。 根据大气条件设置该值。 天空非常晴朗的条件下,典型值为 0.2,而天空一般晴朗的条件下,典型值为 0.3。

  • 透过率是达到地球表面的能量与与大气上边缘接收到的能量的比率。 值的范围介于 0(无透射)到 1(完全透射)之间。 通常,在天空非常晴朗的条件下,观测值为 0.6 或 0.7;在天空普通晴朗的条件下,观测值为 0.5。

  • 透射率与散射比例参数成反比关系。 更改这些值可能会影响模型的结果。 识别感兴趣区域的最佳值取决于多个变量(例如,位置和时间)。 可以更改这些值以比较它们对结果的影响。

  • 太阳图格网级别参数控制计算的速度和精度。 它根据 H3 地理空间索引系统调整将用于内部计算的六边形格网像元的分辨率。

    较低的格网级别将创建更少的太阳图区域并减少工具运行时间。 更高的格网级别将创建更小的太阳图,从而提高结果的精度。

    地球的太阳图格网级别的有效值范围为 5 到 7。 对于月球,有效值范围为 4 到 6。

    默认级别由输入表面栅格确定。 分析地球表面数据时,如果分析像元大小小于或等于 4 米,则默认格网级别为 6。 如果像元大小大于 4 米,则默认格网级别为 5。 对于分析月球表面数据,默认级别为 6。

    下表显示了每个太阳图级别的六边形格网像元的平均面积(以平方公里为单位):

    等级地球月亮

    4

    不适用

    131.6

    5

    252.9(默认值 > 4m)

    18.8

    6

    36.1(默认值 < 4m)

    2.69(默认值)

    7

    5.16

    不适用

  • 此工具可通过 GPU 加速,也就是说,如果系统中安装了兼容的图形处理器 (GPU),该设备将用于增强工具的性能。 使用用于分析的目标设备(Python 中的 analysis_target_device)参数来控制是使用 GPU 还是 CPU 来运行该工具。

    有关兼容的 GPU 以及配置和使用 GPU 设备的详细信息还有故障排除提示,请参阅使用 Spatial Analyst 进行 GPU 处理

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

  • 其他资源:

    Acton, Charles A. 1996. "Ancillary data services of NASA's Navigation and Ancillary Information Facility". Planetary and Space Science Volume 44, Issue 1, January 1996, pp. 65–70. https://doi.org/10.1016/0032-0633(95)00107-7

    Acton, Charles, Nathaniel Bachman, Boris Semenov, and Edward Wright. 2018. "A look towards the future in the handling of space science mission geometry." Planetary and Space Science Volume 150, January 2018, pp. 9–12. https://doi.org/10.1016/j.pss.2017.02.013

    Brodsky, Isaac. 2018. "Uber’s Hexagonal Hierarchical Spatial Index H3." Engineering (blog), June 27, 2018. https://www.uber.com/blog/h3/

参数

标注说明数据类型
输入表面栅格

输入高程表面栅格。

Raster Layer
输入点或面要素

输入要素(点或面),用于表示接收到的太阳辐射量的位置或工程表面。

Feature Layer
唯一 ID 字段

包含定义每个要素的值的字段。

该字段可以是输入要素的整型或字符串型字段。

Field
输出表

将包含接收到的太阳辐射量汇总的输出表

表的格式由输出位置和路径确定。 默认情况下,如果在地理数据库工作空间中,则输出将是一个地理数据库表;如果在文件工作空间中,则输出将为 dBASE 表。

Table
起始日期和时间

分析的开始日期和时间。

Date
结束日期和时间

分析的结束日期和时间。

Date
时区
(可选)

用于开始和结束时间的时区。 默认值为协调世界时间 (UTC)。

  • UTC时区将为 UTC。
  • 国际日期变更线标准时间时区将为国际日期变更线标准时间 (UTC-12:00)。
  • UTC-11时区将为 UTC-11 (UTC-11:00)。
  • 阿留申标准时间时区将为阿留申标准时间 (UTC-10:00)。
  • 夏威夷标准时间时区将为夏威夷标准时间 (UTC-10:00)。
  • 马克萨斯标准时间时区将为马克萨斯标准时间 (UTC-09:30)。
  • 阿拉斯加标准时间时区将为阿拉斯加标准时间 (UTC-09:00)。
  • UTC-09时区将为 UTC-09 (UTC-09:00)。
  • 太平洋标准时间(墨西哥)时区将为太平洋标准时间(墨西哥)(UTC-08:00)。
  • UTC-08时区将为 UTC-08 (UTC-08:00)。
  • 太平洋标准时间时区将为太平洋标准时间 (UTC-08:00)。
  • 美国山区标准时间时区将为美国山区标准时间 (UTC-07:00)。
  • 山区标准时间(墨西哥)时区将为山区标准时间(墨西哥)(UTC-07:00)。
  • 山区标准时间时区将为山区标准时间 (UTC-07:00)。
  • 育空标准时间时区将为育空标准时间 (UTC-07:00)。
  • 中美洲标准时间时区将为中美洲标准时间 (UTC-06:00)。
  • 中部标准时间时区将为中部标准时间 (UTC-06:00)。
  • 复活节岛标准时间时区将为复活节岛标准时间 (UTC-06:00)。
  • 中部标准时间(墨西哥)时区将为中部标准时间(墨西哥)(UTC-06:00)。
  • 加拿大中部标准时间时区将为加拿大中部标准时间 (UTC-06:00)。
  • SA 太平洋标准时间时区将为 SA 太平洋标准时间 (UTC-05:00)。
  • 东部标准时间(墨西哥)时区将为东部标准时间(墨西哥)(UTC-05:00)。
  • 东部标准时间时区将为东部标准时间 (UTC-05:00)。
  • 海地标准时间时区将为海地标准时间 (UTC-05:00)。
  • 古巴标准时间时区将为古巴标准时间 (UTC-05:00)。
  • 美国东部标准时间时区将为美国东部标准时间 (UTC-05:00)。
  • 特克斯和凯科斯标准时间时区将为特克斯和凯科斯标准时间 (UTC-04:00)。
  • 巴拉圭标准时间时区将为巴拉圭标准时间 (UTC-04:00)。
  • 大西洋标准时间时区将为大西洋标准时间 (UTC-04:00)。
  • 委内瑞拉标准时时区将为委内瑞拉标准时间 (UTC-04:00)。
  • 中部巴西标准时间时区将为中部巴西标准时间 (UTC-04:00)。
  • SA 西部标准时间时区将为 SA 西部标准时间 (UTC-04:00)。
  • 太平洋 SA 标准时间时区将为太平洋 SA 标准时间 (UTC-04:00)。
  • 纽芬兰标准时间时区将为纽芬兰标准时间 (UTC-03:30)。
  • 托坎廷斯标准时间时区将为托坎廷斯标准时间 (UTC-03:00)。
  • 东南美洲标准时间时区将为东南美洲标准时间 (UTC-03:00)。
  • SA 东部标准时间时区将为 SA 东部标准时间 (UTC-03:00)。
  • 阿根廷标准时间时区将为阿根廷标准时间 (UTC-03:00)。
  • 格陵兰岛标准时间时区将为格陵兰岛标准时间 (UTC-03:00)。
  • 蒙得维的亚标准时间时区将为蒙得维的亚标准时间 (UTC-03:00)。
  • 麦哲伦标准时间时区将为麦哲伦标准时间 (UTC-03:00)。
  • 圣皮埃尔标准时间时区将为圣皮埃尔标准时间 (UTC-03:00)。
  • 巴伊亚标准时间时区将为巴伊亚标准时间 (UTC-03:00)。
  • UTC-02时区将为 UTC-02 (UTC-02:00)。
  • 中部大西洋标准时间时区将为中部大西洋标准时间 (UTC-02:00)。
  • 亚速尔群岛标准时间时区将为亚速尔群岛标准时间 (UTC-01:00)。
  • 佛得角标准时间时区将为佛得角标准时间 (UTC-01:00)。
  • GMT 标准时间时区将为 GMT 标准时间 (UTC+00:00)。
  • 格林尼治标准时间时区将为格林尼治标准时间 (UTC+00:00)。
  • 圣多美标准时间时区将为圣多美标准时间 (UTC+00:00)。
  • 摩洛哥标准时间时区将为摩洛哥标准时间 (UTC+00:00)。
  • 西欧标准时间时区将为西欧标准时间 (UTC+01:00)。
  • 中欧标准时间时区将为中欧标准时间 (UTC+01:00)。
  • 罗曼标准时间时区将为罗曼标准时间 (UTC+01:00)。
  • 中欧标准时间时区将为中欧标准时间 (UTC+01:00)。
  • 中非西部标准时间时区将为中非西部标准时间 (UTC+01:00)。
  • 约旦标准时间时区将为约旦标准时间 (UTC+02:00)。
  • GTB 标准时间时区将为 GTB 标准时间 (UTC+02:00)。
  • 中东标准时间时区将为中东标准时间 (UTC+02:00)。
  • 埃及标准时间时区将为埃及标准时间 (UTC+02:00)。
  • 东欧标准时间时区将为东欧标准时间 (UTC+02:00)。
  • 叙利亚标准时间时区将为叙利亚标准时间 (UTC+02:00)。
  • 西岸标准时间时区将为西岸标准时间 (UTC+02:00)。
  • 南非标准时间时区将为南非标准时间 (UTC+02:00)。
  • FLE 标准时间时区将为 FLE 标准时间 (UTC+02:00)。
  • 以色列标准时间时区将为以色列标准时间 (UTC+02:00)。
  • 南苏丹标准时间时区将为南苏丹标准时间 (UTC+02:00)。
  • 加里宁格勒标准时间时区将为加里宁格勒标准时间 (UTC+02:00)。
  • 苏丹标准时间时区将为苏丹标准时间 (UTC+02:00)。
  • 利比亚标准时间时区将为利比亚标准时间 (UTC+02:00)。
  • 纳米比亚标准时间时区将为纳米比亚标准时间 (UTC+02:00)。
  • 阿拉伯标准时间时区将为阿拉伯标准时间 (UTC+03:00)。
  • 土耳其标准时间时区将为土耳其标准时间 (UTC+03:00)。
  • 阿拉伯标准时间时区将为阿拉伯标准时间 (UTC+03:00)。
  • 白俄罗斯标准时间时区将为白俄罗斯标准时间 (UTC+03:00)。
  • 俄罗斯标准时间时区将为俄罗斯标准时间 (UTC+03:00)。
  • 东非标准时间时区将为东非标准时间 (UTC+03:00)。
  • 伏尔加格勒标准时间时区将为伏尔加格勒标准时间 (UTC+03:00)。
  • 伊朗标准时间时区将为伊朗标准时间 (UTC+03:30)。
  • 阿拉伯标准时间时区将为阿拉伯标准时间 (UTC+04:00)。
  • 阿斯特拉罕标准时间时区将为阿斯特拉罕标准时间 (UTC+04:00)。
  • 阿塞拜疆标准时间时区将为阿塞拜疆标准时间 (UTC+04:00)。
  • 俄罗斯时区 3时区将为俄罗斯时区 3 (UTC+04:00)。
  • 毛里求斯标准时间时区将为毛里求斯标准时间 (UTC+04:00)。
  • 萨拉托夫标准时间时区将为萨拉托夫标准时间 (UTC+04:00)。
  • 乔治亚州标准时间时区将为乔治亚州标准时间 (UTC+04:00)。
  • 高加索标准时间时区将为高加索标准时间 (UTC+04:00)。
  • 阿富汗标准时间时区将为阿富汗标准时间 (UTC+04:30)。
  • 西亚标准时间时区将为西亚标准时间 (UTC+05:00)。
  • 叶卡捷琳堡标准时间时区将为叶卡捷琳堡标准时间 (UTC+05:00)。
  • 巴基斯坦标准时间时区将为巴基斯坦标准时间 (UTC+05:00)。
  • 克孜勒奥尔达标准时间时区将为克孜勒奥尔达标准时间 (UTC+05:00)。
  • 印度标准时间时区将为印度标准时间 (UTC+05:30)。
  • 斯里兰卡标准时间时区将为斯里兰卡标准时间 (UTC+05:30)。
  • 尼泊尔标准时间时区将为尼泊尔标准时间 (UTC+05:45)。
  • 中亚标准时间时区将为中亚标准时间 (UTC+06:00)。
  • 孟加拉国标准时间时区将为孟加拉国标准时间 (UTC+06:00)。
  • 鄂木斯克标准时间时区将为鄂木斯克标准时间 (UTC+06:00)。
  • 缅甸标准时间时区将为缅甸标准时间 (UTC+06:30)。
  • 东南亚标准时间时区将为东南亚标准时间 (UTC+07:00)。
  • 阿尔泰标准时间时区将为阿尔泰标准时间 (UTC+07:00)。
  • 西蒙古标准时间时区将为西蒙古标准时间 (UTC+07:00)。
  • 北亚标准时间时区将为北亚标准时间 (UTC+07:00)。
  • 中亚南部标准时间时区将为中亚南部标准时间 (UTC+07:00)。
  • 托木斯克标准时间时区将为托木斯克标准时间 (UTC+07:00)。
  • 中国标准时间时区将为中国标准时间 (UTC+08:00)。
  • 北亚东部标准时间时区将为北亚东部标准时间 (UTC+08:00)。
  • 新加坡标准时间时区将为新加坡标准时间 (UTC+08:00)。
  • 西部澳大利亚标准时间时区将为西部澳大利亚标准时间 (UTC+08:00)。
  • 台北标准时间时区将为台北标准时间 (UTC+08:00)。
  • 乌兰巴托标准时间时区将为乌兰巴托标准时间 (UTC+08:00)。
  • 澳大利亚中西部标准时间时区将为澳大利亚中西部标准时间 (UTC+08:45)。
  • 外贝加尔标准时间时区将为外贝加尔标准时间 (UTC+09:00)。
  • 东京标准时间时区将为东京标准时间 (UTC+09:00)。
  • 朝鲜标准时间时区将为朝鲜标准时间 (UTC+09:00)。
  • 韩国标准时间时区将为韩国标准时间 (UTC+09:00)。
  • 雅库茨克标准时间时区将为雅库茨克标准时间 (UTC+09:00)。
  • 中部 澳大利亚标准时间时区将为中部。 澳大利亚标准时间 (UTC+09:30)。
  • 澳大利亚中部标准时间时区将为澳大利亚中部标准时间 (UTC+09:30)。
  • 东部澳大利亚标准时间时区将为东部澳大利亚标准时间 (UTC+10:00)。
  • 澳大利亚东部标准时间时区将为澳大利亚东部标准时间 (UTC+10:00)。
  • 西太平洋标准时间时区将为西太平洋标准时间 (UTC+10:00)。
  • 塔斯马尼亚标准时间时区将为塔斯马尼亚标准时间 (UTC+10:00)。
  • 符拉迪沃斯托克标准时间时区将为符拉迪沃斯托克标准时间 (UTC+10:00)。
  • 豪勋爵标准时间时区将为豪勋爵标准时间 (UTC+10:30)。
  • 布干维尔标准时间时区将为布干维尔标准时间 (UTC+11:00)。
  • 俄罗斯时区 10时区将为俄罗斯时区 10 (UTC+11:00)。
  • 马加丹标准时间时区将为马加丹标准时间 (UTC+11:00)。
  • 诺福克标准时间时区将为诺福克标准时间 (UTC+11:00)。
  • 萨哈林标准时间时区将为萨哈林标准时间 (UTC+11:00)。
  • 中太平洋标准时间时区将为中太平洋标准时间 (UTC+11:00)。
  • 俄罗斯时区 11时区将为俄罗斯时区 11 (UTC+11:00)。
  • 新西兰标准时间时区将为新西兰标准时间 (UTC+12:00)。
  • UTC+12时区将为 UTC+12 (UTC+12:00)。
  • 斐济标准时间时区将为斐济标准时间 (UTC+12:00)。
  • 堪察加标准时间时区将为堪察加标准时间 (UTC+12:00)。
  • 查塔姆群岛标准时间时区将为查塔姆群岛标准时间 (UTC+12:45)。
  • UTC+13时区将为 UTC+13 (UTC+13:00)。
  • 东加群岛标准时间时区将为东加群岛标准时间 (UTC+13:00)。
  • 萨摩亚标准时间时区将为萨摩亚标准时间 (UTC+13:00)。
  • 莱恩群岛标准时间时区将为莱恩群岛标准时间 (UTC+14:00)。
String
按夏令时调整时间
(可选)

指定是否将输入时间配置调整为夏令时。

此参数不适用于月球上的分析。

  • 未选中 - 不会按夏令时调整输入时间值。 这是默认设置。
  • 选中 - 将按夏令时调整输入时间值。
Boolean
计算时间间隔的日照
(可选)

指定是否对整个时间配置计算单一总日射值,还是对指定间隔计算多个辐射值。

  • 未选中 - 针对整个时间配置计算一个总日照值。 这是默认设置。
  • 选中 - 针对整个时间配置中的各时间间隔计算多个日照值。 输出数取决于间隔值。 例如,使用每月间隔计算整年时,结果将包含针对各位置的 12 个输出辐射值。
Boolean
时间间隔单位
(可选)

指定用于计算整个时间配置的太阳辐射值的时间单位。

仅当选中计算时间间隔的日照参数时,此参数才可用。

  • 分钟间隔单位将为分钟。 此选项仅适用于基于地球的数据。
  • 小时间隔单位将为小时。
  • 间隔单位将为天。 这是默认设置
  • 间隔单位将为周。
String
时间间隔
(可选)

持续时间或间隔之间的时间值。

默认值取决于指定的间隔单位。 每个可用单位的默认值如下所示。

  • 分钟 - 60
  • 小时 - 4
  • - 14
  • - 2
Long
要素偏移
(可选)

将添加到栅格表面上的用于分析的垂直距离。 它必须为正整数值或浮点值。

可以从输入要素数据集中选择一个字段,或者可以提供一个数值。

例如,如果对象是一个面板,则需提供面板的高度。

如果为此参数提供了一个值,则所有要素都将使用该值。 要为每个单独要素指定不同的值,请从输入要素数据集中选择一个字段。

默认值为 0。

Double; Field
要素面积
(可选)

与输入要素相关联的面积。 它必须为正整数值或浮点值。

可以从输入要素数据集中选择一个字段,或者可以提供一个数值。

例如,如果对象是一个面板,则需提供面板的面积。

如果为此参数提供了一个值,则所有要素都将使用该值。 要为每个单独要素指定不同的值,请从输入要素数据集中选择一个字段。

默认情况下,面积根据输入要素获取。 默认情况下,点要素的面积为 0。

Double; Field
要素坡度
(可选)

与输入要素相关联的相对坡度或倾斜度。 它必须为正整数值或浮点值。

可以从输入要素数据集中选择一个字段,或者可以提供一个数值。

例如,如果对象是一个面板,则需提供面板的倾斜度。

如果为此参数提供了一个值,则所有要素都将使用该值。 要为每个单独要素指定不同的值,请从输入要素数据集中选择一个字段。

坡度以 0 到 90 度的角度表示。 分析的默认值是根据输入表面栅格的基本值计算的。

Double; Field
要素坡向
(可选)

与输入要素相关联的相对破向或方向。 它必须为正整数值或浮点值。

可以从输入要素数据集中选择一个字段,或者可以提供一个数值。

例如,如果对象是一个面板,则需提供面板面的方向。

如果为此参数提供了一个值,则所有要素都将使用该值。 要为每个单独要素指定不同的值,请从输入要素数据集中选择一个字段。

坡向由 0 到 360 度之间的度数表示。 分析的默认值是根据输入表面栅格的基本值计算的。

Double; Field
邻域距离
(可选)

与目标像元中心的距离,将根据此目标像元计算输出间隔值。 可确定邻域大小。

默认值为输入表面栅格像元大小,可生成 3 x 3 邻域。

Linear Unit
使用自适应邻域
(可选)

指定邻域距离是否随地表变化而变化(自适应)。 最大距离由邻域距离确定。 最小距离为输入栅格像元大小。

  • 未选中 - 将在所有位置使用单一(固定)邻域距离。 这是默认设置。
  • 选中 - 将在所有位置使用自适应邻域距离。
Boolean
散射模型类型
(可选)

指定将使用的散射辐射模型的类型。

  • 统一天空将使用均匀散射模型。 所有天空方向的入射散射辐射均相同。 这是默认设置。
  • 标准阴天天空将使用标准阴天散射模型。 入射散射辐射通量随天顶角而变化。
String
散射比例
(可选)

散射的总正常辐射通量的比例。 值的范围介于 0 到 1 之间。

根据大气条件设置该值。 默认值为 0.3,适用于普通晴朗的天空条件。

Double
透射率
(可选)

穿过大气层的辐射部分(所有波长的平均值)。 值的范围介于 0(无透射)到 1(完全透射)之间。

默认值为 0.5,适用于普通晴朗的天空。

Double
用于分析的目标设备
(可选)

指定将用于执行计算的设备。

  • 先 GPU 后 CPU如果找到了兼容的 GPU,则系统会将其用于执行计算。 否则,系统将使用 CPU。 这是默认设置。
  • 仅 CPU计算将仅在 CPU 上执行。
  • 仅 GPU计算将仅在 GPU 上执行。
String
输出连接图层
(可选)

通过将输入表连接到输入要素类创建的输出图层。 此为可选输出。

Feature Layer
太阳图格网级别
(可选)

将用于生成用于内部计算的 H3 六边形格网像元的分辨率。 较低的格网级别值将创建更少的太阳图区域并减少工具运行时间。 更高的格网级别将创建更小的太阳图,从而提高结果的精度。

地球的太阳图格网级别的有效值范围为 5 到 7。 对于月球,有效值范围为 4 到 6。

默认情况下,格网级别由输入表面栅格确定。 分析地球表面数据时,如果分析像元大小小于或等于 4 米,则默认格网级别为 6。 如果分析像元大小大于 4 米,则默认格网级别为 5。 对于分析月球表面数据,默认格网级别为 6。

Long

FeatureSolarRadiation(in_surface_raster, in_features, unique_id_field, out_table, start_date_time, end_date_time, {time_zone}, {adjust_DST}, {use_time_interval}, {interval_unit}, {interval}, {feature_offset}, {feature_area}, {feature_slope}, {feature_aspect}, {neighborhood_distance}, {use_adaptive_neighborhood}, {diffuse_model_type}, {diffuse_proportion}, {transmittivity}, {analysis_target_device}, {out_join_layer}, {sunmap_grid_level})
名称说明数据类型
in_surface_raster

输入高程表面栅格。

Raster Layer
in_features

输入要素(点或面),用于表示接收到的太阳辐射量的位置或工程表面。

Feature Layer
unique_id_field

包含定义每个要素的值的字段。

该字段可以是输入要素的整型或字符串型字段。

Field
out_table

将包含接收到的太阳辐射量汇总的输出表

表的格式由输出位置和路径确定。 默认情况下,如果在地理数据库工作空间中,则输出将是一个地理数据库表;如果在文件工作空间中,则输出将为 dBASE 表。

Table
start_date_time

分析的开始日期和时间。

Date
end_date_time

分析的结束日期和时间。

Date
time_zone
(可选)

用于开始和结束时间的时区。 默认值为协调世界时间 (UTC)。

  • UTC时区将为 UTC。
  • Dateline_Standard_Time时区将为国际日期变更线标准时间 (UTC-12:00)。
  • UTC-11时区将为 UTC-11 (UTC-11:00)。
  • Aleutian_Standard_Time时区将为阿留申标准时间 (UTC-10:00)。
  • Hawaiian_Standard_Time时区将为夏威夷标准时间 (UTC-10:00)。
  • Marquesas_Standard_Time时区将为马克萨斯标准时间 (UTC-09:30)。
  • Alaskan_Standard_Time时区将为阿拉斯加标准时间 (UTC-09:00)。
  • UTC-09时区将为 UTC-09 (UTC-09:00)。
  • Pacific_Standard_Time_(Mexico)时区将为太平洋标准时间(墨西哥)(UTC-08:00)。
  • UTC-08时区将为 UTC-08 (UTC-08:00)。
  • Pacific_Standard_Time时区将为太平洋标准时间 (UTC-08:00)。
  • US_Mountain_Standard_Time时区将为美国山区标准时间 (UTC-07:00)。
  • Mountain_Standard_Time_(Mexico)时区将为山区标准时间(墨西哥)(UTC-07:00)。
  • Mountain_Standard_Time时区将为山区标准时间 (UTC-07:00)。
  • Yukon_Standard_Time时区将为育空标准时间 (UTC-07:00)。
  • Central_America_Standard_Time时区将为中美洲标准时间 (UTC-06:00)。
  • Central_Standard_Time时区将为中部标准时间 (UTC-06:00)。
  • Easter_Island_Standard_Time时区将为复活节岛标准时间 (UTC-06:00)。
  • Central_Standard_Time_(Mexico)时区将为中部标准时间(墨西哥)(UTC-06:00)。
  • Canada_Central_Standard_Time时区将为加拿大中部标准时间 (UTC-06:00)。
  • SA_Pacific_Standard_Time时区将为 SA 太平洋标准时间 (UTC-05:00)。
  • Eastern_Standard_Time_(Mexico)时区将为东部标准时间(墨西哥)(UTC-05:00)。
  • Eastern_Standard_Time时区将为东部标准时间 (UTC-05:00)。
  • Haiti_Standard_Time时区将为海地标准时间 (UTC-05:00)。
  • Cuba_Standard_Time时区将为古巴标准时间 (UTC-05:00)。
  • US_Eastern_Standard_Time时区将为美国东部标准时间 (UTC-05:00)。
  • Turks_And_Caicos_Standard_Time时区将为特克斯和凯科斯标准时间 (UTC-04:00)。
  • Paraguay_Standard_Time时区将为巴拉圭标准时间 (UTC-04:00)。
  • Atlantic_Standard_Time时区将为大西洋标准时间 (UTC-04:00)。
  • Venezuela_Standard_Time时区将为委内瑞拉标准时间 (UTC-04:00)。
  • Central_Brazilian_Standard_Time时区将为中部巴西标准时间 (UTC-04:00)。
  • SA_Western_Standard_Time时区将为 SA 西部标准时间 (UTC-04:00)。
  • Pacific_SA_Standard_Time时区将为太平洋 SA 标准时间 (UTC-04:00)。
  • Newfoundland_Standard_Time时区将为纽芬兰标准时间 (UTC-03:30)。
  • Tocantins_Standard_Time时区将为托坎廷斯标准时间 (UTC-03:00)。
  • E._South_America_Standard_Time时区将为东南美洲标准时间 (UTC-03:00)。
  • SA_Eastern_Standard_Time时区将为 SA 东部标准时间 (UTC-03:00)。
  • Argentina_Standard_Time时区将为阿根廷标准时间 (UTC-03:00)。
  • Greenland_Standard_Time时区将为格陵兰岛标准时间 (UTC-03:00)。
  • Montevideo_Standard_Time时区将为蒙得维的亚标准时间 (UTC-03:00)。
  • Magallanes_Standard_Time时区将为麦哲伦标准时间 (UTC-03:00)。
  • Saint_Pierre_Standard_Time时区将为圣皮埃尔标准时间 (UTC-03:00)。
  • Bahia_Standard_Time时区将为巴伊亚标准时间 (UTC-03:00)。
  • UTC-02时区将为 UTC-02 (UTC-02:00)。
  • Mid-Atlantic_Standard_Time时区将为中部大西洋标准时间 (UTC-02:00)。
  • Azores_Standard_Time时区将为亚速尔群岛标准时间 (UTC-01:00)。
  • Cape_Verde_Standard_Time时区将为佛得角标准时间 (UTC-01:00)。
  • GMT_Standard_Time时区将为 GMT 标准时间 (UTC+00:00)。
  • Greenwich_Standard_Time时区将为格林尼治标准时间 (UTC+00:00)。
  • Sao_Tome_Standard_Time时区将为圣多美标准时间 (UTC+00:00)。
  • Morocco_Standard_Time时区将为摩洛哥标准时间 (UTC+00:00)。
  • W._Europe_Standard_Time时区将为西欧标准时间 (UTC+01:00)。
  • Central_Europe_Standard_Time时区将为中欧标准时间 (UTC+01:00)。
  • Romance_Standard_Time时区将为罗曼标准时间 (UTC+01:00)。
  • Central_European_Standard_Time时区将为中欧标准时间 (UTC+01:00)。
  • W._Central_Africa_Standard_Time时区将为中非西部标准时间 (UTC+01:00)。
  • Jordan_Standard_Time时区将为约旦标准时间 (UTC+02:00)。
  • GTB_Standard_Time时区将为 GTB 标准时间 (UTC+02:00)。
  • Middle_East_Standard_Time时区将为中东标准时间 (UTC+02:00)。
  • Egypt_Standard_Time时区将为埃及标准时间 (UTC+02:00)。
  • E._Europe_Standard_Time时区将为东欧标准时间 (UTC+02:00)。
  • Syria_Standard_Time时区将为叙利亚标准时间 (UTC+02:00)。
  • West_Bank_Standard_Time时区将为西岸标准时间 (UTC+02:00)。
  • South_Africa_Standard_Time时区将为南非标准时间 (UTC+02:00)。
  • FLE_Standard_Time时区将为 FLE 标准时间 (UTC+02:00)。
  • Israel_Standard_Time时区将为以色列标准时间 (UTC+02:00)。
  • South_Sudan_Standard_Time时区将为南苏丹标准时间 (UTC+02:00)。
  • Kaliningrad_Standard_Time时区将为加里宁格勒标准时间 (UTC+02:00)。
  • Sudan_Standard_Time时区将为苏丹标准时间 (UTC+02:00)。
  • Libya_Standard_Time时区将为利比亚标准时间 (UTC+02:00)。
  • Namibia_Standard_Time时区将为纳米比亚标准时间 (UTC+02:00)。
  • Arabic_Standard_Time时区将为阿拉伯标准时间 (UTC+03:00)。
  • Turkey_Standard_Time时区将为土耳其标准时间 (UTC+03:00)。
  • Arab_Standard_Time时区将为阿拉伯标准时间 (UTC+03:00)。
  • Belarus_Standard_Time时区将为白俄罗斯标准时间 (UTC+03:00)。
  • Russian_Standard_Time时区将为俄罗斯标准时间 (UTC+03:00)。
  • E._Africa_Standard_Time时区将为东非标准时间 (UTC+03:00)。
  • Volgograd_Standard_Time时区将为伏尔加格勒标准时间 (UTC+03:00)。
  • Iran_Standard_Time时区将为伊朗标准时间 (UTC+03:30)。
  • Arabian_Standard_Time时区将为阿拉伯标准时间 (UTC+04:00)。
  • Astrakhan_Standard_Time时区将为阿斯特拉罕标准时间 (UTC+04:00)。
  • Azerbaijan_Standard_Time时区将为阿塞拜疆标准时间 (UTC+04:00)。
  • Russia_Time_Zone_3时区将为俄罗斯时区 3 (UTC+04:00)。
  • Mauritius_Standard_Time时区将为毛里求斯标准时间 (UTC+04:00)。
  • Saratov_Standard_Time时区将为萨拉托夫标准时间 (UTC+04:00)。
  • Georgian_Standard_Time时区将为乔治亚州标准时间 (UTC+04:00)。
  • Caucasus_Standard_Time时区将为高加索标准时间 (UTC+04:00)。
  • Afghanistan_Standard_Time时区将为阿富汗标准时间 (UTC+04:30)。
  • West_Asia_Standard_Time时区将为西亚标准时间 (UTC+05:00)。
  • Ekaterinburg_Standard_Time时区将为叶卡捷琳堡标准时间 (UTC+05:00)。
  • Pakistan_Standard_Time时区将为巴基斯坦标准时间 (UTC+05:00)。
  • Qyzylorda_Standard_Time时区将为克孜勒奥尔达标准时间 (UTC+05:00)。
  • India_Standard_Time时区将为印度标准时间 (UTC+05:30)。
  • Sri_Lanka_Standard_Time时区将为斯里兰卡标准时间 (UTC+05:30)。
  • Nepal_Standard_Time时区将为尼泊尔标准时间 (UTC+05:45)。
  • Central_Asia_Standard_Time时区将为中亚标准时间 (UTC+06:00)。
  • Bangladesh_Standard_Time时区将为孟加拉国标准时间 (UTC+06:00)。
  • Omsk_Standard_Time时区将为鄂木斯克标准时间 (UTC+06:00)。
  • Myanmar_Standard_Time时区将为缅甸标准时间 (UTC+06:30)。
  • SE_Asia_Standard_Time时区将为东南亚标准时间 (UTC+07:00)。
  • Altai_Standard_Time时区将为阿尔泰标准时间 (UTC+07:00)。
  • W._Mongolia_Standard_Time时区将为西蒙古标准时间 (UTC+07:00)。
  • North_Asia_Standard_Time时区将为北亚标准时间 (UTC+07:00)。
  • N._Central_Asia_Standard_Time时区将为中亚南部标准时间 (UTC+07:00)。
  • Tomsk_Standard_Time时区将为托木斯克标准时间 (UTC+07:00)。
  • China_Standard_Time时区将为中国标准时间 (UTC+08:00)。
  • North_Asia_East_Standard_Time时区将为北亚东部标准时间 (UTC+08:00)。
  • Singapore_Standard_Time时区将为新加坡标准时间 (UTC+08:00)。
  • W._Australia_Standard_Time时区将为西部澳大利亚标准时间 (UTC+08:00)。
  • Taipei_Standard_Time时区将为台北标准时间 (UTC+08:00)。
  • Ulaanbaatar_Standard_Time时区将为乌兰巴托标准时间 (UTC+08:00)。
  • Aus_Central_W._Standard_Time时区将为澳大利亚中西部标准时间 (UTC+08:45)。
  • Transbaikal_Standard_Time时区将为外贝加尔标准时间 (UTC+09:00)。
  • Tokyo_Standard_Time时区将为东京标准时间 (UTC+09:00)。
  • North_Korea_Standard_Time时区将为朝鲜标准时间 (UTC+09:00)。
  • Korea_Standard_Time时区将为韩国标准时间 (UTC+09:00)。
  • Yakutsk_Standard_Time时区将为雅库茨克标准时间 (UTC+09:00)。
  • Cen._Australia_Standard_Time时区将为中部。 澳大利亚标准时间 (UTC+09:30)。
  • AUS_Central_Standard_Time时区将为澳大利亚中部标准时间 (UTC+09:30)。
  • E._Australia_Standard_Time时区将为东部澳大利亚标准时间 (UTC+10:00)。
  • AUS_Eastern_Standard_Time时区将为澳大利亚东部标准时间 (UTC+10:00)。
  • West_Pacific_Standard_Time时区将为西太平洋标准时间 (UTC+10:00)。
  • Tasmania_Standard_Time时区将为塔斯马尼亚标准时间 (UTC+10:00)。
  • Vladivostok_Standard_Time时区将为符拉迪沃斯托克标准时间 (UTC+10:00)。
  • Lord_Howe_Standard_Time时区将为豪勋爵标准时间 (UTC+10:30)。
  • Bougainville_Standard_Time时区将为布干维尔标准时间 (UTC+11:00)。
  • Russia_Time_Zone_10时区将为俄罗斯时区 10 (UTC+11:00)。
  • Magadan_Standard_Time时区将为马加丹标准时间 (UTC+11:00)。
  • Norfolk_Standard_Time时区将为诺福克标准时间 (UTC+11:00)。
  • Sakhalin_Standard_Time时区将为萨哈林标准时间 (UTC+11:00)。
  • Central_Pacific_Standard_Time时区将为中太平洋标准时间 (UTC+11:00)。
  • Russia_Time_Zone_11时区将为俄罗斯时区 11 (UTC+11:00)。
  • New_Zealand_Standard_Time时区将为新西兰标准时间 (UTC+12:00)。
  • UTC+12时区将为 UTC+12 (UTC+12:00)。
  • Fiji_Standard_Time时区将为斐济标准时间 (UTC+12:00)。
  • Kamchatka_Standard_Time时区将为堪察加标准时间 (UTC+12:00)。
  • Chatham_Islands_Standard_Time时区将为查塔姆群岛标准时间 (UTC+12:45)。
  • UTC+13时区将为 UTC+13 (UTC+13:00)。
  • Tonga_Standard_Time时区将为东加群岛标准时间 (UTC+13:00)。
  • Samoa_Standard_Time时区将为萨摩亚标准时间 (UTC+13:00)。
  • Line_Islands_Standard_Time时区将为莱恩群岛标准时间 (UTC+14:00)。
String
adjust_DST
(可选)

指定是否将输入时间配置调整为夏令时。

此参数不适用于月球上的分析。

  • NOT_ADJUSTED_FOR_DST不会按夏令时调整输入时间值。 这是默认设置。
  • ADJUSTED_FOR_DST将按夏令时调整输入时间值。
Boolean
use_time_interval
(可选)

指定是否对整个时间配置计算单一总日射值,还是对指定间隔计算多个辐射值。

  • NO_INTERVAL针对整个时间配置计算一个辐射值。 这是默认设置。
  • INTERVAL针对整个时间配置中的各时间间隔计算多个辐射值。
Boolean
interval_unit
(可选)

指定用于计算整个时间配置的太阳辐射值的时间单位。

仅当 use_time_interval 参数设置为 INTERVAL 时,系统才支持此参数。

  • MINUTE间隔单位将为分钟。 此选项仅适用于基于地球的数据。
  • HOUR间隔单位将为小时。
  • DAY间隔单位将为天。 这是默认设置
  • WEEK间隔单位将为周。
String
interval
(可选)

持续时间或间隔之间的时间值。

默认值取决于指定的间隔单位。 每个可用单位的默认值如下所示。

  • MINUTE - 60
  • HOUR - 4
  • DAY - 14
  • WEEK - 2
Long
feature_offset
(可选)

将添加到栅格表面上的用于分析的垂直距离。 它必须为正整数值或浮点值。

可以从输入要素数据集中选择一个字段,或者可以提供一个数值。

例如,如果对象是一个面板,则需提供面板的高度。

如果为此参数提供了一个值,则所有要素都将使用该值。 要为每个单独要素指定不同的值,请从输入要素数据集中选择一个字段。

默认值为 0。

Double; Field
feature_area
(可选)

与输入要素相关联的面积。 它必须为正整数值或浮点值。

可以从输入要素数据集中选择一个字段,或者可以提供一个数值。

例如,如果对象是一个面板,则需提供面板的面积。

如果为此参数提供了一个值,则所有要素都将使用该值。 要为每个单独要素指定不同的值,请从输入要素数据集中选择一个字段。

默认情况下,面积根据输入要素获取。 默认情况下,点要素的面积为 0。

Double; Field
feature_slope
(可选)

与输入要素相关联的相对坡度或倾斜度。 它必须为正整数值或浮点值。

可以从输入要素数据集中选择一个字段,或者可以提供一个数值。

例如,如果对象是一个面板,则需提供面板的倾斜度。

如果为此参数提供了一个值,则所有要素都将使用该值。 要为每个单独要素指定不同的值,请从输入要素数据集中选择一个字段。

坡度以 0 到 90 度的角度表示。 分析的默认值是根据输入表面栅格的基本值计算的。

Double; Field
feature_aspect
(可选)

与输入要素相关联的相对破向或方向。 它必须为正整数值或浮点值。

可以从输入要素数据集中选择一个字段,或者可以提供一个数值。

例如,如果对象是一个面板,则需提供面板面的方向。

如果为此参数提供了一个值,则所有要素都将使用该值。 要为每个单独要素指定不同的值,请从输入要素数据集中选择一个字段。

坡向由 0 到 360 度之间的度数表示。 分析的默认值是根据输入表面栅格的基本值计算的。

Double; Field
neighborhood_distance
(可选)

与目标像元中心的距离,将根据此目标像元计算输出间隔值。 可确定邻域大小。

默认值为输入表面栅格像元大小,可生成 3 x 3 邻域。

Linear Unit
use_adaptive_neighborhood
(可选)

指定邻域距离是否随地表变化而变化(自适应)。 最大距离由邻域距离确定。 最小距离为输入栅格像元大小。

  • FIXED_NEIGHBORHOOD将在所有位置使用单一(固定)邻域距离。 这是默认设置。
  • ADAPTIVE_NEIGHBORHOOD将在所有位置使用自适应邻域距离。
Boolean
diffuse_model_type
(可选)

指定将使用的散射辐射模型的类型。

  • UNIFORM_SKY将使用均匀散射模型。 所有天空方向的入射散射辐射均相同。 这是默认设置。
  • STANDARD_OVERCAST_SKY将使用标准阴天散射模型。 入射散射辐射通量随天顶角而变化。
String
diffuse_proportion
(可选)

散射的总正常辐射通量的比例。 值的范围介于 0 到 1 之间。

根据大气条件设置该值。 默认值为 0.3,适用于普通晴朗的天空条件。

Double
transmittivity
(可选)

穿过大气层的辐射部分(所有波长的平均值)。 值的范围介于 0(无透射)到 1(完全透射)之间。

默认值为 0.5,适用于普通晴朗的天空。

Double
analysis_target_device
(可选)

指定将用于执行计算的设备。

  • GPU_THEN_CPU如果找到了兼容的 GPU,则系统会将其用于执行计算。 否则,系统将使用 CPU。 这是默认设置。
  • CPU_ONLY计算将仅在 CPU 上执行。
  • GPU_ONLY计算将仅在 GPU 上执行。
String
out_join_layer
(可选)

通过将输入表连接到输入要素类创建的输出图层。 此为可选输出。

Feature Layer
sunmap_grid_level
(可选)

将用于生成用于内部计算的 H3 六边形格网像元的分辨率。 较低的格网级别值将创建更少的太阳图区域并减少工具运行时间。 更高的格网级别将创建更小的太阳图,从而提高结果的精度。

地球的太阳图格网级别的有效值范围为 5 到 7。 对于月球,有效值范围为 4 到 6。

默认情况下,格网级别由输入表面栅格确定。 分析地球表面数据时,如果分析像元大小小于或等于 4 米,则默认格网级别为 6。 如果分析像元大小大于 4 米,则默认格网级别为 5。 对于分析月球表面数据,默认格网级别为 6。

Long

代码示例

FeatureSolarRadiation 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何使用 FeatureSolarRadiation 函数。

import arcpy
from arcpy.sa import *
from arcpy import env
env.workspace = "C:/sapyexamples/solardata.gdb"
env.scratchWorkspace = "C:/sapyexamples/outfile.gdb"
#Run FeatureSolarRadiation
arcpy.sa.FeatureSolarRadiation("dem30m.tif","solar_pnts","pntID","SolarPnts_radiation_092023",
                               "9/1/2023 06:30:00 AM","10/1/2023 6:30:00 PM","Pacific_Standard_Time")
FeatureSolarRadiation 示例 2(独立脚本)

计算 2023 年整年点要素表示的工程要素每周间隔的太阳辐射量。

# Name: FeatureSolarRadiation_standalone.py
# Description: Calculate the solar insolation for the whole year 2023 at one week 
#               intervals for engineered features represented by point features.
# Requirements: Spatial Analyst Extension

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

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/solardata.gdb"
arcpy.env.scratchWorkspace = "C:/sapyexamples/outfile.gdb"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Run FeatureSolarRadiation
arcpy.sa.FeatureSolarRadiation(
    in_surface_raster="dem30m.tif",
    in_features="solar_pnts",
    unique_id_field="pntID",
    out_table=r"SolarPnts_radiation_092023",
    start_date_time="1/1/2023",
    end_date_time="12/31/2023",
    time_zone="Mountain_Standard_Time",
    adjust_DST="ADJUSTED_FOR_DST",
    use_time_interval="NO_INTERVAL",
    interval_unit="WEEK",
    interval=1,
    feature_offset=2.5,
    feature_area="Area_FLD",
    feature_slope="Slope_FLD",
    feature_aspect="Aspect_FLD",
    neighborhood_distance="",
    use_adaptive_neighborhood="",
    diffuse_model_type="UNIFORM_SKY",
    diffuse_proportion=0.3,
    transmittivity=0.5,
    analysis_target_device="GPU_THEN_CPU",
    out_join_layer=None
)

许可信息

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

相关主题