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