Changes between Version 41 and Version 42 of doc/app/iofiles/pids

Timestamp:

May 24, 2018 10:45:32 AM (7 years ago)

Author:

suehring

Comment:

--

doc/app/iofiles/pids

@@ -126 +126 @@
 [=#surf '''Surface variables''':]\\\\
 
-For a proper classification of natural land and water surfaces, [#pavement_type pavement_type], [#soil_type soil_type], [#vegetation_type vegetation_type] and [#water_type water_type] are required. Also, the namelist parameter [../../lsmpar#surface_type surface_type] need to be set to 'netcdf'.  Further, if the [../../usmpar urban-surface model] is applied, also [#building_type building_type] is required. Moreover, at least one of the variables  [#pavement_type pavement_type], [#vegetation_type vegetation_type], [#water_type water_type] or [#building_type building_type] need to be defined at each 'xy' location.  \\
+For a proper classification of natural land and water surfaces, [#pavement_type pavement_type], [#soil_type soil_type], [#vegetation_type vegetation_type] and [#water_type water_type] are required, which define bulk parameters for albedo, soil, root distribution, leaf-area density, etc. To enable initialization of the land-surface model with driver-provided variables, the namelist parameter [../../lsmpar#surface_type surface_type] need to be set to 'netcdf'.  Further, if the [../../usmpar urban-surface model] is applied, also [#building_type building_type] is required, which defines bulk parameters to run the urban-surface model. Please note, for the sake of consistency, at least one of the variables  [#pavement_type pavement_type], [#vegetation_type vegetation_type], [#water_type water_type] or [#building_type building_type] need to be defined at each 'xy' location.  \\
 
 ||='''Input variable'''  =||='''Type'''  =||='''LOD''' =||='''Explanation / Remarks'''  =||
@@ -173 +173 @@
 single parameters set by [#building_type building_type] can be overwritten. '''building_pars''' becomes only effective if the [../../usmpar urban-surface model] or the [#indoor_model indoor_model] are applied. 
 Building parameters can be distinguished between ground-floor and upper level. For more information, please see [[attachment:PALM_input_data_standard_v1.7.pdf|here]].
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#building_surface_pars '''building_surface_pars'''] //
+(nbuilding_surface_pars_s,\\
+y,x)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+none
+}}}
+{{{#!td
+Detailed information for specific building surfaces. This variable 
+can contain data for the entire domain or for selected areas where 
+detailed data is available. 
+Setting of '''building_subsurface_pars''' will replace parameter settings made by [#building_type building_type] and [#building_pars building_pars].
+'''building_subsurface_pars''' becomes only effective if the [../../usmpar urban-surface model] is applied. 
+For more information, please see [[attachment:PALM_input_data_standard_v1.7.pdf|here]]. 
 }}}
 |----------------
@@ -344 +364 @@
 [=#plant '''Resolved plant canopy:]\\\\
 
-In order to consider resolved plant canopy, the [../../canpar plant-canopy model] need to be switched on and setting of [#canopy_mode canopy_mode] = 'read_from_file_3d' is required.  
+In order to consider resolved plant canopy, the [../../canpar plant-canopy model] need to be switched on and setting of [#canopy_mode canopy_mode] = 'read_from_file_3d' is required. 
 
 ||='''Input variable'''  =||='''Type'''  =||='''LOD''' =||='''Explanation / Remarks'''  =||
@@ -360 +380 @@
 {{{#!td
 Vegetation resolved by the plant-canopy model in terms of a three­
-dimensional leaf area density (LAD). A preprocessor tool is 
-available to convert arbitrary vegetation information to an LAD 
-field. Setting of '''leaf_area_density''' overwrites the settings of LAD-related parameters made in the namelist [../../canpar &canpar].  
+dimensional leaf area density (LAD). 
+Please note, plant canopy is prescribed relative to the underlying topography and will be mounted on top of the terrain. 
+A preprocessor tool is available to convert arbitrary vegetation information to an LAD field. If '''leaf_area_density''' is set, all settings of LAD-related parameters made in the namelist [../../canpar &canpar] will be ignored. 
+Please note, unresolved vegetation is already treated via the land-surface model considered by [#vegetation_type vegetation_type]. Please check for possible double counting of similar vegetation in case [#vegetation_type vegetation_type] and '''leaf_area_density''' is set at ''(y,x)''-location. 
 }}} 
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#basal_area_density '''basal_area_density'''] //
+(zlad,y,x)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+none
+}}}
+{{{#!td
+Basal area in m2 (i.e. trunk area) per grid volume. A preprocessor 
+tool is available to convert arbritrary vegetation information to an
+basal area density field. The dimension of the field must be equal 
+to that of the leaf area density. Please note, basal area is prescribed relative to the underlying topography. 
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#root_area_density_lad '''root_area_density_lad'''] //
+(zsoil,y,x)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+none
+}}}
+{{{#!td
+Root area of the resolved vegetation in the soil.
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#root_area_density_lsm '''root_area_density_lsm'''] //
+(zsoil,y,x)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+none
+}}}
+{{{#!td
+Root area of the parameterized vegetation in the soil that is set via 
+[#vegetation_type vegetation_type]. When [#vegetation_type vegetation_type] = 0, the '''root_area_density_lsm''' must be set.
+}}}
 
 [=#dynamic_input '''Dynamic input file''']