bsrn.utils.clear_sky_detection.ineichen_csd#

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

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

MATLAB mapping: Ineichen2009CSD(ghi, exth, zen, plot_figure). MATLAB 变量映射：exth -> ghi_extra, zen -> zenith。 Convention: MATLAB csd(kt_prime<0.65)=1 marks low clearness (cloudy); here cloud_flag 0=clear, 1=cloudy, so cloud_flag=1 where kt_prime<0.65.

Parameters:

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

  • 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