From 71b6cc2d6b28bd17b206c3e94015a59818ee971f Mon Sep 17 00:00:00 2001 From: Yifan Cheng Date: Thu, 23 Apr 2026 13:56:03 -0600 Subject: [PATCH] update hydrology documentation - experiment --- .../Hydrology/CLM50_Tech_Note_Hydrology.rst | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/doc/source/tech_note/Hydrology/CLM50_Tech_Note_Hydrology.rst b/doc/source/tech_note/Hydrology/CLM50_Tech_Note_Hydrology.rst index fe379aa2b7..df773ae414 100644 --- a/doc/source/tech_note/Hydrology/CLM50_Tech_Note_Hydrology.rst +++ b/doc/source/tech_note/Hydrology/CLM50_Tech_Note_Hydrology.rst @@ -3,7 +3,7 @@ Hydrology ============ -The model parameterizes interception, throughfall, canopy drip, snow accumulation and melt, water transfer between snow layers, infiltration, evaporation, surface runoff, sub-surface drainage, redistribution within the soil column, and groundwater discharge and recharge to simulate changes in canopy water :math:`\Delta W_{can,\,liq}`, canopy snow water :math:`\Delta W_{can,\,sno}` surface water :math:`\Delta W_{sfc}`, snow water :math:`\Delta W_{sno}`, soil water :math:`\Delta w_{liq,\, i}`, and soil ice :math:`\Delta w_{ice,\, i}`, and water in the unconfined aquifer :math:`\Delta W_{a}` (all in kg m\ :sup:`-2` or mm of H\ :sub:`2`\ O) (:numref:`Figure Hydrologic processes`). +The model parameterizes interception, throughfall, canopy drip, snow accumulation and melt, water transfer between snow layers, infiltration, evaporation, surface runoff, sub-surface drainage, redistribution within the soil column, and groundwater discharge and recharge to simulate changes in canopy liquid water :math:`\Delta W_{can,\,liq}`, canopy snow water :math:`\Delta W_{can,\,sno}`, surface water :math:`\Delta W_{sfc}`, snow water :math:`\Delta W_{sno}`, soil water :math:`\Delta w_{liq,\, i}`, and soil ice :math:`\Delta w_{ice,\, i}`, and water in the unconfined aquifer :math:`\Delta W_{a}` (all in kg m\ :sup:`-2` or mm of H\ :sub:`2`\ O) (:numref:`Figure Hydrologic processes`). The total water balance of the system is @@ -106,31 +106,31 @@ Canopy snow unloading from wind speed :math:`u` and above-freezing temperatures .. math:: :label: 7.12 - q_{unl,\, wind} =\frac{u W_{can,sno}}{1.56\times 10^5 \text{ m}} + q_{unl,\, wind} =\frac{f_{unl,wind,sno} u W_{can,sno}}{1.56\times 10^5 \text{ m}} .. math:: :label: 7.13 - q_{unl,\, temp} =\frac{W_{can,sno}(T-270 \textrm{ K})}{1.87\times 10^5 \text{ K s}} > 0 + q_{unl,\, temp} =\frac{W_{can,sno}(T-270.15 \textrm{ K})}{1.87\times 10^5 \text{ K s}} > 0 .. math:: :label: 7.14 q_{unl,\, tot} =\min \left( q_{unl,\, wind} +q_{unl,\, temp} ,W_{can,\, sno} \right) -The canopy liquid water and snow water equivalent are updated as +where :math: `f_{unl,wind,sno}` is a fraction of snow unloaded from canopy due to wind. The canopy liquid water and snow water equivalent are updated as .. math:: :label: 7.15 - W_{can,\, liq}^{n+1} =W_{can,liq}^{n} + q_{intr,\, liq} - q_{drip,\, liq} \Delta t - E_{v}^{liq} \Delta t \ge 0 + W_{can,\, liq}^{n+1} =W_{can,liq}^{n} + q_{intr,\, liq} \Delta t - q_{drip,\, liq} \Delta t - E_{v}^{liq} \Delta t \ge 0 and .. math:: :label: 7.16 - W_{can,\, sno}^{n+1} =W_{can,sno}^{n} + q_{intr,\, ice} - \left(q_{drip,\, ice}+q_{unl,\, tot} \right)\Delta t + W_{can,\, sno}^{n+1} =W_{can,sno}^{n} + q_{intr,\, ice} \Delta t - \left(q_{drip,\, ice}+q_{unl,\, tot} \right)\Delta t - E_{v}^{ice} \Delta t \ge 0 .. W_{can}^{n+1} =W_{can}^{n} +q_{intr} \Delta t-\left(q_{drip,\, liq} +q_{drip,\, ice} \right)\Delta t-E_{v}^{w} \Delta t\ge 0. @@ -174,7 +174,7 @@ The total rate of liquid and solid precipitation reaching the ground is then Solid precipitation reaching the soil or snow surface, :math:`q_{grnd,\, ice} \Delta t`, is added immediately to the snow pack (Chapter :numref:`rst_Snow Hydrology`). The liquid part, :math:`q_{grnd,\, liq} \Delta t` is added after surface fluxes (Chapter :numref:`rst_Momentum, Sensible Heat, and Latent Heat Fluxes`) and snow/soil temperatures (Chapter :numref:`rst_Soil and Snow Temperatures`) have been determined. -The wetted fraction of the canopy (stems plus leaves), which is required for surface flux (Chapter :numref:`rst_Momentum, Sensible Heat, and Latent Heat Fluxes`) calculations, is (:ref:`Dickinson et al.1993 `) +The wetted fraction of the canopy (stems plus leaves), which is required for surface flux (Chapter :numref:`rst_Momentum, Sensible Heat, and Latent Heat Fluxes`) calculations, is (:ref:`Dickinson et al. 1993 `) .. math:: :label: 7.21 @@ -240,7 +240,7 @@ where :math:`f_{\max }` is the potential or maximum value of :math:`f_{sat}`, :m Surface Water Storage ^^^^^^^^^^^^^^^^^^^^^^^^^^^ -A surface water store has been added to the model to represent wetlands and small, sub-grid scale water bodies. As a result, the wetland land unit has been removed as of CLM4.5. The state variables for surface water are the mass of water :math:`W_{sfc}` (kg m\ :sup:`-2`) and temperature :math:`T_{h2osfc}` (Chapter :numref:`rst_Soil and Snow Temperatures`). Surface water storage and outflow are functions of fine spatial scale elevation variations called microtopography. The microtopography is assumed to be distributed normally around the grid cell mean elevation. Given the standard deviation of the microtopographic distribution, :math:`\sigma _{micro}` (m), the fractional area of the grid cell that is inundated can be calculated. Surface water storage, :math:`Wsfc`, is related to the height (relative to the grid cell mean elevation) of the surface water, :math:`d`, by +A surface water store has been added to the model to represent wetlands and small, sub-grid scale water bodies. As a result, the wetland land unit has been removed as of CLM4.5. The state variables for surface water are the mass of water :math:`W_{sfc}` (kg m\ :sup:`-2`) and temperature :math:`T_{h2osfc}` (Chapter :numref:`rst_Soil and Snow Temperatures`). Surface water storage and outflow are functions of fine spatial scale elevation variations called microtopography. The microtopography is assumed to be distributed normally around the grid cell mean elevation. Given the standard deviation of the microtopographic distribution, :math:`\sigma _{micro}` (m), the fractional area of the grid cell that is inundated can be calculated. Surface water storage, :math:`W_{sfc}`, is related to the height (relative to the grid cell mean elevation) of the surface water, :math:`d`, by .. math:: :label: 7.66 @@ -275,9 +275,9 @@ where :math:`f_{c}` is a threshold below which no single connected inundated are .. math:: :label: 7.70 - q_{out,h2osfc}=k_{h2osfc} \ f_{connected} \ (Wsfc-Wc)\frac{1}{\Delta t} + q_{out,h2osfc}=k_{h2osfc} \ f_{connected} \ (W_{sfc}-W_c)\frac{1}{\Delta t} -where :math:`q_{out,h2osfc}` is the surface water runoff, :math:`k_{h2osfc}` is a constant, :math:`Wc` is the amount of surface water present when :math:`f_{h2osfc} =f_{c}`, and :math:`\Delta t` is the model time step. The linear storage coefficent :math:`k_{h2osfc} = \sin \left(\beta \right)` is a function of grid cell mean topographic slope where :math:`\beta` is the slope in radians. +where :math:`q_{out,h2osfc}` is the surface water runoff, :math:`k_{h2osfc}` is a constant, :math:`W_c` is the amount of surface water present when :math:`f_{h2osfc} =f_{c}`, and :math:`\Delta t` is the model time step. The linear storage coefficient :math:`k_{h2osfc} = \sin \left(\beta \right)` is a function of grid cell mean topographic slope where :math:`\beta` is the slope in radians. .. _Infiltration: @@ -508,22 +508,22 @@ The bulk soil layer saturated hydraulic conductivity is then computed as The soil organic matter properties implicitly account for the standard observed profile of organic matter properties as .. math:: - :label: 1.101 + :label: 7.87 \theta_{sat,om} = max(0.93 - 0.1\times z_{i} / zsapric, 0.83). .. math:: - :label: 1.102 + :label: 7.88 B_{om} = min(2.7 + 9.3\times z_{i} / zsapric, 12.0). .. math:: - :label: 1.103 + :label: 7.89 \psi_{sat,om} = min(10.3 - 0.2\times z_{i} / zsapric, 10.1). .. math:: - :label: 1.104 + :label: 7.89b k_{sat,om} = max(0.28 - 0.2799\times z_{i} / zsapric, k_{sat,\, \min } \left[z_{h,\, i} \right]). @@ -921,7 +921,7 @@ Sublimation of ice is limited to the amount of ice available. Runoff from glaciers and snow-capped surfaces ------------------------------------------------- -All surfaces are constrained to have a snow water equivalent :math:`W_{sno} \le W_{cap} = 10,000` kg m\ :sup:`-2`. For snow-capped columns, any addition of mass at the top (precipitation, dew/riping) is balanced by an equally large mass flux at the bottom of the snow column. This so-called capping flux is separated into solid :math:`q_{snwcp,ice}` \ and liquid :math:`q_{snwcp,liq}` runoff terms. The partitioning of these phases is based on the phase ratio in the bottom snow layer at the time of the capping, such that phase ratio in this layer is unaltered. +All surfaces are constrained to have a snow water equivalent :math:`W_{sno} \le W_{cap} = 10,000` kg m\ :sup:`-2`. For snow-capped columns, any addition of mass at the top (precipitation, dew/ripening) is balanced by an equally large mass flux at the bottom of the snow column. This so-called capping flux is separated into solid :math:`q_{snwcp,ice}` \ and liquid :math:`q_{snwcp,liq}` runoff terms. The partitioning of these phases is based on the phase ratio in the bottom snow layer at the time of the capping, such that phase ratio in this layer is unaltered. The :math:`q_{snwcp,ice}` runoff is sent to MOSART (Chapter :numref:`rst_MOSART`) where it is routed to the ocean as an ice stream and, if applicable, the ice is melted there.