Richards-Equation
- NoahSoilMoisture
model
land_surface
noah
Soil water transport of WRF's unified Noah land-surface model as instantaneous tendencies: SUBROUTINES SMFLX, SRT and WDFCND of phys/module_sf_noahlsm.F (WRF 4.8, sf_surface_physics = 2), together with the canopy-interception budget and the three runoff terms. THE PDE is Richards' equation in mixed diffusivity/conductivity form, d(theta)/dt = d/dz( D(theta) d(theta)/dz - K(theta) ) - S, with Clapp-Hornberger closures D = dwsat (theta/smcmax)^(bexp+2) and K = dksat (theta/smcmax)^(2 bexp+3). It is written as the flux-form operator D(K_w D(sh2o) - F_w) and lowered by the SAME EarthSciDiscretizations rule the soil heat equation uses, column_nonuniform_1d/rules/varcoeff_face_flux_laplacian_lev -- NO NEW ESD RULE WAS NEEDED. That works because WRF evaluates the gravity drainage K(theta) UPWIND, at the layer above each interface, so from the operator's point of view it is a PRESCRIBED interface flux and drops straight into the rule's F slot; a scheme that averaged K across the face would not fit and would have needed a new rule. The same upwinding applies to the diffusivity (FORTRAN_BUGS N90, as in the heat equation). Orientation and geometry follow soil_heat.esm: `lev` is the soil layer index with layer 1 at the surface and `ze` the interface DEPTH below ground, positive downward. BOUNDARY FLUXES. The surface interface carries the infiltration pddum, and the bottom interface the free drainage slope wcnd[NLEV], which IS the subsurface runoff; both are prescribed, so the diffusive part at the two domain faces is correctly dropped. SINKS are the bare-soil evaporation, which withdraws from layer 1 only, and the per-layer transpiration. THE INFILTRATION LIMITER has a clean dt -> 0 limit that is not obvious from the Fortran: WRF forms infmax = px (ddt/(px + ddt))/dt with px = pcpdrp dt and ddt = dd (1 - exp(-kdt dt/86400)), and BOTH numerator terms are proportional to dt, so the limit is the harmonic-style combination pcpdrp r/(pcpdrp + r) with r = dd kdt/86400 a rate. dd is the column-integrated storage deficit, written here as an integral. The limiter is then floored at the surface conductivity and capped at the supply, and whatever the soil cannot take becomes surface runoff. DEW IS ROUTED LIKE RAIN: where the potential evaporation is negative the surface gains water, and NOPAC adds that gain to the precipitation before the canopy/throughfall split, so a dew step has a small positive canopy tendency and a small positive infiltration even with no precipitation at all. THE CANOPY is a reservoir of capacity cmcmax fed by shdfac prcp and drained by ec; what it cannot hold becomes drip, which joins the throughfall. In the dt -> 0 limit WRF's drip = max(cmc + dt rhsct - cmcmax, 0) becomes a SWITCH: zero while the canopy has room, and the whole net input once it is full, at which point dcmc_dt is zero. The reference set contains a step with the canopy exactly full and raining, so that branch is exercised. NOT TRANSCRIBED, and a consumer must not mount this where they matter: (a) SSTEP's supersaturation redistribution, which cascades water upward out of any layer driven past smcmax and reports the leftover as runoff3 -- that is a PROJECTION of the state applied after an integration step, not a rate, exactly like the slab scheme's snow cap, so it is reported as the indicator supersaturation_active instead; (b) the SMFLX predictor-corrector, which runs SRT/SSTEP twice on a half-updated column when the rainfall is heavy or the soil near saturation -- it is a finite-dt integration device and both branches converge to the SAME right-hand side as dt -> 0, so it does not affect this component, but it also means the corrector path is untested; (c) the frozen-ground infiltration reduction fcr, which IS written here because it is a clean closed form, but which the reference set never exercises (no soil ice anywhere), so it is UNTESTED rather than merely unused, as is every appearance of sice; (d) the WRF_HYDRO surface-head coupling. Consumer-supplied column fields (ze, sh2o, smc, et) 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.