Changes between Version 65 and Version 66 of doc/app/iofiles/pids

Timestamp:

Jun 1, 2018 12:30:10 PM (7 years ago)

Author:

suehring

Comment:

--

doc/app/iofiles/pids

@@ -174 +174 @@
 === [=#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, which define bulk parameters for albedo, soil, root distribution, leaf-area density, etc. To enable initialization of the land-surface model with input-file-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 if the land- and urban-surface model is applied. Further,  in case data is taken from the static input file, both, the land- and urban-surface model need to be either switched on or off. Applying only one of the energy-balance models is not sufficient and will lead to an controlled termination.  \\
+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 input-file-provided variables, the namelist parameter [../../lsmpar#surface_type surface_type] need to be set to 'netcdf'.  
+In case more than one of the surface types (vegetation, pavement, water) is given at a (x-y)-location, the relative fraction of each of the types must be provided by [#surface_fraction surface_fraction].
+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 if the land- and urban-surface model is applied. Further,  in case data is taken from the static input file, both, the land- and urban-surface model need to be either switched on or off. Applying only one of the energy-balance models is not sufficient and will lead to a controlled termination.  \\
 
 ||='''Input variable'''  =||='''Type'''  =||='''LOD''' =||='''Explanation / Remarks'''  =||
@@ -347 +349 @@
 }}}
 {{{#!td
-Relative fraction of the respective surface type given via [#vegetation vegetation_type] (index 0), [#pavement_type pavement_type] (index 1) and [#water_type water_type] (index 2). The sum over all relative fractions must be equal to one for each location. This parameter is only needed at 
+Relative fraction of the respective surface type given via [#vegetation vegetation_type] (nsurface_fraction = 0), [#pavement_type pavement_type] (nsurface_fraction = 1) and [#water_type water_type] (nsurface_fraction = 2). The sum over all relative fractions must be equal to one for each location. This parameter is only needed at 
 locations (y,x) where more than one surface type (vegetation, 
 pavement, water) is defined. Moreover, if more than one surface type is defined at a location, the relative fractions of the respective surface types must not be 0. Also, if '''surface_fraction''' is given for one of the above mentioned surface types, this type need to be defined at this location.