Skip to content

eCLM-ParFlow: Soil moisture disagreements in real case Parflow-coupled runs #123

Open

Description

@s-poll

Summary

TSMP2 EUR-12, ICON-CLMcom forcing, 60yr spinup, sim year 2018 (TSMP2_workflow-engine setup). Every configuration coupling ParFlow shows a large, domain-wide LHF deficit vs. ParFlow-free configs. Root cause traces to eCLM and ParFlow disagreeing on their own shared soil saturation state within the same coupled run, which was already a finding in #103, now shown to drive a real energy-balance bias.

Details

Every ParFlow-coupled config underperforms its ParFlow-free counterpart by ~30-50 W/m² at peak season. Deficit is spatially even across the whole domain; not only local artifacts. This leads to a different flux partitioning and to larger RMSE against GLEAM and has negative feedback especially in the fully coupled simulation.

Image Domain average (EUR CORDEX focus domain) latent heat flux.

eCLM's own state shifts when coupled to ParFlow. eCLM's relative saturation (level 3) differs between standalone eCLM/ICON-eCLM and their ParFlow-coupled counterparts, especially spring dry-down/summer. Thus, coupling changes eCLM's hydrological state, not just the exchanged flux (not shown).

A deeper analysis revealed that within one coupled eCLM-ParFlow run, the two component models disagree. Same eclm-pfl experiment, level 3: eCLM's H2OSOI/WATSAT vs. ParFlow's own Pressure-derived saturation (van Genuchten) shows.

Image Relative saturation from eCLM and ParFlow (level three from the top of the soil) from the eCLM-ParFlow coupled Simulation.

eCLM saturation in simulation coupled with ParFlow locally exceeds 100%, up to ~20x nominal at specific points (especially in winter time), leading to averages above 100%.

Image Image

Yearly average from eCLM-ParFlow simulation.

Switching the coupled exchange variable from liquid water content to saturation directly would likely eliminate the most visible symptom reported in this issue. However, this would only mask rather than resolve the underlying problem.

Data and analysis scripts

Data: /p/scratch/cslts/poll1/sim/paper/wfe_eur-11_revsetup_eclm-pfl/dta/simres
Script: eurcordex_soilmoisture_eclm_vs_parflow.R

Activity

  1. changed the title [-]eCLM and ParFlow soil moisture disagree in real case runs[/-] [+]eCLM and ParFlow soil moisture disagree in real case Parflow-coupled runs[/+] on Jul 23, 2026
  2. pinned this issue on Jul 24, 2026
  3. s-poll commented on Jul 27, 2026

    @s-poll
    MemberAuthor

    The origin of the relative soil water saturation discrepancy between model components appears to be differing porosity values. Even though the static fields share the same database (SoilGrids), processing differs: eCLM calculates porosity based on sand/clay/organic matter content, whereas ParFlow uses Rosetta values. This leads to strong differences, especially in peatland areas.

    Porosity values for ParFlow (top) and eCLM (bottom) for the uppermost model level.
    Image

    Image

    Force synchronization between model components by adopting eCLM porosity values in ParFlow. While eCLM values can theoretically vary over time, organic matter remains constant in SP mode (verified in 2018 runs). I created a file processing eCLM porosity to ParFlow with the mean of claude (parflow static file generator)

    Additional Points:

    Deep Soil Indicator Default: ParFlow soil indicators > 13 default to a fixed porosity of 0.4. This effect all deeper soils indicator classes. Is this intended, or was the parameterization forgotten?

    eCLM over-saturation: Porosity differences explain the relative saturation gap, but do not explain why eCLM values exceed 100%.

    Redundant Conversion in Coupling: The liquid water content coupling seems arbitrary. ParFlow calculates liquid water content from saturation using its own porosity before sending it to eCLM, where porosity otherwise seems to be used mainly for diagnostics (volumetric soil moisture calculation). Not checked in depth for ParFlow, but coupling the saturation seems to be more intuitive for me.

  4. kvrigor commented on Jul 28, 2026

    @kvrigor
    Member

    The origin of the relative soil water saturation discrepancy between model components appears to be differing porosity values.

    Not surprising given that ParFlow and eCLM independently define soil texture characteristics. Should we start modifying eCLM and ParFlow towards a single source of truth for soil texture specification? We can let ParFlow inherit the soil characteristics defined in the eCLM surface data file.

  5. changed the title [-]eCLM and ParFlow soil moisture disagree in real case Parflow-coupled runs[/-] [+]eCLM-ParFlow: Soil moisture disagreements in real case Parflow-coupled runs[/+] on Jul 28, 2026
  6. s-poll commented on Aug 3, 2026

    @s-poll
    MemberAuthor

    EDIT: Update. In the previous version of this post there was a misconfiguration with eCLM restart file in forced porosity sycned simulations. This has been fixed. The overall message did not change.

    The forced synchronization of porosity (with the procedure/script posted in my last post) has clearly led to some improvements in respect to the soil moisture.

    Image Image

    There also still seems to be an issue, especially during winter, as already pointed out in my previous comment. I will open a separate issue to track this independently.

    The new results look much better with respect to the soil moisture, even though there is still a discrepancy between eCLM and ParFlow's soil moisture state. The latent heat flux in the eCLM-ParFlow simulation improved with forced porosity synchronization, however, is still lower compared to eCLM, leading to higher RMSE.

    Image
  7. kvrigor commented on Aug 31, 2026

    @kvrigor
    Member

    A small update: @skollet suggested to print h2oisoi_liq writes and here are the initial results. I'm running a similar setup to @s-poll with a modified simulation period from 2018.03.01-2018.03.15. I have actually set my sim period to 1 month, but I hit a 2h wall clock limit despite running with 6 nodes and with history/restart file saving turned off. Nevertheless, eCLM logs were able to capture the following h2oisoi_liq writes during the sim period 2018.03.01-2018.03.15:

    Before Parflow sends h2osoi_liq to eCLM

    1. Surface water storage: The h2osoi_liq update here is no more than min(surface water) = 10^-8 mm, which is a very small but a non-zero amount.

    frac_h2osfc(c) = 0._r8
    h2osoi_liq(c,1) = h2osoi_liq(c,1) + h2osfc(c)
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") col%gridcell(c), col%itype(c), 1, "CanopyHydrologyMod.FracH2OSfc"

    1. Snow Hydrology: Snow water is mainly updated in three code sections (shown below). Note that snow layers are above soil and hence Parflow h2osoi_liq aren't directly overwritten; however, h2osoi_liq at snow layers will be resolved later via combination and subdivision (see step 5).

    h2osoi_liq(c,snl(c)+1) = h2osoi_liq(c,snl(c)+1) + &
    frac_sno_eff(c) * (qflx_rain_grnd(c) + qflx_dew_grnd(c) &
    - qflx_evap_grnd(c)) * dtime
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), snl(c)+1, "SnowHydrologyMod.SnowWater.2"

    h2osoi_liq(c,j) = h2osoi_liq(c,j) + qin(c)
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), j, "SnowHydrologyMod.SnowWater.5"

    h2osoi_liq(c,j) = h2osoi_liq(c,j) - qout(c)
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), j,"SnowHydrologyMod.SnowWater.6"

    1. Surface runoff for urban land units. From the CLM5 tech guide: "A certain amount of liquid water is allowed to pond on urban surfaces which supports evaporation. Water in excess of the maximum ponding depth runs off."

    h2osoi_liq(c,1) = max(0._r8,h2osoi_liq(c,1)+ &
    (qflx_top_soil(c)-qflx_evap_grnd(c))*dtime)
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), 1, "SoilHydrologyMod.SurfaceRunoff.2"

    After receiving h2osoi_liq from Parflow

    1. Soil condensation. Ice and liquid water are corrected to account for frost and dew.

    h2osoi_liq(c,1) = h2osoi_liq(c,1) + (1._r8 - frac_h2osfc(c))*qflx_dew_grnd(c) * dtime
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), 1, "SoilHydrologyMod.RenewCondensation.1"

    h2osoi_liq(c,1) = h2osoi_liq(c,1) + qflx_dew_grnd(c) * dtime
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), 1, "SoilHydrologyMod.RenewCondensation.2"

    1. Snow Layer Combination and Subdivision. This is where liquid and ice water from snow layers (z=[-N:0]) affect h2osoi_liq at the 1st soil hydrology layer (z=1).

    if (h2osno(c) <= 0._r8) snow_depth(c) = 0._r8
    ! this is where water is transfered from layer 0 (snow) to layer 1 (soil)
    if (ltype(l) == istsoil .or. urbpoi(l) .or. ltype(l) == istcrop) then
    h2osoi_liq(c,0) = 0.0_r8
    h2osoi_liq(c,1) = h2osoi_liq(c,1) + zwliq(c)
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), 0, "SnowHydrologyMod.CombineSnowLayers.4"
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), 1, "SnowHydrologyMod.CombineSnowLayers.4"

    References

    • Debug logs less /p/project1/cslts/rigor1/TSMP2_workflow-engine/run/sim_eclmparflow_20180301_15days/logs/15576164.comp_lnd.log
    • eCLM debugging branch: dev-pfl-soilliq-debug-printlogs
  8. kvrigor commented on Sep 8, 2026

    @kvrigor
    Member

    Quantities of condensation and snowmelt (kg/m^2) on model date 2018-04-01. Posting here for reference. Full data is stored at /p/project1/cslts/shared_data/grids/EUR-12/remapped_eCLM_eur-12-iic.clm2.h0.2018-04-01-00000_EUR-11.nc

    Soil condensation

    condensation = (1._r8 - frac_h2osfc(c))*qflx_dew_grnd(c) * dtime
    h2osoi_liq(c,1) = h2osoi_liq(c,1) + condensation
    h2osoi_liq_debug1(c) = condensation
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), 1, "SoilHydrologyMod.RenewCondensation.1"

    Image

    Snow Layer Combination and Subdivision

    if (ltype(l) == istsoil .or. urbpoi(l) .or. ltype(l) == istcrop) then
    h2osoi_liq(c,0) = 0.0_r8
    h2osoi_liq(c,1) = h2osoi_liq(c,1) + zwliq(c)
    h2osoi_liq_debug2(c) = zwliq(c)
    write(iulog, "( 'DEBUGH2OSOI', ',', I0, ',', I0, ',', I0, ',', A)") g, col%itype(c), 1, "SnowHydrologyMod.CombineSnowLayers.4"

    Image
  9. added
    biogeophysicsIssues related to biogeophysical aspects of eCLM.
    on Sep 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    biogeophysicsIssues related to biogeophysical aspects of eCLM.coupled-parflowIssues related to eCLM-ParFlow coupling

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions