Skip to content

fix units of evaporation for imp_scheme==2 in slucm#2227

Merged
weiwangncar merged 1 commit intowrf-model:release-v4.7.1from
einaraz:fix_evap_units_slucm
May 30, 2025
Merged

fix units of evaporation for imp_scheme==2 in slucm#2227
weiwangncar merged 1 commit intowrf-model:release-v4.7.1from
einaraz:fix_evap_units_slucm

Conversation

@einaraz
Copy link
Contributor

@einaraz einaraz commented May 27, 2025

Fix the conversion of kinematic water vapor flux to evaporation in m/s for water budget in slucm

TYPE: bug fix

KEYWORDS: slucm, urban evaporation, urban physics

SOURCE: Einara Zahn, Princeton University

DESCRIPTION OF CHANGES:
Problem:
Evaporation rate over impervious surfaces was incorrectly computed in SLUCM for option IMP_SCHEME==2. The kinematic vapor flux (kg/kg x m/s) was not converted to evaporation in m/s before entering the water budget equation, leading to wrong update of water storage.

Solution:
Multiplied the kinematic water vapor flux by air density and divided by water density in module_sf_urban.f90, only inside the code block for IMP_SCHEME == 2. The conversion does not affect the default version IMP_SCHEME==1.

ISSUE: For use when this PR closes an issue.
Fixes #2186

LIST OF MODIFIED FILES: phys/module_sf_urban.F

TESTS CONDUCTED:

  1. Running urban simulations on rainy days, with and without the unit conversion.
  2. Jenkins tests have passed.

RELEASE NOTE: Corrected evaporation rate calculation for water budget over impervious surfaces in SLUCM when IMP_SCHEME == 2. Affects available water in impervious surfaces and latent heat flux output in urban simulations with impervious scheme enabled.

@einaraz einaraz requested a review from a team as a code owner May 27, 2025 22:11
@weiwangncar
Copy link
Collaborator

The regression test results:

Test Type              | Expected  | Received |  Failed
= = = = = = = = = = = = = = = = = = = = = = = =  = = = =
Number of Tests        : 23           24
Number of Builds       : 60           57
Number of Simulations  : 158           150        0
Number of Comparisons  : 95           86        0

Failed Simulations are: 
None
Which comparisons are not bit-for-bit: 
None

@weiwangncar
Copy link
Collaborator

@cenlinhe Can you review this PR? Thanks!

@cenlinhe
Copy link
Contributor

cenlinhe commented May 30, 2025

@einaraz Do we also need to correct the unit for FLXHUMB, FLXHUMG, and FLXHUMR? Looks like these three quantities also have the units of kg/kg * m/s instead of m/s.

@cenlinhe
Copy link
Contributor

@tslin2 Could you please also take a look?

@einaraz
Copy link
Contributor Author

einaraz commented May 30, 2025

@einaraz Do we also need to correct the unit for FLXHUMB, FLXHUMG, and FLXHUMR? Looks like these three quantities also have the units of kg/kg * m/s instead of m/s.

@cenlinhe We don't need to. I'm converting only evaporation from the previous time step (all end in 'P') directly in the water budget, where all terms are in m/s. FLXHUMB, FLXHUMG, and FLXHUMR are still kinematic fluxes, and at the end of the code all aggregated and converted to W/m2.

@cenlinhe
Copy link
Contributor

@einaraz Do we also need to correct the unit for FLXHUMB, FLXHUMG, and FLXHUMR? Looks like these three quantities also have the units of kg/kg * m/s instead of m/s.

@cenlinhe We don't need to. I'm converting only evaporation from the previous time step (all end in 'P') directly in the water budget, where all terms are in m/s. FLXHUMB, FLXHUMG, and FLXHUMR are still kinematic fluxes, and at the end of the code all aggregated and converted to W/m2.

OK, I see. The fix looks good to me.

weiwangncar
weiwangncar previously approved these changes May 30, 2025
dudhia
dudhia previously approved these changes May 30, 2025
@weiwangncar weiwangncar changed the base branch from master to release-v4.7.1 May 30, 2025 17:47
@weiwangncar weiwangncar dismissed stale reviews from dudhia and themself May 30, 2025 17:47

The base branch was changed.

@tslin2
Copy link
Contributor

tslin2 commented May 30, 2025

@tslin2 Could you please also take a look?

changes look good to me, thanks.

@weiwangncar weiwangncar merged commit 5a0af46 into wrf-model:release-v4.7.1 May 30, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

SLUCM crashes during rain due to wrong units for evaporation

5 participants