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]. 使用 Yang 等 (2018) 方法检测云增强事件。

Parameters:

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

  • ghi_clear (array-like) – 1‑minute clear-sky global horizontal irradiance. [W/m^2] 1 分钟晴空水平总辐照度。[瓦/平方米]

  • zenith (array-like) – 1‑minute solar zenith angle. [degrees] 1 分钟太阳天顶角。[度]

  • times (pandas.DatetimeIndex or array-like) – 1‑minute timestamps convertible to DatetimeIndex. 可转换为 DatetimeIndex 的 1 分钟时间戳。

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.

以聚合时间戳（如 6 分钟）为索引的 DataFrame，包含：

  • is_enhancement – 检测到云增强时为 True。

  • ced_flag – 1 表示云增强，0 表示非增强，无效为 NaN。

Return type:

pandas.DataFrame

References