Changes between Version 350 and Version 351 of doc/app/initialization_parameters

Timestamp:

Jul 4, 2017 2:38:50 PM (8 years ago)

Author:

hoffmann

Comment:

--

doc/app/initialization_parameters

@@ -49 +49 @@
 {{{#!td
 Parameter to switch on the condensation scheme.\\\\ 
-For '''cloud_physics''' = ''.T.'', equations for the total water content and the liquid water potential temperature are solved instead of those for specific humidity and potential temperature. The parameterization of cloud and precipitation physics can be steered with [#cloud_scheme cloud_scheme]. Also, cloud-top cooling by longwave radiation can be utilized (see [#cloud_top_radiation cloud_top_radiation]).\\\\
+For '''cloud_physics''' = ''.T.'', equations for the total water content and the liquid water potential temperature are solved instead of those for water vapor mixing ratio and potential temperature. The parameterization of cloud and precipitation physics can be steered with [#cloud_scheme cloud_scheme]. Also, cloud-top cooling by longwave radiation can be utilized (see [#cloud_top_radiation cloud_top_radiation]).\\\\
 '''cloud_physics''' = ''.T.'' requires [#humidity humidity] = ''.T.''.\\\\
 This condensation scheme is not allowed if cloud droplets are simulated explicitly (see [#cloud_droplets cloud_droplets]).
@@ -292 +292 @@
 }}}
 {{{#!td
-Parameter to switch on the prognostic equation for specific humidity q.\\\\
+Parameter to switch on the prognostic equation for the water vapor mixing ratio q.\\\\
 The initial vertical profile of q can be set via parameters [#q_surface q_surface], [#q_vertical_gradient q_vertical_gradient] and [#q_vertical_gradient_level q_vertical_gradient_level]. Boundary conditions can be set via [#q_surface_initial_change q_surface_initial_change] and [#surface_waterflux surface_waterflux].\\\\
-If the condensation scheme is switched on ([#cloud_physics cloud_physics] = ''.T.''), q becomes the total liquid water content (sum of specific humidity and liquid water content).
+If the condensation scheme is switched on ([#cloud_physics cloud_physics] = ''.T.''), q becomes the total water mixing ratio (sum of water vapor and liquid water).
 }}}
 |----------------
@@ -494 +494 @@
      The initial vertical potential temperature profile will be used. See [#pt_surface pt_surface] and [#pt_vertical_gradient pt_vertical_gradient] for how to set the initial profile.
 
-     In case of runs with humidity, the virtual potential temperature will be used instead (see [#q_surface q_surface] and [#q_vertical_gradient q_vertical_gradient] for how to set the initial specific humidity profile).
+     In case of runs with humidity, the virtual potential temperature will be used instead (see [#q_surface q_surface] and [#q_vertical_gradient q_vertical_gradient] for how to set the initial water vapor mixing ratio profile).
 
      In ocean runs, potential density is used instead of temperature (calculated from the initial potential temperature and salinity profile, see [#sa_surface sa_surface] and [#sa_vertical_gradient sa_vertical_gradient] for how to set the initial salinity profile).
@@ -508 +508 @@
      A constant single potential temperature value is used as reference state. The respective value can be defined with parameter [#pt_reference pt_reference].
 
-     '''Warning:''' In case of runs with humidity, the virtual potential temperature is used. The reference value is then calculated from [#pt_reference pt_reference] and the surface specific humidity (see [#q_surface q_surface]), i.e. it cannot be explicitly set by the user.
+     '''Warning:''' In case of runs with humidity, the virtual potential temperature is used. The reference value is then calculated from [#pt_reference pt_reference] and the surface water vapor mixing ratio (see [#q_surface q_surface]), i.e. it cannot be explicitly set by the user.
 
      In ocean runs, the reference value cannot be explicitly set by the user. Instead, it is calculated as the vertical average of the initial potential density profile.
@@ -1418 +1418 @@
 }}}
 {{{#!td
-Bottom boundary condition of the specific humidity / total water content.\\\\
+Bottom boundary condition of the water vapor / total water mixing ratio.\\\\
 Allowed values are '' 'dirichlet' '' (q(k=0) = const. = [#q_surface q_surface] + [#q_surface_initial_change q_surface_initial_change] (the user may change this value during the run using [../userint#user-defined user-defined] code) and '' 'neumann' '' (q(k=0)=q(k=1)). 
 When a constant surface latent heat flux is used ([#surface_waterflux surface_waterflux]), '''bc_q_b''' = '' 'neumann' '' must be used, because otherwise the resolved scale may contribute to the surface flux so that a constant value cannot be guaranteed.
@@ -1434 +1434 @@
 }}}
 {{{#!td
-Top boundary condition of the specific humidity / total water content.\\\\
+Top boundary condition of the water vapor / total water mixing ratio.\\\\
 Allowed are the values '' 'dirichlet' '' (q(k=nz+1) does not change during the run) and '' 'neumann' ''. With the Neumann boundary condition the value of the humidity gradient at the top is calculated from the initial humidity profile (see [#q_surface q_surface], [#q_vertical_gradient q_vertical_gradient]) by: bc_q_t_val = ( q_init(k=nz) - q_init(k=nz-1)) / dzu(nz).
 Using this value (assumed constant during the run) the humidity boundary values are calculated as 
@@ -1779 +1779 @@
 {{{#!td
 Kinematic water flux near the surface (in kg/kg m/s).\\\\
-If a non-zero value is assigned to this parameter, the respective water flux value is used as bottom (horizontally homogeneous) boundary condition for the humidity equation. This additionally requires that a Neumann condition must be used for the specific humidity / total water content (see [#bc_q_b bc_q_b]), because otherwise the resolved scale may contribute to the surface flux so that a constant value cannot be guaranteed. Also, changes of the surface humidity (see [#q_surface_initial_change q_surface_initial_change]) are not allowed.\\\\
+If a non-zero value is assigned to this parameter, the respective water flux value is used as bottom (horizontally homogeneous) boundary condition for the humidity equation. This additionally requires that a Neumann condition must be used for the water vapor / total water mixing ratio (see [#bc_q_b bc_q_b]), because otherwise the resolved scale may contribute to the surface flux so that a constant value cannot be guaranteed. Also, changes of the surface humidity (see [#q_surface_initial_change q_surface_initial_change]) are not allowed.\\\\
 If no surface water flux is assigned ('''surface_waterflux''' = ''0.0''), it is calculated at each time step by u,,*,, {{{*}}} q,,*,, (of course only with a constant flux layer switched on). Here, q,,*,, is calculated from Monin-Obukhov similarity theory assuming a logarithmic temperature profile between k=0 and k=1. In this case, a Dirichlet condition (see bc_q_b) must be used as the bottom boundary condition for the humidity.
 }}}
@@ -2281 +2281 @@
 }}}
 {{{#!td
-Surface specific humidity / total water content (kg/kg).\\\\
-This parameter assigns the value of the specific humidity '''q''' at the surface (k=0).  Starting from this value, the initial humidity profile is constructed with [#q_vertical_gradient q_vertical_gradient] and [#q_vertical_gradient_level q_vertical_gradient_level]. This profile is also used for the [../../tec/1dmodel 1d-model] as a stationary profile.
+Surface water vapor / total water mixing ratio (kg/kg).\\\\
+This parameter assigns the value of the mixing ratio '''q''' at the surface (k=0).  Starting from this value, the initial humidity profile is constructed with [#q_vertical_gradient q_vertical_gradient] and [#q_vertical_gradient_level q_vertical_gradient_level]. This profile is also used for the [../../tec/1dmodel 1d-model] as a stationary profile.
 }}}
 |----------------
@@ -2295 +2295 @@
 }}}
 {{{#!td
-Change in surface specific humidity / total water content to be made at the beginning of the 3d run (kg/kg).\\\\
+Change in surface water vapor / total water mixing ratio to be made at the beginning of the 3d run (kg/kg).\\\\
 If '''q_surface_initial_change''' is set to a non-zero value the near surface latent heat flux (water flux) is not allowed to be given simultaneously (see [#surface_waterflux surface_waterflux]).
 }}}