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.

Caller must provide clear-sky GHI (e.g. from a clear-sky model or 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.

  • 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).

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.

References