Changes between Version 97 and Version 98 of doc/app/initialization_parameters

Timestamp:

Sep 15, 2010 12:38:25 PM (14 years ago)

Author:

kanani

Comment:

--

doc/app/initialization_parameters

@@ -2184 +2184 @@
 |----------------
 {{{#!td style="vertical-align:top"
+[=#topography_grid_convention '''topography_grid_convention''']
+}}}
+{{{#!td style="vertical-align:top"
+C*11
+}}}
+{{{#!td style="vertical-align:top"
+default depends on value of [#topography topography]; see text for details
+}}}
+{{{#!td
+Convention for defining the topography grid.\\\\
+Possible values are\\\\
+'' 'cell_edge' ''\\\
+      The distance between cell edges defines the extent of topography. This setting is normally for generic topographies, i.e. topographies that are constructed using length parameters. For example, [#topography topography] = '' 'single_building' '' is constructed using [#building_length_x building_length_x] and [#building_length_y building_length_y]. The advantage of this setting is that the actual size of generic topography is independent of the grid size, provided that the length parameters are an integer multiple of the grid lengths [#dx dx] and [#dy dy]. This is convenient for resolution parameter studies.\\\\
+'' 'cell_center' ''\\\
+      The number of topography cells define the extent of topography. This setting is normally for rastered real topographies derived from digital elevation models. For example, [#topography topography] = '' 'read_from_file' '' is constructed using the input file [../iofiles#TOPOGRAPHY_DATA TOPOGRAPHY_DATA]. The advantage of this setting is that the rastered topography cells of the input file are directly mapped to topography grid boxes in PALM.\\\\
+The example files {{{example_topo_file}}} and {{{example_building}}} in trunk/EXAMPLES/ illustrate the difference between both approaches. Both examples simulate a single building and yield the same results. The former uses a rastered topography input file with '' 'cell_center' '' convention, the latter applies a generic topography with '' 'cell_edge' '' convention.\\\\
+The default value is\\\\
+    * '' 'cell_edge' '' if [#topography topography] = '' 'single_building' '' or '' 'single_street_canyon',''\\
+    * '' 'cell_center' '' if [#topography topography] = '' 'read_from_file',''\\
+    * none (' ' ) otherwise, leading to an abort if '''topography_grid_convention''' is not set.\\\\
+This means that\\\\
+    * For PALM simulations using a user-defined topography, the '''topography_grid_convention''' must be explicitly set to either '' 'cell_edge' '' or '' 'cell_center'.''\\
+    * For PALM simulations using a standard topography ('' 'single_building','' '' 'single_street_canyon' '' or '' 'read_from_file' ''), it is possible but not required to set the '''topography_grid_convention''' because appropriate default values apply.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#wall_heatflux '''wall_heatflux''']
+}}}
+{{{#!td style="vertical-align:top"
+R(5)
+}}}
+{{{#!td style="vertical-align:top"
+5 * 0.0
+}}}
+{{{#!td
+Prescribed kinematic sensible heat flux in K m/s at the five topography faces:
+
+wall_heatflux(0)    top face
+wall_heatflux(1)    left face
+wall_heatflux(2)    right face
+wall_heatflux(3)    south face
+wall_heatflux(4)    north face
+
+This parameter applies only in case of a non-flat topography. The parameter random_heatflux can be used to impose random perturbations on the internal two-dimensional surface heat flux field shf that is composed of surface_heatflux at the bottom surface and wall_heatflux(0) at the topography top face. 
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#wall_humidityflux '''wall_humidityflux''']
+}}}
+{{{#!td style="vertical-align:top"
+R(5)
+}}}
+{{{#!td style="vertical-align:top"
+5 * 0.0
+}}}
+{{{#!td
+        Prescribed kinematic humidity flux in m/s at the five topography faces:
+
+wall_humidityflux(0)    top face
+wall_humidityflux(1)    left face
+wall_humidityflux(2)    right face
+wall_humidityflux(3)    south face
+wall_humidityflux(4)    north face
+
+This parameter applies only in case of a non-flat topography and humidity = .T. 
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#wall_scalarflux '''wall_scalarflux''']
+}}}
+{{{#!td style="vertical-align:top"
+R(5)
+}}}
+{{{#!td style="vertical-align:top"
+5 * 0.0
+}}}
+{{{#!td
+Prescribed scalar flux in kg/(m2 s) at the five topography faces:
+
+wall_scalarflux(0)    top face
+wall_scalarflux(1)    left face
+wall_scalarflux(2)    right face
+wall_scalarflux(3)    south face
+wall_scalarflux(4)    north face
+
+This parameter applies only in case of a non-flat topography and passive_scalar = .T. 
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#<insert_parameter_name> '''<insert_parameter_name>''']
+}}}
+{{{#!td style="vertical-align:top"
+<insert type>
+}}}
+{{{#!td style="vertical-align:top"
+<insert value>
+}}}
+{{{#!td
+<insert explanation>
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
 [=#<insert_parameter_name> '''<insert_parameter_name>''']
 }}}