| 68 | | ||[=#buildings_3d ''buildings_3d(z,y,x)''] || NC_BYTE ||{{{_FillValue=-127b}}}(*)\\{{{coordinates}}}\\{{{flag_meanings="no building, building"}}}\\ {{{flag_values=0b, 1b}}}\\{{{grid_mapping}}}\\{{{long_name="building_flag"}}}\\{{{res_orig}}}\\{{{source}}}\\{{{units="1"}}}\\{{{valid_range=0b, |
| | 68 | ||[=#buildings_3d ''buildings_3d(z,y,x)''] || NC_BYTE ||{{{_FillValue=-127b}}}(*)\\{{{coordinates}}}\\{{{flag_meanings="no building, building"}}}\\ {{{flag_values=0b, 1b}}}\\{{{grid_mapping}}}\\{{{long_name="building_flag"}}}\\{{{res_orig}}}\\{{{source}}}\\{{{units="1"}}}\\{{{valid_range=0b, 1b}}} || Three-dimensional building topology relative to the underlying terrain. ''buildings_3d'' will be mapped on top of the maximum local terrain height occupied by the respective building. Note, ''buildings_3d'' does not need to be prescribed beyond the top level of the highest buildings, i.e. ''z'' dimension can me minimized accordingly. If ''buildings_3d'' is prescribed, [#building_id building_id] is required. |
| 69 | 69 | ||[=#obstruction_uv ''obstruction_uv(azimuth_uv,zenith_uv,y,x)''] || NC_BYTE ||{{{_FillValue=-127b}}}(*)\\{{{coordinates}}}\\{{{flag_meanings="no obstruction, obstruction"}}}\\{{{flag_values=0b, 1b}}}\\{{{grid_mapping}}}\\{{{long_name="obstruction"}}}\\{{{res_orig}}}\\{{{source}}}\\{{{units="1"}}}\\{{{valid_range=0b, 1b}}} || Obstruction of the sky at a pixel location (y,x). This field is needed only if the [wiki:doc/app/biometeorology_parameters#UVExposureModel UV exposure model] is used. || |
| 70 | 70 | ||[=#zt ''zt(y,x)''] || NC_FLOAT ||{{{_FillValue=-9999.f}}}(*)\\{{{coordinates}}}\\{{{grid_mapping}}}\\{{{long_name="terrain_height"}}}\\{{{res_orig}}}\\{{{source}}}\\{{{units="m"}}} || Terrain height in m relative to [#origin_z origin_z]. If not provided, the relative terrain height will be set to 0 m all over the model domain. Please note, ''zt'' must not contain any {{{_FillValues}}}. || |
| 78 | 76 | 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 [wiki:doc/app/lsmpar#surface_type surface_type] needs to be set to 'netcdf'. |
| 79 | 77 | In case more than one of the surface types (vegetation, pavement, water) is given at an (x,y) location, the relative fraction of each of the types must be provided by [#surface_fraction surface_fraction]. |
| 80 | | Further, if the [wiki:doc/app/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] needs to be defined at each (x,y) location if the land- and urban-surface model is applied. |
| 81 | | If only the land-surface model is applied but no urban-surface model, one of [#pavement_type pavement_type], [#vegetation_type vegetation_type] or [#water_type water_type] needs to be defined at each (x,y) location. |
| | 78 | |
| | 79 | Further, if the [wiki:doc/app/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] needs to be defined at each (y,x) location if the land- and urban-surface model is applied. |
| | 80 | |
| | 81 | If only the land-surface model is applied but no urban-surface model, one of [#pavement_type pavement_type], [#vegetation_type vegetation_type] or [#water_type water_type] needs to be defined at each (y,x) location. |
| | 82 | |
| | 84 | |
| | 85 | === [=#surf '''Surface variables''':] === |
| | 86 | ||='''Input variable''' =||='''Type''' =||='''Attributes''' =||='''Explanation / Remarks''' =|| |
| | 87 | {{{#!td |
| | 88 | [=#building_type ''building_type(y,x)''] |
| | 89 | }}} |
| | 90 | {{{#!td |
| | 91 | NC_BYTE |
| | 92 | }}} |
| | 93 | {{{#!td |
| | 94 | {{{_FillValue=-127b}}}(*)\\{{{coordinates}}}\\{{{grid_mapping}}}\\{{{long_name="building type classification"}}}\\{{{res_orig}}}\\{{{source}}}\\{{{units="1"}}} |
| | 95 | }}} |
| | 96 | {{{#!td |
| | 97 | Building type used to select bulk parameters. ''building_type'' is required if the [wiki:doc/app/usmpar urban-surface model] or the [#indoor_model indoor_model] are applied. Please note, ''building_type'' must not contain any {{{_FillValue}}} at grid points where ''buildings_2d''/''buildings_3d'' is defined.\\ |
| | 98 | {{{#!td |
| | 99 | ||= ''building_type'' =||= Description (use, age) =|| |
| | 100 | || 0|| User_defined according to ''building_pars''|| |
| | 101 | || 1|| Residential, < 1950|| |
| | 102 | || 2|| Residential, 1950 - 2000|| |
| | 103 | || 3|| Residential, > 2000|| |
| | 104 | || 4|| Office, < 1950|| |
| | 105 | || 5|| Office, 1950 - 2000|| |
| | 106 | || 6|| Office, > 2000|| |
| | 107 | }}} |
| | 108 | }}} |
| | 109 | |
| | 110 | |
| | 111 | |
