ERF RRTMGP-LSM Coupling Findings
This note summarizes issues found in the coupling between ERF's RRTMGP radiation interface and the land-surface-model exchange, compared against WRF.
Main Findings
1. Non-positive LSM inputs are treated as invalid in ERF
In ERF, the radiation wrapper only accepts an LSM-provided surface field if the value is strictly positive:
t_sfc
sfc_emis
sfc_alb_dir_vis
sfc_alb_dir_nir
sfc_alb_dif_vis
sfc_alb_dif_nir
Code:
Relevant logic:
bool valid_lsm_data{false};
if (lsm_in_arr) { valid_lsm_data = (lsm_in_arr(i,j,k) > 0.); }
This is problematic for albedo in particular, because a valid 0.0 value is silently replaced by the ERF default 0.06.
WRF does not apply this filter. It passes the surface quantities directly through the surface driver into the LSM.
Relevant WRF call:
2. ERF only uses LSM surface properties over land
ERF only uses LSM-provided t_sfc, emissivity, and albedos when lmask says the point is land. Otherwise it falls back to hard-coded defaults:
t_sfc = rad_t_sfc
sfc_emis = 0.98
albedos = 0.06
Code:
This differs from WRF, where surface optical and thermal properties are coupled across all surface types, including water and fractional sea ice, with explicit blending logic in the surface driver.
Relevant WRF logic:
3. ERF Noah-MP receives only total downward shortwave
ERF Noah-MP reads:
from the shared LSM state:
WRF Noah-MP receives:
SWDOWN
SWDDIR
SWDDIF
GLW
COSZEN
through the WRF surface driver:
ERF radiation does compute directional and diffuse surface shortwave components and writes them into m_lsm_fluxes, but those fields are not the generic lsm_output_ptrs used by ERF Noah-MP. Relative to WRF, this is a reduced coupling.
4. Longwave downward flux semantics look consistent
ERF exports surface lw_flux_dn directly to the LSM coupling field. WRF Noah/Noah-MP expects GLW as downward atmospheric longwave and multiplies by surface emissivity internally.
ERF side:
WRF side:
So this part of the coupling appears consistent.
Bottom Line
The main ERF-vs-WRF coupling concerns are:
- ERF rejects non-positive LSM input values and silently substitutes defaults.
- ERF effectively limits LSM-provided surface optical properties to land points only.
- ERF Noah-MP does not receive the direct/diffuse shortwave decomposition that WRF Noah-MP receives.
The LW downward-flux handoff itself appears consistent with WRF.
ERF RRTMGP-LSM Coupling Findings
This note summarizes issues found in the coupling between ERF's RRTMGP radiation interface and the land-surface-model exchange, compared against WRF.
Main Findings
1. Non-positive LSM inputs are treated as invalid in ERF
In ERF, the radiation wrapper only accepts an LSM-provided surface field if the value is strictly positive:
t_sfcsfc_emissfc_alb_dir_vissfc_alb_dir_nirsfc_alb_dif_vissfc_alb_dif_nirCode:
Relevant logic:
This is problematic for albedo in particular, because a valid
0.0value is silently replaced by the ERF default0.06.WRF does not apply this filter. It passes the surface quantities directly through the surface driver into the LSM.
Relevant WRF call:
2. ERF only uses LSM surface properties over land
ERF only uses LSM-provided
t_sfc, emissivity, and albedos whenlmasksays the point is land. Otherwise it falls back to hard-coded defaults:t_sfc = rad_t_sfcsfc_emis = 0.98albedos = 0.06Code:
This differs from WRF, where surface optical and thermal properties are coupled across all surface types, including water and fractional sea ice, with explicit blending logic in the surface driver.
Relevant WRF logic:
3. ERF Noah-MP receives only total downward shortwave
ERF Noah-MP reads:
SWDOWNGLWCOSZENfrom the shared LSM state:
WRF Noah-MP receives:
SWDOWNSWDDIRSWDDIFGLWCOSZENthrough the WRF surface driver:
ERF radiation does compute directional and diffuse surface shortwave components and writes them into
m_lsm_fluxes, but those fields are not the genericlsm_output_ptrsused by ERF Noah-MP. Relative to WRF, this is a reduced coupling.4. Longwave downward flux semantics look consistent
ERF exports surface
lw_flux_dndirectly to the LSM coupling field. WRF Noah/Noah-MP expectsGLWas downward atmospheric longwave and multiplies by surface emissivity internally.ERF side:
WRF side:
So this part of the coupling appears consistent.
Bottom Line
The main ERF-vs-WRF coupling concerns are:
The LW downward-flux handoff itself appears consistent with WRF.