bsrn.utils.calculations.calc_kd#

bsrn.utils.calculations.calc_kd(dhi, zenith, bni_extra, min_mu0=0.065, max_diffuse_transmittance=2.0)[source]#

Calculates diffuse transmittance ($k_d$) following pvlib conventions [1] [2]. 按照 pvlib 惯例计算散射透射率 ($k_d$)。

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

Parameters:

dhi (numeric or Series) – Measured diffuse horizontal irradiance ($D_h$). [W/m^2] 测量的水平散射辐照度 ($D_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_diffuse_transmittance (float, default 2.0) – Upper clamp for $k_d$; 2.0 allows sub-hourly over-irradiance. $k_d$ 的上限；2.0 允许亚小时尺度的超辐照事件。

Returns:

kd – Diffuse transmittance ($k_d$), clamped to [0, max_diffuse_transmittance]. [unitless] 散射透射率 ($k_d$)，限制在 [0, max_diffuse_transmittance]。[无单位]

Return type:

numeric or Series

References