bsrn.utils.cee_detection.yang_ced#

bsrn.utils.cee_detection.yang_ced(ghi, ghi_clear, zenith, times)[source]#

Detect cloud enhancement events using Yang et al. (2018) [1].

Parameters:

  • ghi (array-like) – 1‑minute global horizontal irradiance. [W/m^2]

  • ghi_clear (array-like) – 1‑minute clear-sky global horizontal irradiance. [W/m^2]

  • zenith (array-like) – 1‑minute solar zenith angle. [degrees]

  • times (pandas.DatetimeIndex or array-like) – 1‑minute timestamps convertible to DatetimeIndex.

Returns:

out – DataFrame indexed by aggregated timestamps (e.g. 6‑minute) with:

  • is_enhancement – True where a cloud enhancement is detected.

  • ced_flag – 1 for enhancement, 0 otherwise, NaN when invalid.

Return type:

pandas.DataFrame

References