Skip to content

eCLM-ParFlow: Coupling Notes #48

Open

Description

@kvrigor

(migrated from internal issue tracker)

General notes

  • The test setup is based on Theresa Boas' test case for the NRW domain (300x300).
  • The setup for the ParFlow domain uses 30 sublayers.
  • eCLM's subsurface discretization uses levgrnd = 25 layers, of which levsoi = 20 are hydrologically and biogeochemically active. The deepest 5 layers are only included in the thermodynamical calculations.

Coupled fields

  • The relevant history files can be found at /p/largedata/slts/rigor1/pfeclm_logs/NRW_300x300:
[E] eclm_nrw_300x300.clm2.h0.2017-01-01-00000.nc
[P] parflow_nrw_300x300.out.00001.nc
  • Note that the sublayer indexing in eCLM and ParFlow are different!
***** Subsurface level indexing convention *****
    eCLM:  1=topmost layer, 25=deepest layer
 ParFlow: 29=topmost layer,  0=deepest layer
************************************************
  • The output fields in the next subsections are labeled [E] if it is from eCLM [P] if it is from ParFlow.

Pressure head (ParFlow->eCLM)

[P] pressure(time, z, y, x)
[E] PFL_PSI_GRC(time, levgrnd, lat, lon)
[E]         SMP(time, levgrnd, lat, lon)

H2O soil liquid (ParFlow->eCLM)

[P] <soil liq not saved in ParFlow>
[E] PFL_SOILLIQ_GRC(time, levgrnd, lat, lon)
[E]         SOILLIQ(time,  levsoi, lat, lon)

Evapotranspiration (eCLM->ParFlow)

[E] QPARFLOW(time, levsoi, lat, lon)
[P] evaptrans(time, z, y, x)

Ice impedance (eCLM->ParFlow)

  • EXPERIMENTAL FEATURE (see comment below)
  • unitless, value ranges between 0.00-1.00
  • Ice impedance (in eCLM) is a function of ice content and quantifies the increased tortuosity of the water flow when part of the pore space is filled with ice.
  • In ParFlow, ice impedance is interpreted as a flow barrier—a dimensionless scalar quantity that reduces flow rate across a cell face.
  • eCLM implementation, ParFlow implementation
[E] ICE_IMPEDANCE(time, levgrnd, lat, lon)
[P] ice_impedance(time, z, y, x)

Miscellaneous

  • The subsurface porosity and permeability information can be found at parflow_nrw_300x300.out.00000.nc.
perm_x(time, z, y, x)
perm_y(time, z, y, x)
perm_z(time, z, y, x)
porosity(time, z, y, x)
specific_storage(time, z, y, x)
slopex(time, y, x)
slopey(time, y, x)
DZ_Multiplier(time, z, y, x)

Activity

  1. pinned this issue on Jan 24, 2025
  2. kvrigor commented on Jan 24, 2025

    @kvrigor
    MemberAuthor

    Meeting notes 05.03.2024 (with @skollet)

    1. Ice impedance is not sufficient to properly model multi-phase subsurface flow.

    • Soil water in eCLM contains liquid and ice part, while ParFlow only contains liquid part. This means that porosity and pressure head in ParFlow has to be corrected in eCLM to take into account ice content, and then send the corrected fields back to ParFlow. Basically, porosity and pressure head in ParFlow has to be changed such that it becomes a function of ice content.
    • The proposed implementation above, even if it can be done, is still subject to debate. Furthermore, there are no thermodynamic checks in ParFlow to guarantee the energy balance of the eCLM-ParFlow coupled system.
    • Hence, ParFlow with ice impedance will remain an experimental feature until a suitable ice coupling strategy has been decided. It is still available to those who are interested to check this feature.

    2. New ParFlow features (not yet planned to be implemented; to be discussed in the future)

    • New overland flow boundary condition
    • ParFlow with temperature (ParFlowE)
  3. changed the title [-]eCLM-ParFlow Coupling[/-] [+]eCLM-ParFlow Coupling Notes[/+] on Jan 24, 2025
  4. kvrigor commented on Apr 8, 2026

    @kvrigor
    MemberAuthor

    Liquid soil water usage in eCLM (h2osoi_liq)

    Relevant variables

    h2osoi_liq is defined at clm5/biogeophys/WaterStateType.F90:

    type, public :: waterstate_type
      real(r8), pointer :: h2osoi_liq_col      (:,:) ! col liquid water (kg/m2) (-nlevsno+1:nlevgrnd)    
      real(r8), pointer :: h2osoi_ice_col      (:,:) ! col ice lens (kg/m2)     (-nlevsno+1:nlevgrnd)
      real(r8), pointer :: h2osoi_vol_col      (:,:) ! col volumetric soil water (0<=h2osoi_vol<=watsat) [m3/m3]  (nlevgrnd)
      ! ...
      real(r8), pointer :: pfl_psi_col         (:,:) ! ParFlow pressure head
      real(r8), pointer :: pfl_h2osoi_liq_col  (:,:) ! ParFlow soil liquid
      ! ...
    end type waterstate_type

    nlevgrnd is defined at clm5/main/clm_varpar.F90:

    nlev_equalspace   = 15
    nlevsoifl =  10
    nlevurb   =  5
    if ( soil_layerstruct == '10SL_3.5m' ) then
      nlevsoi     =  nlevsoifl
      nlevgrnd    =  15
    else if ( soil_layerstruct == '23SL_3.5m' ) then 
      nlevsoi     =  8  + nlev_equalspace
      nlevgrnd    =  15 + nlev_equalspace
    else if ( soil_layerstruct == '49SL_10m' ) then
      nlevsoi     =  49 ! 10x10 + 9x100 + 30x300 = 1e4mm = 10m
      nlevgrnd    =  nlevsoi+5
    else if ( soil_layerstruct == '20SL_8.5m' ) then
      nlevsoi     =  20 
      nlevgrnd    =  nlevsoi+5
    endif

    Soil processes

    Snow and ice processes

    Lake processes

    Other biogeophysical processes

    Non-physics-related stuff

  5. kvrigor commented on Apr 8, 2026

    @kvrigor
    MemberAuthor

    CLM5/eCLM process sequence

    subroutine clm_drv(doalb, nextsw_cday, declinp1, declin, rstwr, nlend, rdate, rof_prognostic)
    !
    ! !DESCRIPTION:
    !
    ! First phase of the clm driver calling the clm physics. An outline of
    ! the calling tree is given in the description of this module.
    !
    ! !USES:
    use clm_time_manager , only : get_curr_date
    use clm_varctl , only : use_lai_streams
    use SatellitePhenologyMod, only : lai_advance
    !
    ! !ARGUMENTS:
    implicit none
    logical , intent(in) :: doalb ! true if time for surface albedo calc
    real(r8), intent(in) :: nextsw_cday ! calendar day for nstep+1
    real(r8), intent(in) :: declinp1 ! declination angle for next time step
    real(r8), intent(in) :: declin ! declination angle for current time step
    logical, intent(in) :: rstwr ! true => write restart file this step
    logical, intent(in) :: nlend ! true => end of run on this step
    character(len=*),intent(in) :: rdate ! restart file time stamp for name

    For every timestep,

    1. Update glacier areas.
    2. Do time interpolation of monthly vegetation data.
    3. Define active layer thickness (related to freeze-thaw).
    4. Calculate vertical profiles for distributing soil and litter C and N.
    5. Initialize the mass balance checks for carbon and nitrogen.
    6. Update subgrid weights with dynamic landcover.
    7. Initialize the column-level mass balance checks for water, carbon & nitrogen.
    8. Update dynamic N deposition field, on albedo timestep.
    9. Initialize variables from previous time step, downscale atm forcings, and determine canopy interception and precipitation onto ground surface.
    10. Run canopy hydrology processes.
    11. Run surface and urban radiation processes.
    12. Determine leaf temperature and surface fluxes based on ground temperature from previous time step.
    13. Determine fluxes: (1) bareground, (2) canopy, (3) urban, (4) lake.
    14. Determine irrigation needed for future time steps.
    15. Run DUST and VOC emissions model.
    16. Determine lake and soil temperatures.
    17. Update surface fluxes for new ground temperature.
    18. Perform averaging from patch to column level.
    19. Perform soil and surface hydrology routines (excluding subsurface runoff).
    20. Compute glacier surface mass balance.
    21. Lake hydrology.
    22. Calculate column-integrated aerosol masses and mass concentrations for radiative calculations.
    23. Compute snow age.
    24. Fraction of soil covered by snow.
    25. Compute snow age again, and then the fraction of soil covered by snow.
    26. Ecosystem dynamics: uses CN, CNDV, or static parameterizations.
    27. Call Satellite Phenology routing (if running in SP mode).
    28. Dry deposition of chemical tracers.
    29. Perform soil and snow hydrology routines (with subsurface runoff).
    30. More ecosystem dynamics (CN, FATES) routines. Related to drainage.
    31. Balance checks: energy, water, carbon, and nitrogen.
    32. Calculate methane fluxes if use_lch4 = true.
    33. Determine albedos for the next time step.
    34. Determin gridcell averaged properties to send to atmosphere and glacier models.
    35. Write global average diagnostics to log file.
    36. Update accumulator variables held by the ff. global pointers: atm forcings, temperature, canopy state, water flux, energy flux, BGC vegetation, and crop.
    37. Update history buffer (hist_update_hbuf).
    38. Trigger dynamic vegetation cleanup routines.
    39. Write history and restart files.
  6. unpinned this issue on May 22, 2026
  7. changed the title [-]eCLM-ParFlow Coupling Notes[/-] [+]eCLM-ParFlow: Coupling Notes[/+] on May 22, 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

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions