Merge pull request #2 from lvankampenhout/gh-pages

Some changes related to snow

doc/source/tech_note/Hydrology/CLM50_Tech_Note_Hydrology.rst

@@ -1240,22 +1240,15 @@ Runoff from glaciers and snow-capped surfaces
 -------------------------------------------------
 
 All surfaces are constrained to have a snow water equivalent
-:math:`W_{sno} \le 1000` kg m\ :sup:`-2`. For snow-capped
-surfaces, the solid and liquid precipitation reaching the snow surface
-and dew in solid or liquid form, is separated into solid
-:math:`q_{snwcp,ice}` \ and liquid :math:`q_{snwcp,liq}`  runoff terms
-
-.. math::
-   :label: 7.178
-
-   q_{snwcp,ice} =q_{grnd,ice} +q_{frost}
-
-.. math::
-   :label: 7.179
-
-   q_{snwcp,liq} =q_{grnd,liq} +q_{dew}
-
-and snow pack properties are unchanged. The :math:`q_{snwcp,ice}` 
+: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.
+
+The :math:`q_{snwcp,ice}` 
 runoff is sent to the River Transport Model (RTM) (Chapter 11) where it
 is routed to the ocean as an ice stream and, if applicable, the ice is
 melted there.
@@ -1284,5 +1277,3 @@ The contribution of lake runoff to :math:`q_{rgwl}`  is described in
 section :numref:`Precipitation, Evaporation, and Runoff Lake`. The runoff 
 term :math:`q_{rgwl}`  may be negative for glaciers and lakes, which reduces 
 the total amount of runoff available to the river routing model (Chapter :numref:`rst_River Transport Model (RTM)`).
-
->

doc/source/tech_note/References/CLM50_Tech_Note_References.rst

@@ -2819,8 +2819,8 @@ turnover through the microbial biomass in soil. Plant and Soil, 76:
 
 van Kampenhout, L., J.T.M. Lenaerts, W.H. Lipscomb, W.J. Sacks, D.M.
 Lawrence, A.G. Slater, and M.R. van den Broeke, 2017.
-Improving the representation of polar snow and firn in the
-Community Earth System Model, submitted.
+Improving the Representation of Polar Snow and Firn in the
+Community Earth System Model. Journal of Advances in Modeling Earth Systems 9, no. 7: 2583–2600. https://doi.org/10.1002/2017MS000988.
 
 .. _VanTrichtetal2016:
 

doc/source/tech_note/Surface_Albedos/CLM50_Tech_Note_Surface_Albedos.rst

@@ -956,8 +956,13 @@ each time step *t* as
    r_{e} \left(t\right)=\left[r_{e} \left(t-1\right)+dr_{e,\, dry} +dr_{e,\, wet} \right]f_{old} +r_{e,\, 0} f_{new} +r_{e,\, rfz} f_{rfrz}
 
 Here, the effective radius of freshly-fallen snow
-(:math:`r_{e,0}`) is fixed globally at 54.5 :math:`\mu` m (corresponding to a specific surface area of 60 m\ :sup:`2` kg\ :sup:`-1`), and the effective
-radius of refrozen liquid water (:math:`r_{e,rfz}`) is set to 1000\ :math:`\mu` m.
+(:math:`r_{e,0}`) is based on a simple linear temperature-relationship. 
+Below -30 degrees Celsius, a minimum value is enforced of 54.5 :math:`\mu` m
+(corresponding to a specific surface area of 60 m\ :sup:`2` kg\ :sup:`-1`).
+Above 0 degrees Celsius, a maximum value is enforced of 204.5  :math:`\mu` m.
+Between -30 and 0 a linear ramp is used. 
+
+The effective radius of refrozen liquid water (:math:`r_{e,rfz}`) is set to 1000\ :math:`\mu` m.
 
 Dry snow aging is based on a microphysical model described by :ref:`Flanner
 and Zender (2006) <FlannerZender2006>`. This model simulates diffusive vapor flux