Repository navigation
Open
Labels
coupled-parflowIssues related to eCLM-ParFlow couplingIssues related to eCLM-ParFlow couplingdiscussion/notes
Description
(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 = 25layers, of whichlevsoi = 20are 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)
- Units:
mm pressurefrom ParFlow is copied toPFL_PSI_GRCin eCLM.PFL_PSI_GRCis a gridcell-based field that is further resolved into a subgrid-based field calledSMP.- ParFlow implementation, eCLM implementation
[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)
- Units:
mm,kg/m^2 - Soil liquid in ParFlow is computed and then sent to
PFL_SOILLIQ_GRCin eCLM.PFL_SOILLIQ_GRCis a gridcell-based field that is further resolved into a subgrid-based field calledSOILLIQ. - ParFlow implementation, eCLM implementation
[P] <soil liq not saved in ParFlow>
[E] PFL_SOILLIQ_GRC(time, levgrnd, lat, lon)
[E] SOILLIQ(time, levsoi, lat, lon)
Evapotranspiration (eCLM->ParFlow)
- Units:
mm/s - Root<->soil water exchange from eCLM is sent to ParFlow as
evaptrans. Infiltration is accounted for at the top subsurface layer. - eCLM implementation, ParFlow implementation
[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)
- Model configuration files can be found here: NRW_ParFlow-eCLM
- Development branches: parflow/dev-soil-ice, eCLM/dev-soil-ice
Metadata
Metadata
Assignees
Labels
coupled-parflowIssues related to eCLM-ParFlow couplingIssues related to eCLM-ParFlow couplingdiscussion/notes
Activity
kvrigor commentedon Jan 24, 2025
Meeting notes 05.03.2024 (with @skollet)
1. Ice impedance is not sufficient to properly model multi-phase subsurface flow.
2. New ParFlow features (not yet planned to be implemented; to be discussed in the future)
[-]eCLM-ParFlow Coupling[/-][+]eCLM-ParFlow Coupling Notes[/+]dev-soil-icebranch #66kvrigor commentedon Apr 8, 2026
Liquid soil water usage in eCLM (
h2osoi_liq)Relevant variables
h2osoi_liqis defined atclm5/biogeophys/WaterStateType.F90:nlevgrndis defined atclm5/main/clm_varpar.F90:Soil processes
clm5/biogeophys/HydrologyDrainageMod.F90clm5/biogeophys/BareGroundFluxesMod.F90clm5/biogeophys/SoilTemperatureMod.F90clm5/biogeophys/SoilTemperatureMod.F90clm5/biogeophys/IrrigationMod.F90clm5/biogeophys/SoilMoistStressMod.F90; clm5/biogeophys/CanopyFluxesMod.F90`clm5/biogeophys/SurfaceResistanceMod.F90Soil water matric potential<- replaced by ParFlow pressure head!clm5/biogeochem/ch4Mod.F90clm5/biogeochem/CNFUNMod.F90clm5/biogeochem/DUSTMod.F90](https://github.com/HPSCTerrSys/eCLM/blob/94236422b8900a612abb4d78d24864009cf8d775/src/clm5/biogeochem/DUSTMod.F90#L383]clm5/soibiogeochem/SoilBiogeochemNitrifDenitrifMod.F90clm5/soilbiogeochem/SoilBiogeochemNLeachingMod.F90Snow and ice processes
clm5/biogeophys/SnowHydrologyMod.F90clm5/biogeophys/AerosolMod.F90clm5/biogeophys/SnowSnicarMod.F90clm5/biogeophys/GlacierSurfaceMassBalanceMod.F90clm5/biogeophys/SurfaceAlbedoMod.F90Lake processes
src/clm5/biogeophys/LakeHydrologyMod.F90clm5/biogeophys/LakeFluxesMod.F90clm5/biogeophys/LakeTemperatureMod.F90Other biogeophysical processes
clm5/biogeophys/CanopyHydrologyMod.F90clm5/biogeophys/SoilFluxedMod.F90clm5/biogeophys/CanopyTemperatureMod.F90clm5/biogeophys/CanopyTemperatureMod.F90Dynamice global vegatation (FATES)Non-physics-related stuff
kvrigor commentedon Apr 8, 2026
CLM5/eCLM process sequence
eCLM/src/clm5/main/clm_driver.F90
Lines 103 to 123 in 98054f5
For every timestep,
pfl_psi,pfl_h2osoi_liq) overwrites eCLM soil matric potential and soil liquid (smp_l,h2osoi_liq).subroutine HydrologyNoDrainage -> call SoilWatersubroutine SoilWater -> call soilwater_parflowsubroutine soilwater_parflowCN,CNDV, or static parameterizations.SPmode).qflx_infl,qflx_rootsoi) gets assigned to ParFlow's source/sink term (qflx_parflow).subroutine HydrologyDrainage -> call ParFlowDrainagesubroutine ParFlowDrainageCN,FATES) routines. Related to drainage.use_lch4 = true.hist_update_hbuf).dev-soil-icebranch #66[-]eCLM-ParFlow Coupling Notes[/-][+]eCLM-ParFlow: Coupling Notes[/+]