Changes between Version 8 and Version 9 of doc/app/radiation_parameters

Timestamp:

Apr 30, 2015 8:13:36 AM (10 years ago)

Author:

maronga

Comment:

--

doc/app/radiation_parameters

@@ -34 +34 @@
 }}}
 {{{#!td
-This parameter controls the choice of the surface albedos for direct/diffuse/broadband albedo for a solar angle of 80° according to the following list of-predefined land surfaces. For radiation_scheme = 'rrtmg' the shortwave and longwave albedo values are used and the actual albedos are then calculated based on the current solar angle after Briegleb (1992). Setting on or more of the parameters [#albedo_lw_dif albedo_lw_dif], [#albedo_lw_dir albedo_lw_dir], [#albedo_sw_dif albedo_sw_dif], [#albedo_sw_dir albedo_sw_dir] will overwrite the respective values set by albedo_type. By default, [#albedo_lw_dif albedo_lw_dif] = [#albedo_lw_dir albedo_lw_dir] and [#albedo_sw_dif albedo_sw_dif] = [#albedo_sw_dir albedo_sw_dir]. Moreover, [#constant_albedo constant_albedo] = .T. will keep the albedos constant during the simulation. For radiation_scheme = 'clear-sky' the broadband albedo is used and does not vary in the course of the simulation.
+This parameter controls the choice of the surface albedos for direct/diffuse/broadband albedo for a solar angle of 80° according to the following list of-predefined land surfaces. 
+
+For radiation_scheme = 'rrtmg' the shortwave and longwave albedo values are used and the actual albedos are then calculated based on the current solar angle after Briegleb (1992). Setting on or more of the parameters [#albedo_lw_dif albedo_lw_dif], [#albedo_lw_dir albedo_lw_dir], [#albedo_sw_dif albedo_sw_dif], [#albedo_sw_dir albedo_sw_dir] will overwrite the respective values set by albedo_type. By default, [#albedo_lw_dif albedo_lw_dif] = [#albedo_lw_dir albedo_lw_dir] and [#albedo_sw_dif albedo_sw_dif] = [#albedo_sw_dir albedo_sw_dir]. Moreover, [#constant_albedo constant_albedo] = .T. will keep the albedos constant during the simulation. 
+
+For radiation_scheme = 'clear-sky' the broadband albedo is used and does not vary in the course of the simulation.
 
 ||= '''albedo_type'''=||='''Description'''   =||='''shortwave''' =||='''longwave''' =||='''broadband''' =||
@@ -61 +65 @@
 }}}
 {{{#!td style="vertical-align:top"
+R
+}}}
+{{{#!td style="vertical-align:top"
+depending on [#albedo_type albedo_type]
+}}}
+{{{#!td
+Surface albedo for longwave diffuse radiation for a solar angle of 60°.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#albedo_lw_dir '''albedo_lw_dir''']
+}}}
+{{{#!td style="vertical-align:top"
+R
+}}}
+{{{#!td style="vertical-align:top"
+depending on [#albedo_type albedo_type]
+}}}
+{{{#!td
+Surface albedo for longwave direct radiation for a solar angle of 60°.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#albedo_sw_dif '''albedo_sw_dif''']
+}}}
+{{{#!td style="vertical-align:top"
+R
+}}}
+{{{#!td style="vertical-align:top"
+depending on [#albedo_type albedo_type]
+}}}
+{{{#!td
+Surface albedo for shortwave diffuse radiation for a solar angle of 60°.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#albedo_sw_dir '''albedo_sw_dir''']
+}}}
+{{{#!td style="vertical-align:top"
+R
+}}}
+{{{#!td style="vertical-align:top"
+depending on [#albedo_type albedo_type]
+}}}
+{{{#!td
+Surface albedo for shortwave direct radiation for a solar angle of 60°.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#constant_albedo '''constant_albedo''']
+}}}
+{{{#!td style="vertical-align:top"
+L
+}}}
+{{{#!td style="vertical-align:top"
+.F.
+}}}
+{{{#!td
+Keep the surface albedos to their initial value for the entire simulation. If set to .F., the actual albedos are calculated after Briegleb (1992).
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#day_init '''day_init''']
+}}}
+{{{#!td style="vertical-align:top"
 I
 }}}
 {{{#!td style="vertical-align:top"
-depending on [#albedo_type albedo_type]
-}}}
-{{{#!td
-Text goes here.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#albedo_lw_dir '''albedo_lw_dir''']
-}}}
-{{{#!td style="vertical-align:top"
-R
-}}}
-{{{#!td style="vertical-align:top"
-depending on [#albedo_type albedo_type]
-}}}
-{{{#!td
-Text goes here.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#albedo_sw_dif '''albedo_sw_dif''']
-}}}
-{{{#!td style="vertical-align:top"
-R
-}}}
-{{{#!td style="vertical-align:top"
-depending on [#albedo_type albedo_type]
-}}}
-{{{#!td
-Text goes here.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#albedo_sw_dir '''albedo_sw_dir''']
-}}}
-{{{#!td style="vertical-align:top"
-R
-}}}
-{{{#!td style="vertical-align:top"
-depending on [#albedo_type albedo_type]
-}}}
-{{{#!td
-Text goes here.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#constant_albedo '''constant_albedo''']
+172
+}}}
+{{{#!td
+Day of the year (1-365) at model start. The default value is 172 (June 21).
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#dt_radiation '''dt_radiation''']
+}}}
+{{{#!td style="vertical-align:top"
+R
+}}}
+{{{#!td style="vertical-align:top"
+0.0
+}}}
+{{{#!td
+Timestep of the radiation model (in s).
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#lambda '''lambda''']
+}}}
+{{{#!td style="vertical-align:top"
+R
+}}}
+{{{#!td style="vertical-align:top"
+0.0
+}}}
+{{{#!td
+Geographical longitude (in degrees). 
+
+Note that the radiation scheme also requires information on the geographical latitude (see [wiki:doc/app/inipar#phi phi]).
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#lw_raditaion '''lw_radiation''']
 }}}
 {{{#!td style="vertical-align:top"
@@ -116 +174 @@
 }}}
 {{{#!td style="vertical-align:top"
-.F.
-}}}
-{{{#!td
-Text goes here.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#day_init '''day_init''']
-}}}
-{{{#!td style="vertical-align:top"
-I
-}}}
-{{{#!td style="vertical-align:top"
-172
-}}}
-{{{#!td
-Day of the year (1-365) at model start. The default value is 172 (June 21).
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#dt_radiation '''dt_radiation''']
+.T.
+}}}
+{{{#!td
+Switch off longwave radiation.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#net_radiation '''net_radiation''']
 }}}
 {{{#!td style="vertical-align:top"
@@ -145 +190 @@
 }}}
 {{{#!td
-Timestep of the radiation model (in s).
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#lambda '''lambda''']
-}}}
-{{{#!td style="vertical-align:top"
-R
-}}}
-{{{#!td style="vertical-align:top"
-0.0
-}}}
-{{{#!td
-Geographical longitude (in degrees). 
-
-Note that the radiation scheme also requires information on the geographical latitude (see [wiki:doc/app/inipar#phi phi]).
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#lw_raditaion '''lw_radiation''']
+Net radiation at the surface in W/m². This parameter is only used in case of [#radiation_scheme radiation scheme]{{{= 'constant'}}}.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#radiation_scheme '''radiation_scheme''']
+}}}
+{{{#!td style="vertical-align:top"
+C*10
+}}}
+{{{#!td style="vertical-align:top"
+'clear-sky'
+}}}
+{{{#!td
+Radiation scheme to be used.
+
+The user can choose between the following schemes:
+
+'' 'constant' ''
+
+A constant net radiation at the surface is prescribed (see [#net_radiation]).
+
+
+'' 'clear-sky' ''
+
+A simple clear sky model is used to calculate the radiation fluxes at the surface (shortwave incoming, shortwave outgoing, longwave incoming, longwave outgoing) and consequently the net radiation at the surface. This scheme requires setting of [#albedo albedo], [#day_init day_init], [#lambda lambda], [wiki:doc/app/inipar#phi phi], and [#time_utc_init time_utc_init].
+
+
+'' 'rrtmg' ''
+
+The [http://rtweb.aer.com/rrtm_frame.html RRTMG model] is used to calculate the radiative heating rates for each model column. This scheme requires setting of [#day_init day_init], [#lambda lambda], [wiki:doc/app/inipar#phi phi], [#time_utc_init time_utc_init]. The folling parameters can be set optionally: [#albedo_type albedo_type] (and/or [#albedo_lw_dif albedo_lw_dif], [#albedo_lw_dir albedo_lw_dir], [#albedo_sw_dif albedo_sw_dif], [#albedo_sw_dir albedo_sw_dir]). [#constant_albedo constant_albedo] can be used to fix the albedo during the simualation. It is also possible to use the switches [#lw_radiation lw_radiation] and [#sw_radiation sw_radiation].
+
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#sw_raditaion '''sw_radiation''']
 }}}
 {{{#!td style="vertical-align:top"
@@ -173 +233 @@
 }}}
 {{{#!td
-Text goes here.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#net_radiation '''net_radiation''']
-}}}
-{{{#!td style="vertical-align:top"
-R
-}}}
-{{{#!td style="vertical-align:top"
-0.0
-}}}
-{{{#!td
-Net radiation at the surface in W/m². This parameter is only used in case of [#radiation_scheme radiation scheme]{{{= 'constant'}}}.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#radiation_scheme '''radiation_scheme''']
-}}}
-{{{#!td style="vertical-align:top"
-C*10
-}}}
-{{{#!td style="vertical-align:top"
-'clear-sky'
-}}}
-{{{#!td
-Radiation scheme to be used.
-
-The user can choose between the following schemes:
-
-'' 'constant' ''
-
-A constant net radiation at the surface is prescribed (see [#net_radiation]).
-
-
-'' 'clear-sky' ''
-
-A simple clear sky model is used to calculate the radiation fluxes at the surface (shortwave incoming, shortwave outgoing, longwave incoming, longwave outgoing) and consequently the net radiation at the surface. This scheme requires setting of [#albedo albedo], [#day_init day_init], [#lambda lambda], [wiki:doc/app/inipar#phi phi], and [#time_utc_init time_utc_init].
-
-
-'' 'rrtmg' ''
-
-The [http://rtweb.aer.com/rrtm_frame.html RRTMG model] is used to calculate the radiative heating rates for each model column. This scheme requires setting of [#day_init day_init], [#lambda lambda], [wiki:doc/app/inipar#phi phi], [#time_utc_init time_utc_init]. The folling parameters can be set optionally: [#albedo_type albedo_type] (and/or [#albedo_lw_dif albedo_lw_dif], [#albedo_lw_dir albedo_lw_dir], [#albedo_sw_dif albedo_sw_dif], [#albedo_sw_dir albedo_sw_dir]). [#constant_albedo constant_albedo] can be used to fix the albedo during the simualation. It is also possible to use the switches [#lw_radiation lw_radiation] and [#sw_radiation sw_radiation].
-
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#sw_raditaion '''sw_radiation''']
-}}}
-{{{#!td style="vertical-align:top"
-L
-}}}
-{{{#!td style="vertical-align:top"
-.T.
-}}}
-{{{#!td
-Text goes here.
+Switch off shortwave radiation. Note that shortwave radiation is automatically switched off during nighttime.
 }}}
 |----------------