bsrn.utils.clear_sky_detection.lefevre_csd#

bsrn.utils.clear_sky_detection.lefevre_csd(ghi, dhi, ghi_extra, zenith, times=None, return_diagnostics=False)[source]#

Lefevre2013 clear-sky detection. Lefevre2013 晴空检测 [1]。

MATLAB mapping: Lefevre2013CSD(ghi, dif, exth, zen, plot_figure). MATLAB 变量映射：dif -> dhi, exth -> ghi_extra, zen -> zenith。

Parameters:

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

  • dhi (array-like) – Diffuse horizontal irradiance (dif -> dhi). [W/m^2] 水平散射辐照度 (dif -> dhi)。[瓦/平方米]

  • ghi_extra (array-like) – Horizontal extraterrestrial irradiance (exth -> ghi_extra). [W/m^2] 地外水平辐照度 (exth -> ghi_extra)。[瓦/平方米]

  • zenith (array-like) – Solar zenith angle (zen -> zenith). [degrees] 太阳天顶角 (zen -> zenith)。[度]

  • times (array-like or pd.DatetimeIndex, optional) – Time index for outputs. 输出时间索引。

  • return_diagnostics (bool, default False) – If True, include method diagnostics. 若为 True，返回方法诊断量。

Returns:

out – Standardized output with is_clearsky, cloud_flag, and optional diagnostics. 标准化输出，含 is_clearsky、cloud_flag 及可选诊断量。

Return type:

pd.DataFrame

Raises:

ValueError – When input lengths do not match. 输入长度不一致时。

References