Static Driver#

Global Attributes#

Attribute SI-Unit Description
origin_lat degree Geographical latitude in degrees north.
origin_lon degree Geographical longitude in degrees west.
origin_x m E-UTM coordinate of the respective UTM zone.
origin_y m N-UTM coordinate of the respective UTM zone.
origin_z m z-coordinate of the bottom model boundary.
rotation_angle degrees rotation angle of the model domain.


origin_lat#

SI-Unit: degree
Datatype: NC_FLOAT

Mandatory: True

Geographical latitude in degrees north.

This attribute defines latitude of the south border of the model domain. origin_lat overwrites the value given by namelist parameter latitude. origin_lat affects the Coriolis parameter and the incoming radiation.


origin_lon#

SI-Unit: degree
Datatype: NC_FLOAT

Mandatory: True

Geographical longitude in degrees west.

This attribute defines longitude of the west border of the model domain. origin_lon overwrites the value given by namelist parameter longitude. origin_lon affects the incoming radiation.


origin_x#

SI-Unit: m
Datatype: NC_FLOAT

Mandatory: True

E-UTM coordinate of the respective UTM zone.

This attribute defines E-UTM coordinate of the west border of the model domain. Meaningful values of origin_x are necessary for correct placement of virtual sensors (see namelist #virtual_measurement_parameters) or moving emissions (see emis_nonstationary) which are also provided in UTM coordinates.


origin_y#

SI-Unit: m
Datatype: NC_FLOAT

Mandatory: True

N-UTM coordinate of the respective UTM zone.

This attribute defines N-UTM coordinate of the south border of the model domain. Meaningful values of origin_y are necessary for correct placement of virtual sensors (see namelist virtual_measurement_parameters) or moving emissions (see emis_nonstationary) which are also provided in UTM coordinates.


origin_z#

SI-Unit: m
Datatype: NC_FLOAT

Mandatory: True

z-coordinate of the bottom model boundary.

This attribute defines z-coordinate of the bottom model boundary. At the moment this attribute is only informative and does not affect any action in the model.


rotation_angle#

SI-Unit: degrees
Datatype: NC_FLOAT

Mandatory: True

rotation angle of the model domain.

This attribute defines the clockwise rotation angle of the model domain. rotation_angle is considered in the Coriolis term as well as for the the incoming radiation to consider correct shading. rotation_angle overwrites the value given by namelist parameter rotation_angle.


Dimensions#

Dimension Size Description
cct_dim_vertex_coords 4 dimension for special coordinates used in ray-tracing algorithm
cct_dim_vertex_shifts 1 dimension for special coordinates used in ray-tracing algorithm
cct_max_num_vertices_per_face 7 maximum number of vertices in cut cell-polygon (fixed to 7)
cct_num_faces Value of total number of cut-cell faces number of cut-cell faces
cct_num_vert Value of total number of cut-cell vertices number of unique vertices in cut cell polygons
dim_3d 3 dimension of z, y ,x coordinates (fixed to 3)
nalbedo_pars 7 Number of different surface albedo parameters that can be addressed.
nbuilding_general 2 Number of general building parameters.
nbuilding_indoor 19 Number of indoor building parameters.
nbuilding_surface_layer 4 Number of wall layers in the building-surface model (see urban_surface_parameters).
nbuilding_surface_level 3 Number of different considered building levels.
nbuilding_surface_pars 19 Number of different building parameters that can be prescribed.
nbuilding_surface_type 9 Number of different surface types that can be adressed.
npavement_pars 4 Number of different pavement parameters that can be addressed.
npavement_subsurface_pars 2 Number of different subsurface pavement parameters that can be addressed.
ns Value of Number of building surface elements. Number of building surface elements.
nsoil_pars 8 Number of different soil paramenters that can be adressed.
nvegetation_pars 12 Number of different surface vegetation parameters that can be addressed.
nwater_pars 7 Number of different surface water parameters that can be addressed.
x Value of namelist parameter nx+1 Number of grid points along x.
y Value of namelist parameter ny+1 Number of grid points along y.
z Value of Index value of highest building grid point. Number of grid points along z.
zlad Value of Index value of highest resolved vegetation grid point. Maximum number of grid points over which a vegetation layer vertically extends.
zsoil Value of Index value of deepest soil grid point. Number of grid points in a vertical soil column.


cct_dim_vertex_coords#

Size: 4

Mandatory: False

dimension for special coordinates used in ray-tracing algorithm

Required for cut-cell topography.


cct_dim_vertex_shifts#

Size: 1

Mandatory: False

dimension for special coordinates used in ray-tracing algorithm

Required for cut-cell topography.


cct_max_num_vertices_per_face#

Size: 7

Mandatory: False

maximum number of vertices in cut cell-polygon (fixed to 7)

Required for cut-cell topography.


cct_num_faces#

Size: Value of total number of cut-cell faces

Mandatory: False

number of cut-cell faces

Mandatory if cut-cell topography is defined.


cct_num_vert#

Size: Value of total number of cut-cell vertices

Mandatory: False

number of unique vertices in cut cell polygons

Required for cut-cell topography.


dim_3d#

Size: 3

Mandatory: False

dimension of z, y ,x coordinates (fixed to 3)

Required for cut-cell topography.


nalbedo_pars#

Size: 7

Mandatory: False

Number of different surface albedo parameters that can be addressed.

Respective indices are related to quantities as indicated in the list below. Used by variable albedo_pars.

Index Description
0 broadband albedo of surface elements
1 for buildings only: direct/diffuse longwave albedo of wall fraction
2 for buildings only: direct/diffuse shortwave albedo of wall fraction
3 for buildings only: direct/diffuse longwave albedo of green fraction
4 for buildings only: direct/diffuse shortwave albedo of green fraction
5 for buildings only: direct/diffuse longwave albedo of window fraction
6 for buildings only: direct/diffuse shortwave albedo of window fraction


nbuilding_general#

Size: 2

Mandatory: False

Number of general building parameters.

Respective indices are related to quantities as indicated in the list below. Used by variable building_general.

Index Description Unit
0 ground-floor level height m
1 green type of roof (1 intensive, 2 extensive)


nbuilding_indoor#

Size: 19

Mandatory: False

Number of indoor building parameters.

Respective indices are related to quantities as indicated in the list below. Used by variable building_indoor. For a further description of parameters please also see Pfafferott et al. (2021).

Index Description Unit
0 indoor target summer temperature K
1 indoor target winter temperature K
2 shading factor
3 g-value windows
4 u-value windows W m-2 K-1
5 basic airflow without occupancy of the room for - summer 0.5_wp, winter 0.5 h-1
6 additional airflow dependent on occupancy of the room for - summer 1.5_wp, winter 0.0 h-1
7 heat recovery efficiency
8 weighting factor to link facade surface area with indoor wall surface area
9 weighting factor to link facade surface area with indoor heat storage capacity J m-2 K-1
10 ratio internal surface/floor area
11 maximum heating capacity W
12 maximum cooling capacity W
13 additional internal heat gains during occupancy of the room W m-2
14 basic internal heat gains without occupancy of the room W m-2
15 storey height m
16 ceiling construction height m
17 anthropogenic waste-heat coeefficent from heating (0 for district heating, >0 for boilers, <0 for heat pumps)
18 anthropogenic waste-heat coefficient from cooling (>0 if cooling system installed)


nbuilding_surface_layer#

Size: 4

Mandatory: False

Number of wall layers in the building-surface model (see urban_surface_parameters).

Respective indices are related to quantities as indicated in the list below. Used by variable building_heat_capacity, building_heat_conductivity and building_thickness.

Index Description
0 first (outermost) wall layer
1 second wall layer
2 third wall layer
3 fourth wall layer


nbuilding_surface_level#

Size: 3

Mandatory: False

Number of different considered building levels.

Respective indices are related to specific surfaces as indicated in the list below. Used by variable building_lai, building_roughness_length, building_roughness_length_qh and building_transmissivity.

Index Description
0 vertical surface - ground-floor level
1 vertical surface - above ground-floor level
2 roof


nbuilding_surface_pars#

Size: 19

Mandatory: False

Number of different building parameters that can be prescribed.

Respective indices are related to quantities as indicated in the list below. Used by variable building_surface_pars.

Index Description Unit
0 wall fraction
1 window fraction
2 green fraction on wall
3 green fraction on roof
4 leaf area index of green fraction m2/m2
5 heat capacity of first (outermost) wall layer J m-2 K-1
6 heat capacity of second wall layer J m-2 K-1
7 heat capacity of third wall layer J m-2 K-1
8 thermal conductivity of first (outermost) wall layer W m-1 K-1
9 thermal conductivity of second wall layer W m-1 K-1
10 thermal conductivity of third wall layer W m-1 K-1
11 indoor target summer temperature K
12 indoor target winter temperature K
13 emissivity of wall fraction
14 emissivity of green fraction
15 emissivity of window fraction
16 transmissivity of window fraction
17 roughness length for momentum m
18 roughness length for heat and moisture m


nbuilding_surface_type#

Size: 9

Mandatory: False

Number of different surface types that can be adressed.

Respective indices are related to quantities as indicated in the list below. Used by variable building_albedo_type, building_emissivity, building_fraction, building_heat_capacity, building_heat_conductivity, building_thickness, and building_transmissivity.

Index Description
0 wall surface - ground-floor level
1 wall surface - above ground-floor level
2 wall surface - roof
3 window surface - ground-floor level
4 window surface - above ground-floor level
5 window surface - roof
6 green surface - ground-floor level
7 green surface - above ground-floor level
8 green surface - roof


npavement_pars#

Size: 4

Mandatory: False

Number of different pavement parameters that can be addressed.

Respective indices are related to quantities as indicated in the list below. Used by variable pavement_pars.

Index Description Unit
0 roughness length for momentum m
1 roughness length for heat m
2 albedo type
3 surface emissivity


npavement_subsurface_pars#

Size: 2

Mandatory: False

Number of different subsurface pavement parameters that can be addressed.

Respective indices are related to quantities as indicated in the list below. Used by variable pavement_subsurface_pars.

Index Description Unit
0 thermal conductivity of the respective sub surface pavement layer W m-1 K-1
1 volumetric heat capacity of the respective soil layer J m-3 K-1


ns#

Size: Value of Number of building surface elements.

Mandatory: False

Number of building surface elements.

Serves as a dimension for variables which describes index number, position and orientation of the individual surfaces. Mandatory if building_surface_pars is used.


nsoil_pars#

Size: 8

Mandatory: False

Number of different soil paramenters that can be adressed.

Respective indices are related to quantities as indicated in the list below. Used by variable soil_pars.

Index Description Unit
0 Van Genuchten parameter α
1 Van Genuchten parameter l
2 Van Genuchten parameter n
3 saturation hydraulic conductivity m s-1
4 saturation soil moisture m3 m-3
5 field capacity m3 m-3
6 wilting point m3 m-3
7 residual moisture m3 m-3


nvegetation_pars#

Size: 12

Mandatory: False

Number of different surface vegetation parameters that can be addressed.

Respective indices are related to quantities as indicated in the list below. Used by variable vegetation_pars.

Index Description Unit
0 minimum canopy resistance s m-1
1 leaf area index m2 m-2
2 vegetation coverage
3 canopy resistance coefficient hPa-1
4 roughness length for momentum m
5 roughness length for heat m
6 heat transfer coefficient between skin layer and earth surface (stable conditions) W m-2 K-1
7 heat transfer coefficient between skin layer and earth surface (unstable conditions) W m-2 K-1
8 shortwave radiation fraction transmitted to soil (not implemented)
9 heat capacity of the surface J m-2 K-1
10 albedo_type
11 surface emissivity


nwater_pars#

Size: 7

Mandatory: False

Number of different surface water parameters that can be addressed.

Respective indices are related to quantities as indicated in the list below. Used by variable water_pars.

Index Description Unit
0 water temperature K
1 roughness length for momentum m
2 roughness length for heat m
3 heat transfer coefficient between skin layer and water (stable conditions) W m-2 K-1
4 heat transfer coefficient between skin layer and water (unstable conditions) W m-2 K-1
5 albedo_type (for values see albedo_type)
6 surface emissivity


x#

Size: Value of namelist parameter nx+1

Mandatory: True

Number of grid points along x.

The number of grid points along x must match nx + 1, with nx as given in the initialization parameters namelist. x coordinates of the grid points can be given via variable x.


y#

Size: Value of namelist parameter ny+1

Mandatory: True

Number of grid points along y.

The number of grid points along y must match ny + 1, with ny as given in the initialization parameters namelist. y coordinates of the grid points can be given via variable y.


z#

Size: Value of Index value of highest building grid point.

Mandatory: False

Number of grid points along z.

The number of grid points along z for mapping buildings, used in buildings_3d. Note, that z must start at zero height.


zlad#

Size: Value of Index value of highest resolved vegetation grid point.

Mandatory: False

Maximum number of grid points over which a vegetation layer vertically extends.

The z-coordinates in m, relative above the ground, of the vegetation grid points can be given via variable zlad. Used in lad, bad, and tree_id. Note, that zlad must start at zero height, and that tree_id is currently not realized / not read from the driver.


zsoil#

Size: Value of Index value of deepest soil grid point.

Mandatory: False

Number of grid points in a vertical soil column.

The z-coordinates in m (positive downward) of the soil grid points can be given via variable zsoil. Used in soil_type, pavement_subsurface_pars, root_area_dens_r, and root_area_dens_s.


Variables#

Variable Shape Description
albedo_pars ('nalbedo_pars', 'y', 'x') x-y specific settings for surface albedo.
albedo_type ('y', 'x') x-y specific settings for albedo type.
azimuth ('ns',) Azimuth angle (orientation) of surface element.
bad ('zlad', 'y', 'x') Basal area density (BAD) in m² per m³ grid volume
building_albedo_type ('nbuilding_surface_type', 'y', 'x') x-y specific setting of building albedo type.
building_emissivity ('nbuilding_surface_type', 'y', 'x') x-y specific setting of building emissivity.
building_fraction ('nbuilding_surface_type', 'y', 'x') x-y specific setting of building fractions.
building_general ('nbuilding_general', 'y', 'x') x-y specific setting of general building parameters.
building_heat_capacity ('nbuilding_surface_type', 'nbuilding_surface_layer', 'y', 'x') x-y specific setting of heat capacity of building surfaces.
building_heat_conductivity ('nbuilding_surface_type', 'nbuilding_surface_layer', 'y', 'x') x-y specific setting of thermal conductivity of building surfaces.
building_id ('y', 'x') Building ID to identify single building envelopes.
building_indoor ('nbuilding_indoor', 'y', 'x') x-y specific setting of building indoor parameters.
building_lai ('nbuilding_surface_level', 'y', 'x') x-y specific setting of leaf-area index at green fraction of building surfaces.
building_roughness_length ('nbuilding_surface_level', 'y', 'x') x-y specific setting of roughness length for momentum at building surfaces.
building_roughness_length_qh ('nbuilding_surface_level', 'y', 'x') x-y specific setting of roughness length for heat and moisture at building surfaces.
building_surface_pars ('nbuilding_surface_pars', 'ns') Surface specific setting of various building parameters.
building_thickness ('nbuilding_surface_type', 'nbuilding_surface_layer', 'y', 'x') x-y specific setting of building wall-layer thicknesses.
building_transmissivity ('nbuilding_surface_level', 'y', 'x') x-y specific setting of transmissivity of windows at building surfaces.
building_type ('y', 'x') Building type used to select bulk parameters.
buildings_2d ('y', 'x') Building height in m relative to the underlying terrain.
buildings_3d ('z', 'y', 'x') Grid-volume based description of 3d-building topology.
cct_building_id_classification ('cct_num_faces',) Cut-cell topography specific surface definition for building ids.
cct_building_type_classification ('cct_num_faces',) Cut-cell topography specific surface definition for buildings.
cct_face_area ('cct_num_faces',) Area of cut-cell surface.
cct_face_center ('dim_3d', 'cct_num_faces') Positions of cut-cell surface mass center (z,y,x).
cct_face_normal_vector ('dim_3d', 'cct_num_faces') (z,y,x) component of normalized normal vector.
cct_num_vertices_per_face ('cct_num_faces',) Number of vertices in each face.
cct_offsets ('dim_3d', 'cct_num_faces') (k,j,i) offset of cut-cell surface.
cct_pavement_type_classification ('cct_num_faces',) Cut-cell topography specific surface definition for pavement.
cct_surface_type_classification ('cct_num_faces',) Surface classification.
cct_vegetation_type_classification ('cct_num_faces',) Cut-cell topography specific surface definition for vegetation.
cct_vertex_coords ('cct_dim_vertex_coords', 'cct_num_vert') Type of vertices coordinates for radiation module.
cct_vertex_shifts ('cct_dim_vertex_shifts', 'cct_num_vert') Type of vertices coordinates for radiation module.
cct_vertices ('dim_3d', 'cct_num_vert') (z;y;x) coordinates of vertices.
cct_vertices_per_face ('cct_max_num_vertices_per_face', 'cct_num_faces') List of vertices for each cut-cell surface face.
cct_water_type_classification ('cct_num_faces',) Cut-cell topography specific surface definition for water.
cct_3d_grid_indices ('dim_3d', 'cct_num_faces') (k,j,i) location of cut-cell surfaces.
lad ('zlad', 'y', 'x') Leaf area density (LAD) in m2 per m-3 grid volume.
pavement_pars ('npavement_pars', 'y', 'x') Grid point specific settings for pavement surfaces.
pavement_subsurface_pars ('npavement_subsurface_pars', 'zsoil', 'y', 'x') Grid point specific settings for pavement subsurfaces.
pavement_type ('y', 'x') Bulk classification of pavements on soil.
qsws ('y', 'x') Surface latent heat flux, constant with time.
root_area_dens_r ('zsoil', 'y', 'x') Root distribution in the soil in terms of a root fraction (for resolved vegetation).
root_area_dens_s ('zsoil', 'y', 'x') Root distribution in the soil in terms of a root fraction (for non-resolved vegetation).
shf ('y', 'x') Surface sensible heat flux, constant with time.
soil_type ('[zsoil]', 'y', 'x') Bulk classification of soil in terms of porosity.
soil_pars ('[zsoil]', 'y', 'x') Grid point specific settings of surface properties.
ssws ('y', 'x') Surface passive scalar flux, constant with time.
street_crossing ('y', 'x') Positions of street crossings that can be used by pedestrians.
street_type ('y', 'x') Classification of streets, closely following the Open Street Map classification.
tree_type ('zlad', 'y', 'x') Tree type for each grid volume.
vegetation_pars ('nvegetation_pars', 'y', 'x') Grid point specific settings for vegetation surfaces.
vegetation_type ('y', 'x') Bulk classification of flat vegetation surfaces and natural surface types.
water_pars ('water_pars', 'y', 'x') Grid point specific settings of water parameters.
water_type ('y', 'x') Bulk classification of water bodies.
x ('x',) Distance along x-axis to the left border of the model domain.
xs ('ns',) Distance of building surface element to the left border of the model domain.
y ('y',) Distance along y-axis to the south border of the model domain.
ys ('ns',) Distance of building surface element to the south border of the model domain.
z ('z',) Distance along z-axis to the bottom of the model domain.
zenith ('ns',) Zenith angle (orientation) of surface element.
zlad ('zlad',) Distance of resolved vegetation to the ground (surface).
zs ('ns',) Distance of building surface element to the bottom border of the model domain.
zsoil ('zsoil',) Distance along z from the surface for the respective soil grid point (always positive).
zt ('y', 'x') Terrain height relative to the reference height above sea level.
z0 ('y', 'x') Roughness length for momentum.


albedo_pars#

Shape: ('nalbedo_pars', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter albedo_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific settings for surface albedo.

First dimension is used to specify the various surface fractions (wall, green, window) and wavelength (broadband, longwave, shortwave) for which the albedo is set. For details, see table for nalbedo_pars.


albedo_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter albedo_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific settings for albedo type.

This input variable controls the setting of the surface albedos for broadband/longwave/shortwave. Depending on its value (1-42), albedos from the following list of predefined land surface types will be used.

For radiation_scheme = 'rrtmg' the broadband albedo is ignored and only the shortwave and longwave albedo values are used. In fact, not the values from the list will be used (they are for a solar zenith angle of 60°), but albedos will be calculated from that based on the current solar angle (wich varies in the course of the day).

For radiation_scheme = 'clear-sky', only the broadband albedo is used.

The setting of albedo_type overwrites namelist parameter albedo_type as well as the albedo type given by predefined parameter lists for pavement_type, vegetation_type and water_type.

Type Description broadband longwave shortwave Notes
1 ocean 0.06 0.06 0.06
2 mixed farming, tall grassland 0.19 0.28 0.09
3 tall/medium grassland 0.23 0.33 0.11
4 evergreen shrubland 0.23 0.33 0.11
5 short grassland/meadow/shrubland 0.25 0.34 0.14
6 evergreen needleleaf forest 0.14 0.22 0.06
7 mixed deciduous forest 0.17 0.27 0.06
8 deciduous forest 0.19 0.31 0.06
9 tropical evergreen broadleaved forest 0.14 0.22 0.06
10 medium/tall grassland/woodland 0.18 0.28 0.06
11 desert, sandy 0.43 0.51 0.35
12 desert, rocky 0.32 0.40 0.24
13 tundra 0.19 0.27 0.10
14 land ice 0.77 0.65 0.90 land ice is treated differently than sea ice
15 sea ice 0.77 0.65 0.90
16 snow 0.82 0.70 0.95
17 bare soil 0.08 0.08 0.08
18 asphalt/concrete mix 0.17 0.17 0.17 dummy values
19 asphalt (asphalt concrete) 0.17 0.17 0.17 dummy values
20 concrete (Portland concrete) 0.30 0.30 0.30 dummy values
21 sett 0.17 0.17 0.17 dummy values
22 paving stones 0.17 0.17 0.17 dummy values
23 cobblestone 0.17 0.17 0.17 dummy values
24 metal 0.17 0.17 0.17 dummy values
25 wood 0.17 0.17 0.17 dummy values
26 gravel 0.17 0.17 0.17 dummy values
27 fine gravel 0.17 0.17 0.17 dummy values
28 pebblestone 0.17 0.17 0.17 dummy values
29 woodchips 0.17 0.17 0.17 dummy values
30 tartan (sports) 0.17 0.17 0.17 dummy values
31 artificial turf (sports) 0.17 0.17 0.17 dummy values
32 clay (sports) 0.17 0.17 0.17 dummy values
33 building (dummy) 0.17 0.17 0.17 dummy values
34 building wall reflective 0.60 0.60 0.60
35 building wall (very) bright) 0.30 0.30 0.30
36 building wall standard 0.07 0.07 0.07
37 building window double layer glazing 0.12 0.12 0.12
38 building window tripple layer glazing 0.17 0.18 0.18
39 building window reflective 0.48 0.48 0.48
40 building roof reflective 0.60 0.60 0.60
41 building roof (very) bright 0.30 0.30 0.30
42 building roof standard 0.07 0.07 0.07


azimuth#

Shape: ('ns',)
Datatype: NC_FLOAT
Default: -9999.0
SI-Unit: degrees
Mandatory: False

Attributes: _FillValue (mandatory)

Azimuth angle (orientation) of surface element.

This variable describes the orientation of the surface element along the azimuth angle at given xs, ys and zs.

Currently 5 choices are available:

  • -9999.0

    upward- or downward-facing

  • 0.0

    northward-facing

  • 90.0

    eastward-facing

  • 180.0

    southward-facing

  • 270.0

    westward-facing


bad#

Shape: ('zlad', 'y', 'x')
Datatype: NC_FLOAT
Default: 0.0
SI-Unit: m2 m-3
Mandatory: False

Attributes: _FillValue (mandatory)

Basal area density (BAD) in m² per m³ grid volume

Representing the area of trunk and branches within the respective grid volume. The dimension zlad can be limited to the maximum canopy height.


building_albedo_type#

Shape: ('nbuilding_surface_type', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of building albedo type.

Values are set for all building walls located at this x-y location. See table of nbuilding_surface_type for allowed values. The prescribed values are then used to set specific values of broadband, long- and shortwave albedo according to the values described under albedo_type. Setting of building_albedo_type overwrites values given by albedo_type at building surfaces. Note, even though building_albedo_type is of type NC_FLOAT, only multiple integer values can be assigned. Setting specific paramters in building_albedo_type overwrites settings defined by building_type.


building_emissivity#

Shape: ('nbuilding_surface_type', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of building emissivity.

See table for nbuilding_surface_type. Setting specific paramters in building_emissivity overwrites settings defined by building_type.


building_fraction#

Shape: ('nbuilding_surface_type', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of building fractions.

First dimension is used to specify the different surface type (wall, green, window, at ground floor level, above ground floor level, and at the roof) for which the fraction is set, that this surface type has with respect to the total building surface at this point. Values are set for all building surfaces located at this x-y location. See table for nbuilding_surface_type. Setting specific parameters in building_fraction overwrites settings defined by building_type.


building_general#

Shape: ('nbuilding_general', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of general building parameters.

First dimension is used to specify the specific general building parameter to be set. Values are set for all building surfaces located at this x-y location. See table for nbuilding_general. Setting specific paramters in building_general overwrites settings defined by building_type.


building_heat_capacity#

Shape: ('nbuilding_surface_type', 'nbuilding_surface_layer', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
SI-Unit: J m-3 K-1
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of heat capacity of building surfaces.

First dimension is used to specify the different surface type (wall, green, window, at ground floor level, above ground floor level, and at the roof) for which the heat capacity is set. Values are set for all building walls located at this x-y location. See table for nbuilding_surface_type. The second dimension is used to specify the respective wall layer (see table for nbuilding_surface_layer). Setting specific paramters in building_heat_capacity overwrites settings defined by building_type.


building_heat_conductivity#

Shape: ('nbuilding_surface_type', 'nbuilding_surface_layer', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
SI-Unit: W m-1 K-1
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of thermal conductivity of building surfaces.

First dimension is used to specify the different surface type (wall, green, window, at ground floor level, above ground floor level, and at the roof) for which the thermal conductivity is set. Values are set for all building walls located at this x-y location. See table for nbuilding_surface_type. The second dimension is used to specify the respective wall layer (see table for nbuilding_surface_layer). Setting specific paramters in building_heat_conductivity overwrites settings defined by building_type.


building_id#

Shape: ('y', 'x')
Datatype: NC_INT
Default: 0
Mandatory: False

Attributes: _FillValue (mandatory)

Building ID to identify single building envelopes.

Used to identify single building envelopes which are composed of a number of grid volumes, and which is used for correct mapping of buildings on top of the underlying terrain, as well as for the indoor model. All grid volumes with the same ID are considered to belong to the same building. Note, building_id must not contain any _FillValue at grid points where buildings are defined via buildings_2d or buildings_3d. There is no range or limitation for the ID numbers, except that each building must have a unique number which needs to fit into the range of a 32-bit integer variable (i.e. -2147483647 to +2147483647).


building_indoor#

Shape: ('nbuilding_indoor', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of building indoor parameters.

First dimension is used to specify respective building indoor parameters for which values are set. Values are set for all building volumes located at this x-y location. See table for nbuilding_indoor. Setting specific paramters in building_indoor overwrites settings defined by building_type.


building_lai#

Shape: ('nbuilding_surface_level', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of leaf-area index at green fraction of building surfaces.

First dimension is used to specify the different building surfaces (at ground floor level, above ground floor level, and at the roof) for which the leaf area index of the green fraction is set. Values are set for all building walls located at this x-y location. See table for nbuilding_surface_level. Setting specific paramters in building_lai overwrites settings defined by building_type.


building_roughness_length#

Shape: ('nbuilding_surface_level', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of roughness length for momentum at building surfaces.

First dimension is used to specify the different building surfaces (at ground floor level, above ground floor level, and at the roof) for which the roughness length for momentum is set. Values are set for all building walls located at this x-y location. See table for nbuilding_surface_level. Setting specific paramters in building_roughness_length overwrites settings defined by building_type.


building_roughness_length_qh#

Shape: ('nbuilding_surface_level', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of roughness length for heat and moisture at building surfaces.

First dimension is used to specify the different building surfaces (at ground floor level, above ground floor level, and at the roof) for which the roughness length for heat and moisture is set. Values are set for all building walls located at this x-y location. See table for nbuilding_surface_level. Setting specific paramters in building_roughness_length_qh overwrites settings defined by building_type.


building_surface_pars#

Shape: ('nbuilding_surface_pars', 'ns')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

Surface specific setting of various building parameters.

The variable is used to assign building parameters for individual surfaces at a number of locations (points) ns (second dimension). The location and orientation of these surfaces need to be specified by xs, ys, and zs, as well as azimuth and zenith. The first dimension is used to specify the specific building surface parameter to be set. See table for nbuilding_surface_pars.

Building parameters given by other input variables, i.e. building_lai, building_roughness_length, building_roughness_length_qh, building_transmissivity, building_indoor, building_heat_capacity, building_heat_conductivity, or building_fraction, will be overwritten by building_surface_pars.


building_thickness#

Shape: ('nbuilding_surface_type', 'nbuilding_surface_layer', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of building wall-layer thicknesses.

First dimension is used to specify the different surface type (wall, green, window, at ground floor level, above ground floor level, and at the roof) for which the thickness of the layer is set. Values are set for all building walls located at this x-y location. See table for nbuilding_surface_type. The second dimension is used to specify the respective wall layer (see table for nbuilding_surface_layer). Setting specific paramters in building_thickness overwrites settings defined by building_type.


building_transmissivity#

Shape: ('nbuilding_surface_level', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

x-y specific setting of transmissivity of windows at building surfaces.

First dimension is used to specify the different building surfaces (at ground floor level, above ground floor level, and at the roof) for which the transmissivity of the window fraction is set. Values are set for all building walls located at this x-y location. See table for nbuilding_surface_level. Setting specific paramters in building_transmissivity overwrites settings defined by building_type.


building_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: Depends on namelist parameter building_type
Mandatory: False

Attributes: _FillValue (mandatory)

Building type used to select bulk parameters.

The building_type is used to define buildings by year of construction and bulding use, as specified via namelist parameter building_type. The different building_types are linked to predefined bulk parameters for the fractions and physical properties of the building envelope, the individual components, and the exchange processes with the indoor environment. The building_type is required if the urban surface model or the indoor model are applied. Note, building_type must not contain any _FillValue at grid points where a building is defined via buildings_2d or buildings_3d. Setting of building_type = 0 in the static file is not allowed. To further specify building parameters and overwrite the building_type bulk paramaters, set the respective building_albedo_type, building_emissivity, building_fraction, building_general, building_heat_capacity, building_heat_conductivity, building_indoor, building_lai, building_roughness_length, building_roughness_length_qh, building_thickness, and building_transmissivity. The previous parameter lists will replace the soon to be deprecated building_pars (link unavailable!), which are currently active.

Currently 1 choices are available:


buildings_2d#

Shape: ('y', 'x')
Datatype: NC_FLOAT
Default: 0.0
SI-Unit: m
Mandatory: False

Attributes: _FillValue (mandatory)

Building height in m relative to the underlying terrain.

Two-dimensional building topology relative to the underlying terrain, i.e. assuming a flat surface at z=0. No holes or overhanging structures are possible. A building with ID given by building_id will be mounted on top of the maximum local terrain height that appears within the ground area covered by that building. Note, buildings_2d will not be used if buildings_3d is present on file as well. If buildings_2d is given, building_id is required, too. Note, buildings_2d requires topography = 'read_from_file'.


buildings_3d#

Shape: ('z', 'y', 'x')
Datatype: NC_BYTE
Default: 0
Mandatory: False

Attributes: _FillValue (mandatory)

Grid-volume based description of 3d-building topology.

Arbitrary three-dimensional building topology relative to the underlying terrain, i.e. assuming a flat surface at z=0. A building with ID given by building_id will be mounted on top of the maximum local terrain height that appears within the ground area covered by that building. Note, the 3d-array buildings_3d does not need to be defined and set beyond the top level of the highest buildings, i.e. the z dimension can me minimized accordingly. If buildings_3d is given, building_id is required, too. Note, buildings_3d requires topography = 'read_from_file'.

Currently 2 choices are available:

  • 0

    Grid volume is not occupied by a building.

  • 1

    Grid volume is occupied by a building.


cct_building_id_classification#

Shape: ('cct_num_faces',)
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Cut-cell topography specific surface definition for building ids.

For allowed values and more information see building_id. Required for cut-cell topography.


cct_building_type_classification#

Shape: ('cct_num_faces',)
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Cut-cell topography specific surface definition for buildings.

For allowed values and more information see building_type. Required for cut-cell topography.


cct_face_area#

Shape: ('cct_num_faces',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m2
Mandatory: False

Attributes: _FillValue (mandatory)

Area of cut-cell surface.

Required for cut-cell topography.


cct_face_center#

Shape: ('dim_3d', 'cct_num_faces')
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m
Mandatory: False

Attributes: _FillValue (mandatory)

Positions of cut-cell surface mass center (z,y,x).

Required for cut-cell topography.


cct_face_normal_vector#

Shape: ('dim_3d', 'cct_num_faces')
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m
Mandatory: False

Attributes: _FillValue (mandatory)

(z,y,x) component of normalized normal vector.

Required for cut-cell topography.


cct_num_vertices_per_face#

Shape: ('cct_num_faces',)
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Number of vertices in each face.

Required for cut-cell topography.


cct_offsets#

Shape: ('dim_3d', 'cct_num_faces')
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

(k,j,i) offset of cut-cell surface.

Relates each surface to a building (required for setting properties). Required for cut-cell topography.


cct_pavement_type_classification#

Shape: ('cct_num_faces',)
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Cut-cell topography specific surface definition for pavement.

For allowed values and more information see pavement_type. Required for cut-cell topography.


cct_surface_type_classification#

Shape: ('cct_num_faces',)
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Surface classification.

Required for cut-cell topography.

Currently 4 choices are available:

  • 0

    Natural-type.

  • 1

    Building wall.

  • 2

    Building roof.

  • 3

    Default-type.


cct_vegetation_type_classification#

Shape: ('cct_num_faces',)
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Cut-cell topography specific surface definition for vegetation.

For allowed values and more information see vegetation_type. Required for cut-cell topography.


cct_vertex_coords#

Shape: ('cct_dim_vertex_coords', 'cct_num_vert')
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Type of vertices coordinates for radiation module.

Order: (k,j,i,dir), kji index of corner, dir direction: (0.+z, 1.-z, 2.+y, 3.-y, 4.+x, 5.-x). Required for cut-cell topography.


cct_vertex_shifts#

Shape: ('cct_dim_vertex_shifts', 'cct_num_vert')
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m
Mandatory: False

Attributes: _FillValue (mandatory)

Type of vertices coordinates for radiation module.

Order: (len), len distance (corner; vertex). Required for cut-cell topography.


cct_vertices#

Shape: ('dim_3d', 'cct_num_vert')
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m
Mandatory: False

Attributes: _FillValue (mandatory)

(z;y;x) coordinates of vertices.

Required for cut-cell topography.


cct_vertices_per_face#

Shape: ('cct_max_num_vertices_per_face', 'cct_num_faces')
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

List of vertices for each cut-cell surface face.

Ordered by right-hand-rule. Required for cut-cell topography.


cct_water_type_classification#

Shape: ('cct_num_faces',)
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Cut-cell topography specific surface definition for water.

For allowed values and more information see water_type. Required for cut-cell topography.


cct_3d_grid_indices#

Shape: ('dim_3d', 'cct_num_faces')
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

(k,j,i) location of cut-cell surfaces.

Required for cut-cell topography.


lad#

Shape: ('zlad', 'y', 'x')
Datatype: NC_FLOAT
Default: Value of namelist parameter lad_surface
SI-Unit: m2 m-3
Mandatory: False

Attributes: _FillValue (mandatory)

Leaf area density (LAD) in m2 per m-3 grid volume.

Representing the area of leafs within the respective grid volume for 3D resolved Vegetation. Note, the 3d-array lad does not need to be defined and set beyond the top level of the highest canopy, i.e. the zlad dimension can me minimized accordingly.


pavement_pars#

Shape: ('npavement_pars', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter pavement_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings for pavement surfaces.

Overwrites settings of pavement surface parameters defined by pavement_type at specified x-y locations. The first dimension is used to specify the specific pavement parameter to be set. For possible parameters see table of npavement_pars.


pavement_subsurface_pars#

Shape: ('npavement_subsurface_pars', 'zsoil', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter pavement_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings for pavement subsurfaces.

Pavement types not only have a surface property but also change the underlying soil layers. This parameter overwrites the prescribed setting of heat capacity and thermal conductivity defined by pavement_type at specified x-y location. See table for npavement_subsurface_pars for possible parameters. The number of pavement layers is fixed to a maximum of 8 levels.


pavement_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter pavement_type
Mandatory: False

Attributes: _FillValue (mandatory)

Bulk classification of pavements on soil.

Pavement type for each x-y location which is used to specify physical surface and material properties according to bulk parameters lists described in namelist parameter pavement_type. pavement_type overwrites the horizontally homogeneous setting done via the namelist parameter pavement_type. A soil type is required at all locations where a pavement_type is set and must not contain any _FillValues.

Please note that setting of pavement_type = 0 in the static file is not allowed. Pavement parameters defined via pavement_type can be further specified by pavement_pars and pavement_subsurface_pars.

Currently 1 choices are available:


qsws#

Shape: ('y', 'x')
Datatype: NC_FLOAT
Default: Value of namelist parameter surface_waterflux
SI-Unit: W m-2
Mandatory: False

Attributes: _FillValue (mandatory)

Surface latent heat flux, constant with time.

Note that input of qsws is only useful for default-type surfaces. In simulations with land surface model and urban surface model, qsws is overwritten, as the turbulent fluxes are calculated by energy balance solvers for the vegetation_type, pavement_type, building_type, and water_type surfaces. The unit of the input value must correspond to the setting given by flux_input_mode and can either be kg kg-1 m s-1 or W m-2.


root_area_dens_r#

Shape: ('zsoil', 'y', 'x')
Datatype: NC_FLOAT
Default: Value of namelist parameter root_fraction
Mandatory: False

Attributes: _FillValue (mandatory)

Root distribution in the soil in terms of a root fraction (for resolved vegetation).

Overwrites the horizontally homogeneous setting done by the namelist parameter root_fraction or the default setting based on vegetation_type with grid point specific settings for specified x,y,zsoil location.


root_area_dens_s#

Shape: ('zsoil', 'y', 'x')
Datatype: NC_FLOAT
Default: Value of namelist parameter root_fraction
Mandatory: False

Attributes: _FillValue (mandatory)

Root distribution in the soil in terms of a root fraction (for non-resolved vegetation).

Overwrites the horizontally homogeneous setting done by the namelist parameter root_fraction or the default setting based on vegetation_type with grid point specific settings for specified x,y,zsoil location.


shf#

Shape: ('y', 'x')
Datatype: NC_FLOAT
Default: Value of namelist parameter surface_heatflux
SI-Unit: K m s-1
Mandatory: False

Attributes: _FillValue (mandatory)

Surface sensible heat flux, constant with time.

Note that input of shf is only useful for default-type surfaces. In simulations with land surface model and urban surface model, shf is overwritten with flux values calculated by the energy balance solvers for the vegetation_type, pavement_type, building_type, and water_type surfaces. The unit of the input value must correspond to the setting given by flux_input_mode and can either be K m s-1 or W m-2.


soil_type#

Shape: ('[zsoil]', 'y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter soil_type
Mandatory: False

Attributes: _FillValue (mandatory)

Bulk classification of soil in terms of porosity.

soil_type overwrites the horizontally homogeneous setting done by the namelist parameter soil_type. A soil type is required at all locations where either a vegetation_type or a pavement_type is set. In case lod = 1, a 2-dimensional vertically uniform soil texture is prescribed, while for lod = 2 the 3-dimensional soil_type is additionally set for each vertical layer individually.

Please note, setting of soil_type = 0 in the static driver is not allowed. To further specify soil parameters, please set respective [soil_pars](#static--variable--soil_pars] in the static driver file.

Currently 1 choices are available:


soil_pars#

Shape: ('[zsoil]', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter soil_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings of surface properties.

soil_pars overwrites soil parameters defined by soil_type. In case lod = 1, soil parameters given for a specific x-y location are set at all soil layers, while for lod = 2 soil parameters can be specified for each soil layer separately. For possible parameters see table of nsoil_pars.


ssws#

Shape: ('y', 'x')
Datatype: NC_FLOAT
Default: Value of namelist parameter surface_scalarflux
SI-Unit: kg m (m-1 s-1)
Mandatory: False

Attributes: _FillValue (mandatory)

Surface passive scalar flux, constant with time.

Stationary surface passive scalar flux.


street_crossing#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: 0
Mandatory: False

Attributes: _FillValue (mandatory)

Positions of street crossings that can be used by pedestrians.

These street crossings comprise traffic lights and pedestrian crossings and are indicated by setting the value 1b.

Currently 1 choices are available:

  • 1

    Surface is occupied by a street crossing.


street_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: 0
Mandatory: False

Attributes: _FillValue (mandatory)

Classification of streets, closely following the Open Street Map classification.

street_type is required for application of the parameterized traffic emissions (see emission mode LOD 0 in chemistry_parameters) and for the multi-agent system.

Currently 19 choices are available:

  • 1

    unclassified

  • 2

    cycleway

  • 3

    footway / pedestrian

  • 4

    path

  • 5

    track

  • 6

    living street

  • 7

    service

  • 8

    residential

  • 9

    tertiary

  • 10

    tertiary link

  • 11

    secondary

  • 12

    secondary link

  • 13

    primary

  • 14

    primary link

  • 15

    trunk

  • 16

    trunk link

  • 17

    motorway

  • 18

    motorway link

  • 19

    raceway


tree_type#

Shape: ('zlad', 'y', 'x')
Datatype: NC_INT
Default: undefined
Mandatory: False

Attributes: _FillValue (mandatory)

Tree type for each grid volume.

Positive values indicate the tree species as defined in the tree type database (https://palm.muk.uni-hannover.de/trac/wiki/doc/app/iofiles/pids/palm_csd#Singletrees). Alternatively, if the species is unknown, the tree type contains the value of the corresponding vegetation_type (LSM Vegetation Type) using a minus sign to distinguish it from the tree species.


vegetation_pars#

Shape: ('nvegetation_pars', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter vegetation_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings for vegetation surfaces.

vegetation_pars overwrites the prescribed settings from vegetation_type with grid point (x-y) specific settings of vegetation parameters. The first dimension is used to specify the respective vegetation parameter to be set. See table of nvegetation_pars for possible parameters.


vegetation_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter vegetation_type
Mandatory: False

Attributes: _FillValue (mandatory)

Bulk classification of flat vegetation surfaces and natural surface types.

vegetation_type overwrites the horizontally homogeneous setting of non-resolved natural land surfaces done via the land surface namelist parameter vegetation_type. A soil_type is required at all locations where a vegetation_type is set and must not contain any _FillValues.

Please note that setting of vegetation_type = 0 in the static driver is not allowed. To further specify vegetation parameters, please set respective vegetation_pars in the static driver file.

Currently 1 choices are available:


water_pars#

Shape: ('water_pars', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter water_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings of water parameters.

water_pars overwrites the prescribed setting from water_type with grid point (x-y) specific settings. The first dimension is used to specify the respective water parameter to be set. See table of nwater_pars for possible parameters.


water_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter water_type
Mandatory: False

Attributes: _FillValue (mandatory)

Bulk classification of water bodies.

water_type overwrites the horizontally homogeneous setting of water surfaces done by the land surface namelist parameter water_type.

Please note, setting of water_type = *0 * in the static driver is not allowed. To further specify water parameters, please set respective water_pars in the static driver file.

Currently 1 choices are available:


x#

Shape: ('x',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m

Mandatory: False

Distance along x-axis to the left border of the model domain.

See also dimension x.


xs#

Shape: ('ns',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m

Mandatory: False

Distance of building surface element to the left border of the model domain.

See also dimension ns.


y#

Shape: ('y',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m

Mandatory: False

Distance along y-axis to the south border of the model domain.

See also dimension y.


ys#

Shape: ('ns',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m

Mandatory: False

Distance of building surface element to the south border of the model domain.

See also dimension ns.


z#

Shape: ('z',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m

Mandatory: False

Distance along z-axis to the bottom of the model domain.

See also dimension z.


zenith#

Shape: ('ns',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: degrees

Mandatory: False

Zenith angle (orientation) of surface element.

This variable describes the orientation of the respective surface element along the zenith angle at coordinates given by xs, ys and zs.

Currently 3 choices are available:

  • 0.0

    upward-facing

  • 90.0

    vertical

  • 180.0

    downward-facing


zlad#

Shape: ('zlad',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m

Mandatory: False

Distance of resolved vegetation to the ground (surface).

See also dimension zlad.


zs#

Shape: ('ns',)
Datatype: NC_FLOAT
Default: undefined
SI-Unit: m

Mandatory: False

Distance of building surface element to the bottom border of the model domain.

See also dimension ns.


zsoil#

Shape: ('zsoil',)
Datatype: NC_FLOAT
Default: Depends on namelist parameter dz_soil
SI-Unit: m

Mandatory: False

Distance along z from the surface for the respective soil grid point (always positive).

See also dimension zsoil.


zt#

Shape: ('y', 'x')
Datatype: NC_FLOAT
Default: 0.0
SI-Unit: m
Mandatory: False

Attributes: _FillValue (mandatory)

Terrain height relative to the reference height above sea level.

Terrain height in m relative to origin_z. If not provided, the relative terrain height will be set to 0 m all over the model domain. Note, zt must not contain any _FillValues.


z0#

Shape: ('y', 'x')
Datatype: NC_FLOAT
Default: Value of namelist parameter roughness_length
SI-Unit: m
Mandatory: False

Attributes: _FillValue (mandatory)

Roughness length for momentum.

Note that input of z0 is only useful for default-type surfaces. In simulations with land surface model and urban surface model, z0 will be overwritten by values that are implicitly set by vegetation_type, pavement_type, building_type, or water_type.


Variables (only for LSM)#

Variable Shape Description
pavement_pars ('npavement_pars', 'y', 'x') Grid point specific settings for pavement surfaces.
pavement_subsurface_pars ('npavement_subsurface_pars', 'zsoil', 'y', 'x') Grid point specific settings for pavement subsurfaces.
pavement_type ('y', 'x') Bulk classification of pavements on soil.
root_area_dens_s ('zsoil', 'y', 'x') Root distribution in the soil in terms of a root fraction (for non-resolved vegetation).
soil_type ('[zsoil]', 'y', 'x') Bulk classification of soil in terms of porosity.
soil_pars ('[zsoil]', 'y', 'x') Grid point specific settings of surface properties.
vegetation_pars ('nvegetation_pars', 'y', 'x') Grid point specific settings for vegetation surfaces.
vegetation_type ('y', 'x') Bulk classification of flat vegetation surfaces and natural surface types.
water_pars ('water_pars', 'y', 'x') Grid point specific settings of water parameters.
water_type ('y', 'x') Bulk classification of water bodies.
zsoil ('zsoil',) Distance along z from the surface for the respective soil grid point (always positive).


pavement_pars#

Shape: ('npavement_pars', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter pavement_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings for pavement surfaces.

Overwrites settings of pavement surface parameters defined by pavement_type at specified x-y locations. The first dimension is used to specify the specific pavement parameter to be set. For possible parameters see table of npavement_pars.


pavement_subsurface_pars#

Shape: ('npavement_subsurface_pars', 'zsoil', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter pavement_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings for pavement subsurfaces.

Pavement types not only have a surface property but also change the underlying soil layers. This parameter overwrites the prescribed setting of heat capacity and thermal conductivity defined by pavement_type at specified x-y location. See table for npavement_subsurface_pars for possible parameters. The number of pavement layers is fixed to a maximum of 8 levels.


pavement_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter pavement_type
Mandatory: False

Attributes: _FillValue (mandatory)

Bulk classification of pavements on soil.

Pavement type for each x-y location which is used to specify physical surface and material properties according to bulk parameters lists described in namelist parameter pavement_type. pavement_type overwrites the horizontally homogeneous setting done via the namelist parameter pavement_type. A soil type is required at all locations where a pavement_type is set and must not contain any _FillValues.

Please note that setting of pavement_type = 0 in the static file is not allowed. Pavement parameters defined via pavement_type can be further specified by pavement_pars and pavement_subsurface_pars.

Currently 1 choices are available:


root_area_dens_s#

Shape: ('zsoil', 'y', 'x')
Datatype: NC_FLOAT
Default: Value of namelist parameter root_fraction
Mandatory: False

Attributes: _FillValue (mandatory)

Root distribution in the soil in terms of a root fraction (for non-resolved vegetation).

Overwrites the horizontally homogeneous setting done by the namelist parameter root_fraction or the default setting based on vegetation_type with grid point specific settings for specified x,y,zsoil location.


soil_type#

Shape: ('[zsoil]', 'y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter soil_type
Mandatory: False

Attributes: _FillValue (mandatory)

Bulk classification of soil in terms of porosity.

soil_type overwrites the horizontally homogeneous setting done by the namelist parameter soil_type. A soil type is required at all locations where either a vegetation_type or a pavement_type is set. In case lod = 1, a 2-dimensional vertically uniform soil texture is prescribed, while for lod = 2 the 3-dimensional soil_type is additionally set for each vertical layer individually.

Please note, setting of soil_type = 0 in the static driver is not allowed. To further specify soil parameters, please set respective [soil_pars](#static--variable--soil_pars] in the static driver file.

Currently 1 choices are available:


soil_pars#

Shape: ('[zsoil]', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter soil_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings of surface properties.

soil_pars overwrites soil parameters defined by soil_type. In case lod = 1, soil parameters given for a specific x-y location are set at all soil layers, while for lod = 2 soil parameters can be specified for each soil layer separately. For possible parameters see table of nsoil_pars.


vegetation_pars#

Shape: ('nvegetation_pars', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter vegetation_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings for vegetation surfaces.

vegetation_pars overwrites the prescribed settings from vegetation_type with grid point (x-y) specific settings of vegetation parameters. The first dimension is used to specify the respective vegetation parameter to be set. See table of nvegetation_pars for possible parameters.


vegetation_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter vegetation_type
Mandatory: False

Attributes: _FillValue (mandatory)

Bulk classification of flat vegetation surfaces and natural surface types.

vegetation_type overwrites the horizontally homogeneous setting of non-resolved natural land surfaces done via the land surface namelist parameter vegetation_type. A soil_type is required at all locations where a vegetation_type is set and must not contain any _FillValues.

Please note that setting of vegetation_type = 0 in the static driver is not allowed. To further specify vegetation parameters, please set respective vegetation_pars in the static driver file.

Currently 1 choices are available:


water_pars#

Shape: ('water_pars', 'y', 'x')
Datatype: NC_FLOAT
Default: Depends on namelist parameter water_type
Mandatory: False

Attributes: _FillValue (mandatory)

Grid point specific settings of water parameters.

water_pars overwrites the prescribed setting from water_type with grid point (x-y) specific settings. The first dimension is used to specify the respective water parameter to be set. See table of nwater_pars for possible parameters.


water_type#

Shape: ('y', 'x')
Datatype: NC_BYTE
Default: Value of namelist parameter water_type
Mandatory: False

Attributes: _FillValue (mandatory)

Bulk classification of water bodies.

water_type overwrites the horizontally homogeneous setting of water surfaces done by the land surface namelist parameter water_type.

Please note, setting of water_type = *0 * in the static driver is not allowed. To further specify water parameters, please set respective water_pars in the static driver file.

Currently 1 choices are available:


zsoil#

Shape: ('zsoil',)
Datatype: NC_FLOAT
Default: Depends on namelist parameter dz_soil
SI-Unit: m

Mandatory: False

Distance along z from the surface for the respective soil grid point (always positive).

See also dimension zsoil.