Skip to main content

TimeWithinDay

汇总

定义一天内的时间段以进行太阳能计算。指定儒略日、起始时间和结束时间。

讨论

此对象可用于以下工具： 太阳辐射区域 、 太阳辐射点 和 太阳辐射图 。

当 startTime 和 结束时间 相同时，将计算瞬时日照。当 startTime 在日出前而 endTime 在日出后时，将计算全天日照。

对于“日内”时间配置，最大时间范围为一天（24 小时）。计算不会跨天执行（例如，从 12:00 p.m. 到第二天的 12:00 p.m.）。 startTime 必须小于 endTime 。

对于日内时间配置，开始和结束时间均显示为太阳时（单位：十进制小时）。将本地标准时转换成太阳时时，此程序会考虑均时差。

语法

TimeWithinDay({day}, {startTime}, {endTime})

名称 说明 数据类型

day

（可选）

day 是从 1 到 365 的儒略日值。

(默认值为 183)

Long

startTime

（可选）

startTime 是分析中要使用的第一个小时。该小时以 0 到 24 的数字表示。

(默认值为 0)

Double

endTime

（可选）

endTime 是分析中要使用的最后一个小时。该小时以 0 到 24 的数字表示。

(默认值为 24)

Double

属性

名称 说明 数据类型

day

（读取和写入）

天 是从 1 到 365 的儒略日值。

Long

startTime

（读取和写入）

startTime 是分析中要使用的第一个小时。该小时以 0 到 24 的数字表示。

Double

endTime

（读取和写入）

endTime 是分析中要使用的最后一个小时。该小时以 0 到 24 的数字表示。

Double

代码示例

TimeWithinDay 示例 1（Python 窗口）

演示如何创建 TimeWithinDay 类以及如何在 Python 窗口的 AreaSolarRadiation 工具中使用该类。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myTimeWithinDay = TimeWithinDay(264, 11, 14)
outAreaSolar = AreaSolarRadiation("solar_dem", "", "", myTimeWithinDay)
outAreaSolar.save("C:/sapyexamples/output/areasolartwd")
TimeWithinDay 示例 2（独立脚本）

通过 AreaSolarRadiation 工具使用 TimeWithinDay 类计算入射太阳辐射。

# Name: TimeWithinDay_Ex_02.py
# Description: Run AreaSolarRadiation using the TimeWithinDay object
# 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 = "solar_dem"

# Create TimeWithinDay Object
day = 100
startTime = 0
endTime = 24
myTimeWithinDay = TimeWithinDay(day, startTime, endTime)

# Run AreaSolarRadiation
outAreaSolar = AreaSolarRadiation(inRaster, "", 200, myTimeWithinDay, 14, 0.5,
                                  "NOINTERVAL", 1, "FROM_DEM", 32, 8, 8,
                                  "UNIFORM_SKY", 0.3, 0.5)

# Save the output
outAreaSolar.save("C:/sapyexamples/output/areasolartwd2")