bsrn.modeling.separation.engerer2_separation#

bsrn.modeling.separation.engerer2_separation(times, ghi, lat, lon, ghi_clear, averaging_period=1)[source]#

Engerer2 irradiance separation: estimate diffuse fraction ($k$), DHI and BNI from GHI. Engerer2 辐照分离：由 GHI 估算散射分数 ($k$)、DHI 与 BNI。

Caller must provide clear-sky GHI (e.g. from a clear-sky model or add_clearsky_columns). 调用方必须提供晴空 GHI（例如由晴空模型或 add_clearsky_columns 得到）。

Parameters:

  • times (pd.DatetimeIndex) – Timestamps. 时间戳。

  • ghi (array-like) – Global horizontal irradiance. [W/m^2] 水平总辐照度。[瓦/平方米]

  • lat (float) – Latitude. [degrees] 纬度。[度]

  • lon (float) – Longitude. [degrees] 经度。[度]

  • ghi_clear (array-like) – Clear-sky GHI. [W/m^2] Same length as times. Required. 晴空 GHI。[瓦/平方米] 与 times 等长。必填。

  • averaging_period (int, default 1) – Coefficient set for resolution. [minutes] 1, 5, 10, 15, 30, 60, or 1440. 对应分辨率的系数集。[分钟]

Returns:

out – DataFrame with index=times and columns k, dhi, bni (modeled). 索引为 times、列为 k/dhi/bni（模型结果）的 DataFrame。

Return type:

pd.DataFrame

Raises:

ValueError – If averaging_period is not in the supported set, times is not a DatetimeIndex, or ghi / ghi_clear lengths mismatch. averaging_period 不在支持集合、times 非 DatetimeIndex 或 ghi/ghi_clear 长度不一致时。

References