Back to home page

darwin3

 
 

    


Warning, /doc/phys_pkgs/darwin_temperature.rst is written in an unsupported language. File is not indexed.

view on githubraw file Latest commit c9bd7b3d on 2024-03-19 00:00:57 UTC
1d947889e4 Oliv*0001 .. include:: ../defs.hrst
                0002 
a4f2018aab Oliv*0003 .. _Temperature:
                0004 
1d947889e4 Oliv*0005 Temperature dependence
                0006 ^^^^^^^^^^^^^^^^^^^^^^
                0007 
                0008 Temperature functions are selected by the cpp options
                0009 :varlink:`DARWIN_TEMP_VERSION` and :varlink:`DARWIN_TEMP_RANGE`. 
                0010 The cpp option :varlink:`DARWIN_NOTEMP` turns off all temperature dependence.
                0011 The temperature dependence of mortality and grazing can be turned off for
                0012 individual plankton types by setting the traits :varlink:`tempMort`,
                0013 :varlink:`tempMort2` and :varlink:`tempGraz` to 0.
                0014 
09b16dd232 Oliv*0015 Note that the temperature functions in all versions except 1 can be greater than 1.0.
                0016 
1d947889e4 Oliv*0017 
                0018 DARWIN_TEMP_VERSION 1
                0019 '''''''''''''''''''''
                0020 
                0021 .. math::
                0022 
                0023    \begin{gathered}
09b16dd232 Oliv*0024      f^{\text{phy}}_j(T) = \left[ c_j \left[ e_{1 j}^{T/1^\circ{\rm C}}
                0025          {\mathrm{e}}^{-e_{2 j} {|T - T^{\text{opt}}_j|}^{p_j}} - n \right]_{\ge 10^{-10}}
1d947889e4 Oliv*0026        \right]^{\le 1}
                0027    \\
09b16dd232 Oliv*0028      f^{\text{up}}_j(T) =
                0029      f^{\text{graz}}_z(T) =
                0030      f^{\text{remin}}(T) =
                0031      f^{\text{mort}}(T) =
                0032      f^{\text{mort2}}(T) =
                0033      1
                0034    \end{gathered}
1d947889e4 Oliv*0035 
                0036 where the exponential is only present with :varlink:`DARWIN_TEMP_RANGE`.
                0037 
                0038 
                0039 DARWIN_TEMP_VERSION 2
                0040 '''''''''''''''''''''
                0041 
                0042 .. math::
                0043 
                0044    \begin{gathered}
09b16dd232 Oliv*0045      f^{\text{phy}}_j(T) = c^{\text{Arr}} \left[
                0046          {\mathrm{e}}^{A^{\text{Arr}}_{\text{e}}
                0047               \bigl( (T+273.15)^{-1} - {T^{\text{Arr}}_{\text{ref}}}^{-1} \bigr)}
                0048          {\mathrm{e}}^{-e_{2 j} {|T - T^{\text{opt}}_j|}^{p_j}} \right]_{\ge 10^{-10}}
1d947889e4 Oliv*0049    \\
09b16dd232 Oliv*0050      f^{\text{up}}_j(T) =
                0051      f^{\text{graz}}_z(T) =
                0052      f^{\text{remin}}(T) =
                0053      f^{\text{mort}}(T) =
                0054      f^{\text{mort2}}(T) =
                0055      f_{\text{Arr}}(T)
1d947889e4 Oliv*0056    \\
09b16dd232 Oliv*0057      f_{\text{Arr}}(T) = c^{\text{Arr}} \left[
                0058          {\mathrm{e}}^{A^{\text{Arr}}_{\text{e}}
                0059               \bigl( (T+273.15)^{-1} - {T^{\text{Arr}}_{\text{ref}}}^{-1} \bigr)}
1d947889e4 Oliv*0060        \right]_{\ge 10^{-10}}\end{gathered}
                0061 
                0062 where the second exponential in :math:`f^{{{\text{phy}}}}` again is only
                0063 present with :varlink:`DARWIN_TEMP_RANGE`.
                0064 
                0065 
                0066 DARWIN_TEMP_VERSION 3
                0067 '''''''''''''''''''''
                0068 
                0069 .. math::
                0070 
09b16dd232 Oliv*0071    f^{\text{phy}}_j(T) =
                0072    f^{\text{up}}_j(T) =
                0073    f^{\text{het}}_j(T) =
                0074    f^{\text{graz}}_z(T) =
                0075    f^{\text{mort}}(T) =
                0076    f^{\text{mort2}}(T) =
                0077    f^{\text{remin}}(T) =
                0078    \\
                0079    = \left[ {\mathrm{e}}^{A_{\text{e}} (T - T_{\text{ref}})} \right]_{\ge 10^{-10}}
                0080 
                0081 where :math:`A_{{\mathrm{e}}}=0.05/{}^\circ{\rm C}` [#Ae]_ and
                0082 :math:`T_{\text{ref}}=20\,^\circ{\rm C}`.
                0083 
                0084 
                0085 DARWIN_TEMP_VERSION 4
                0086 '''''''''''''''''''''
                0087 
c9bd7b3d4d Oliv*0088 Temperature functions are exponential, with an optional restriction on their range,
09b16dd232 Oliv*0089 
                0090 .. math::
                0091 
                0092      f^{\text{phy}}_j(T) &=
                0093        \mathrm{e}^{A^{\text{phy}}_{\text{e} j} (T - T_{\text{ref}})}
                0094        \mathrm{e}^{-e_{2 j} {|T - T^{\text{opt}}_j|}^{p_j}}
                0095 
                0096      f^{\text{het}}_j(T) &=
                0097        \mathrm{e}^{A^{\text{het}}_{\text{e} j} (T - T_{\text{ref}})}
                0098        \mathrm{e}^{-e^{\text{het}}_{2 j} {|T - T^{\text{opt het}}_j|}^{p^{\text{het}}_j}}
                0099 
                0100      f^{\text{graz}}_j(T) &=
                0101        \text{e}^{A^{\text{zoo}}_{\text{e} j} (T - T_{\text{ref}})}
                0102        \mathrm{e}^{-e^{\text{graz}}_{2 j} {|T - T^{\text{opt graz}}_j|}^{p^{\text{graz}}_j}}
                0103 
                0104      f^{\text{mort}}(T) &=
                0105        \mathrm{e}^{A^{\text{mort}}_{\text{e}} (T - T_{\text{ref}})}
                0106 
                0107      f^{\text{mort2}}(T) &=
                0108        \mathrm{e}^{A^{\text{mort2}}_{\text{e}} (T - T_{\text{ref}})}
                0109 
                0110      f^{\text{remin}}(T) &=
                0111        \mathrm{e}^{A^{\text{remin}}_{\text{e}} (T - T_{\text{ref}})}
                0112 
                0113      f^{{{\text{up}}}}_j(T) &=
                0114        \mathrm{e}^{A^{\text{uptake}}_{\text{e}} (T - T_{\text{ref}})}
                0115 
                0116 where :math:`T_{\text{ref}}=20\,^\circ{\rm C}` and the exponentials with :math:`e^{*}_{2j}`
                0117 are only present if :varlink:`DARWIN_TEMP_RANGE` is defined.
                0118 The main exponential temperature dependence corresponds to the use of
                0119 a Q\ :sub:`10` temperature coefficient,
                0120 
                0121 .. math::
                0122 
                0123    \mathrm{e}^{A_{\text{e}}(T-T_{\text{ref}})} = Q_{10}^{(T-T_{\text{ref}})/10\,^\circ\mathrm{C}}
                0124 
                0125 where
                0126 
                0127 .. math::
                0128 
                0129    Q_{10} = \mathrm{e}^{A_{\text{e}}\cdot 10\,^\circ\mathrm{C}}
                0130    \quad \text{or} \quad
                0131    A_{\text{e}} = \tfrac{1}{10\,^\circ\mathrm{C}} \ln Q_{10}
                0132 
c9bd7b3d4d Oliv*0133 The default value corresponds to :math:`Q_{10}\approx1.55`.
                0134 
                0135 Note that while the temperature dependences of versions 2, 3 and 4 are similar,
                0136 versions 3 and 4 yield rates about 70% higher than version 2 with the default
                0137 TempCoeffArr.  The magnitude of version 1 functions is similar to version 2
                0138 ones.  :ref:`fig_phys_pkg_darwin_tempfunc` shows the phytoplankton temperature
                0139 functions with default parameters for the four versions.
                0140 
                0141 .. figure:: figs/phytotempfunc.*
                0142     :name: fig_phys_pkg_darwin_tempfunc
                0143 
                0144     Default phytoplankton temperature functions for all DARWIN_TEMP_VERSION.
                0145 
                0146 The parameters of all temperature functions are summarized in
                0147 :numref:`tab_phys_pkg_darwin_tempparams`.
09b16dd232 Oliv*0148 
                0149 
                0150 .. table:: Temperature function parameters
c9bd7b3d4d Oliv*0151    :name: tab_phys_pkg_darwin_tempparams
1d947889e4 Oliv*0152 
09b16dd232 Oliv*0153    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0154    | **Trait**                   | **Parameter**                 | **Default Value**                                                    |
                0155    +=============================+===============================+======================================================================+
                0156    | **for version 1:**          |                               |                                                                      |
                0157    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0158    | :varlink:`phytoTempCoeff`   | :varlink:`a_phytoTempCoeff`   | :math:`c_j=1/3`                                                      |
                0159    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0160    | :varlink:`phytoTempExp1`    | :varlink:`a_phytoTempExp1`    | :math:`e_{1j}=1.04` [#Exp1]_                                         |
                0161    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0162    |                             | :varlink:`tempnorm`           | :math:`n=0.3`                                                        |
                0163    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0164    | **for version 2:**          |                               |                                                                      |
                0165    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0166    |                             | :varlink:`TempCoeffArr`       | :math:`c^{\text{Arr}}=0.5882`                                        |
                0167    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0168    |                             | :varlink:`TempAeArr`          | :math:`A^{\text{Arr}}_{{\text{e}}}=-4000\,{\rm K}` [#AeArr]_         |
                0169    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0170    |                             | :varlink:`TempRefArr`         | :math:`T^{\text{Arr}}_{\text{ref}}=293.15\,{\rm K}`                  |
                0171    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0172    | **for version 4:**          |                               |                                                                      |
                0173    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0174    | :varlink:`phytoTempAe`      | :varlink:`a_phytoTempAe`      | :math:`A^{\text{phy}}_{\text{e}j}=0.0438/{}^\circ\mathrm{C}` [#Ae4]_ |
                0175    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0176    | :varlink:`hetTempAe`        | :varlink:`a_hetTempAe`        | :math:`A^{\text{het}}_{\text{e}j}=0.0438/{}^\circ\mathrm{C}`         |
                0177    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0178    | :varlink:`grazTempAe`       | :varlink:`a_grazTempAe`       | :math:`A^{\text{graz}}_{\text{e}j}=0.0438/{}^\circ\mathrm{C}`        |
                0179    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0180    |                             | :varlink:`reminTempAe`        | :math:`A^{\text{remin}}_{\text{e}}=0.0438/{}^\circ\mathrm{C}`        |
                0181    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0182    |                             | :varlink:`mortTempAe`         | :math:`A^{\text{mort}}_{\text{e}}=0.0438/{}^\circ\mathrm{C}`         |
                0183    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0184    |                             | :varlink:`mort2TempAe`        | :math:`A^{\text{mort2}}_{\text{e}}=0.0438/{}^\circ\mathrm{C}`        |
                0185    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0186    |                             | :varlink:`uptakeTempAe`       | :math:`A^{\text{uptake}}_{\text{e}}=0.0/{}^\circ\mathrm{C}`          |
                0187    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0188    | **for TEMP_RANGE:**         |                               |                                                                      |
                0189    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0190    | :varlink:`phytoTempExp2`    | :varlink:`a_phytoTempExp2`    | :math:`e_{2j}=0.001`                                                 |
                0191    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0192    | :varlink:`phytoTempOptimum` | :varlink:`a_phytoTempOptimum` | :math:`T^{\text{opt}}_j=2.0\,^\circ{\rm C}`                          |
                0193    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0194    | :varlink:`phytoDecayPower`  | :varlink:`a_phytoDecayPower`  | :math:`p_{j}=4.0`                                                    |
                0195    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0196    | :varlink:`hetTempExp2`      | :varlink:`a_hetTempExp2`      | :math:`e^{\text{het}}_{2j}=0.001`                                    |
                0197    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0198    | :varlink:`hetTempOptimum`   | :varlink:`a_hetTempOptimum`   | :math:`T^{\text{opt het}}_j=2.0\,^\circ{\rm C}`                      |
                0199    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0200    | :varlink:`hetDecayPower`    | :varlink:`a_hetDecayPower`    | :math:`p^{\text{het}}_{j}=4.0`                                       |
                0201    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0202    | :varlink:`grazTempExp2`     | :varlink:`a_grazTempExp2`     | :math:`e^{\text{graz}}_{2j}=0.001`                                   |
                0203    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0204    | :varlink:`grazTempOptimum`  | :varlink:`a_grazTempOptimum`  | :math:`T^{\text{opt graz}}_j=2.0\,^\circ{\rm C}`                     |
                0205    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0206    | :varlink:`grazDecayPower`   | :varlink:`a_grazDecayPower`   | :math:`p^{\text{graz}}_{j}=4.0`                                      |
                0207    +-----------------------------+-------------------------------+----------------------------------------------------------------------+
                0208 
                0209 With random trait generation, :math:`T^{\text{opt}}_j` is drawn from
                0210 a range [:varlink:`tempmax`--:varlink:`temprange`, :varlink:`tempmax`].
                0211 
                0212 .. [#Ae]     Corresponds to an activation energy of 35.725 kJ mol\ :sup:`--1` at 20°C.
                0213 .. [#Exp1]   Corresponds to an activation energy of 28.023 kJ mol\ :sup:`--1` at 20°C.
                0214 .. [#AeArr]  Corresponds to an activation energy of 33.257 kJ mol\ :sup:`--1` at 20°C.
                0215 .. [#Ae4]    Corresponds to an activation energy of 31.314 kJ mol\ :sup:`--1` at 20°C.
1d947889e4 Oliv*0216