bsrn.utils.calculations.calc_kt#

bsrn.utils.calculations.calc_kt(ghi, zenith, bni_extra, min_mu0=0.065, max_clearness_index=2.0)[source]#

Calculates clearness index ($k_t$) following pvlib conventions [1] [2] [3]. 按照 pvlib 惯例计算晴朗指数 ($k_t$)。

$k_t = G_h / (E_{0n} cdot max(mu_0,; text{min_mu0}))$

Parameters:

  • ghi (numeric or Series) – Measured global horizontal irradiance ($G_h$). [W/m^2] 测量的水平总辐照度 ($G_h$)。[瓦/平方米]

  • zenith (numeric or Series) – True (not refraction-corrected) solar zenith angle ($Z$). [degrees] 真实（未经折射修正）太阳天顶角 ($Z$)。[度]

  • bni_extra (numeric or Series) – Extraterrestrial beam normal irradiance ($E_{0n}$). [W/m^2] 地外法向辐照度 ($E_{0n}$)。[瓦/平方米]

  • min_mu0 (float, default 0.065) – Minimum $mu_0$ for the denominator (equiv. ~86.3 deg). 分母中 $mu_0$ 的最小值（相当于 ~86.3 度）。

  • max_clearness_index (float, default 2.0) – Upper clamp for $k_t$; 2.0 allows sub-hourly over-irradiance. $k_t$ 的上限；2.0 允许亚小时尺度的超辐照事件。

Returns:

kt – Clearness index ($k_t$), clamped to [0, max_clearness_index]. [unitless] 晴朗指数 ($k_t$)，限制在 [0, max_clearness_index]。[无单位]

Return type:

numeric or Series

References