Transpiration
- NoahCanopyResistance
model
land_surface
noah
Canopy (bulk stomatal) resistance of WRF's unified Noah land-surface model, SUBROUTINE CANRES of phys/module_sf_noahlsm.F (WRF 4.8, sf_surface_physics = 2), and the plant coefficient pc it is converted into. Jarvis (1976) multiplicative stress form as implemented by Chen et al. (1996): rc = rsmin / (xlai rcs rct rcq rcsoil), with four independent stress factors, each floored -- rcs from incoming solar radiation, rct from air temperature about the optimum topt, rcq from the vapour-pressure deficit at the lowest model level, and rcsoil from root-zone soil moisture. The soil-moisture factor is written here as what the Fortran loop computes: rcsoil = (1/z_root) integral of the layer stress gx over the root zone, gx = clamp((sh2o - smcwlt)/(smcref - smcwlt), 0, 1), i.e. a THICKNESS-WEIGHTED MEAN of the layer stress over the root depth (the Fortran's PART(k) = (zsoil(k)-zsoil(k-1))/zsoil(nroot) gx(k) is dz[k]/z_root gx[k] because WRF's zsoil is negative downward). The integral runs over the whole soil column with the sub-root layers masked out by zc < z_root; a layer centre never coincides with z_root, which is by construction a layer interface, so the mask selects exactly the Fortran's layers 1..nroot. The plant coefficient pc converts rc into the factor that multiplies the LINEARISED Penman potential evaporation to give Penman-Monteith actual transpiration: pc = (rr + delta)/(rr (1 + rc ch) + delta), where rr is the radiative-plus-aerodynamic resistance ratio and delta = (slv/cp) dqsdt2 the saturation-humidity slope in the same units. Frozen-ground extension: WRF passes UNFROZEN soil water sh2o, not total smc, into this routine -- the `SMC` dummy argument of CANRES is bound to SH2O at the call site -- so the component's column input is named sh2o. GATING. SFLX calls CANRES only 'IF ((SHDFAC > 0.) .AND. (XLAI > 0.))' (module_sf_noahlsm.F:749) and otherwise sets rc = 0; this component reproduces that through `canres_called` and its new `shdfac` input, so a bare cell (shdfac = 0, e.g. the BARE category REDPRM zeroes) gives rc = 0 and finite zeros elsewhere instead of the NaN that xlai = 0 or z_root = 0 would put into rcs, rcsoil and rc. The denominators inside the active branch are guarded as well (xlai, and z_root for a vegetation type with no root layers), because an ifelse evaluates both branches. The `rr` here is CANRES's own, built from cp = 1004.5 (module_model_constants) and Noah's rd = 287.04 and sigma = 5.67e-8; it is NOT the `rr` of SUBROUTINE PENMAN, which is a different expression built from PENMAN's own cp = 1004.6 (FORTRAN_BUGS N88). Consumer-supplied column fields (ze, sh2o) are rewrite-target ops `input_<name>` lowered by the consumer, in the inline tests through per-test expression_template_imports libraries generated by tools/fill_tests.py.
- NoahEvapotranspiration
model
land_surface
noah
Partition of Noah's potential evaporation into its three actual components -- direct soil evaporation, canopy transpiration and evaporation of intercepted canopy water -- SUBROUTINES EVAPO, DEVAP and TRANSP of phys/module_sf_noahlsm.F (WRF 4.8, sf_surface_physics = 2), as called by NOPAC for snow-free ground. Direct soil evaporation edir = fx (1 - shdfac) etp, with the bare-soil efficiency fx = clamp(((smc[1] - smcdry)/(smcmax - smcdry))^fxexp, 0, 1) evaluated on TOTAL top-layer soil moisture. Canopy evaporation ec = shdfac (cmc/cmcmax)^cfactr etp drains intercepted water at the potential rate weighted by the canopy wetness fraction. Transpiration takes what is left of the canopy's share, etp1a = shdfac pc etp (1 - (cmc/cmcmax)^cfactr), and distributes it over the root zone by the Noah root-weighting rule: each root layer's share is gx max(rtdis + gx - sgx, 0), normalised to sum to one, where gx is the layer's moisture stress on UNFROZEN water, rtdis = dz/z_root its thickness fraction of the root zone and sgx the UNWEIGHTED ARITHMETIC MEAN of gx over the root layers. That mean is a per-layer count, not a depth average, and it is what makes the rule redistribute water towards layers that are wetter than the root-zone average; it is written here as the column integral of gx/dz over the masked root zone divided by nroot, which is identically the Fortran's sum over layers 1..nroot. Two quantities are evaluated on DIFFERENT moisture variables and the difference is deliberate in WRF: DEVAP reads total soil moisture smc, TRANSP reads unfrozen soil water sh2o. The canopy-drain limiter ec <= cmc/dt_canopy is a finite-sub-step clip on an otherwise continuous rate, so dt_canopy is A PARAMETER OF THE TENDENCY and not the integrator's step; it is inactive at every state of the reference set (cmc/dt is 2e4 W/m^2 against an ec of at most 121 W/m^2 there), so the tests pin the unclipped branch only and the clipped branch is untested. GATING. EVAPO calls TRANSP only 'IF (SHDFAC > 0.0)' (module_sf_noahlsm.F:1392), and a vegetation type with no root layers (nroot = 0) gives TRANSP empty loops; both must come out as ett = 0, not as the 0 x NaN an ungated 1/nroot or dz/z_root would produce. etp1a and ec are already zero for shdfac = 0, so it is enough that sgx divides by max(nroot, 1) and rtdis is zero for z_root = 0: every gxs is then zero, denom falls back to 1, and et = ett = 0 exactly. When etp <= 0 the whole routine is skipped and WRF reports dew instead: eta = etp, beta = 1 for etp < 0 and beta = 0 for etp = 0, which this component reproduces so that the dew branch is not a silent hole. Consumer-supplied column fields (ze, smc, sh2o) are rewrite-target ops `input_<name>` lowered by the consumer, in the inline tests through per-test expression_template_imports libraries generated by tools/fill_tests.py.