Changes between Version 30 and Version 31 of doc/app/iofiles/pids/palm_csd
- Timestamp:
- Oct 29, 2021 7:03:54 PM (3 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
doc/app/iofiles/pids/palm_csd
v30 v31 54 54 55 55 ==== [settings] ==== 56 This section describes global parameters used to create the static driver. All following parameters are mandatory!56 This section describes global parameters used to create the static driver. 57 57 58 58 ||='''Variable''' =||='''Data type''' =||='''Default value''' =||='''Description''' =|| … … 66 66 || {{{lai_beta}}} || float || 3.0 || Parameter for reconstruction of vertical LAD profiles based on tree shape parameters (alpha, beta) and the integral leaf area index after Markkanen et al. (2003). This scheme is used for vegetation patches (parks, forests), where the canopy can be considered to be pseudo-1D and for which usually no information on individual trees is available. || 67 67 || {{{patch_height_default}}} || float || 10.0 || Default patch height (in m), which is used in the canopy generator to process canopy patches (parks, forests) for which data for individual trees is usually lacking. This parameter comes into affect for data gaps where no other vegetation height is available || 68 || {{{season}}} || string || "summer"|| As palm_csd can work with different sets of input data regarding leaf area index, this switch parameter can be set to either {{{summer}}} or {{{winter}}} to select the most suitable leaf area index input file to account for differences in leaf amount. Data for summer is usually from August (fully leaved), while data for winter is usually from April. ||68 || {{{season}}} || string || summer || As palm_csd can work with different sets of input data regarding leaf area index, this switch parameter can be set to either {{{summer}}} or {{{winter}}} to select the most suitable leaf area index input file to account for differences in leaf amount. Data for summer is usually from August (fully leaved), while data for winter is usually from April. || 69 69 || {{{vegetation_type_below_trees}}}|| integer || 3 || If trees are added to the static driver, the vegetation type below the tree volumes is changed to this value. || 70 70 … … 88 88 ||='''Variable''' =||='''Data type''' =||='''Default value''' =||='''Description''' =|| 89 89 || {{{path}}} || string || "" ||Directory where the output file shall be stored. Note that the static driver can - depending on model domain size - be quite large (in the order of several GB). || 90 || {{{file_out}}} || string || ||Output file name. The final output will be stored under {{{path}}}/{{{file_out}}}_{{{domain}}}, where {{{domain}}} will be "root" for the parent (root) domain, and "N01", "N02", etc., for child domains N01, N02, etc., respectively90 || {{{file_out}}}* || string || ||Output file name. The final output will be stored under {{{path}}}/{{{file_out}}}_{{{domain}}}, where {{{domain}}} will be "root" for the parent (root) domain, and "N01", "N02", etc., for child domains N01, N02, etc., respectively 91 91 || {{{version}}} || integer || "" ||User-specific setting to track updates of a static driver. This value will be added as global attribute to the static driver || 92 \* This parameter is mandatory 92 93 93 94 Example: … … 102 103 103 104 ||='''Variable''' =||='''Data type''' =||='''Description''' =|| 104 || {{{path}}} || string ||Directory where the NetCDF input files reside || 105 || {{{pixel_size}}} || float ||Horizontal grid spacing (m) of a surface pixel of size {{{dx*dy}}} where {{{dx = dy}}} in the input data || 106 || {{{file_x}}} || string ||UTM x-coordinates for the simulation domain (m) || 107 || {{{file_y}}} || string ||UTM y-coordinates for the simulation domain (m) || 108 || {{{file_lat}}} || string ||Latitude (degrees N) for the simulation domain || 109 || {{{file_lon}}} || string ||Longitude (degrees E) for the simulation domain || 110 || {{{file_zt}}} || string ||Terrain height (m) || 111 || {{{file_buildings_2d}}} || string ||2D Building height (m) || 112 || {{{file_building_id}}} || string ||Building ids || 113 || {{{file_building_type}}} || string ||Building type distribution || 114 || {{{file_bridges_2d}}} || string ||2D Map of bridge height (m) || 115 || {{{file_bridges_id}}} || string ||Bridge ids || 116 || {{{file_lai}}} || string ||Leaf area index || 117 || {{{file_vegetation_type}}} || string ||Vegetation type distribution || 118 || {{{file_vegetation_height}}} || string ||Vegetation height (m) || 119 || {{{file_pavement_type}}} || string ||Pavement type distribution || 120 || {{{file_water_type}}} || string ||Water type distribution || 121 || {{{file_soil_type}}} || string ||Soil type distribution || 122 || {{{file_street_type}}} || string ||Street type distribution (used for parameterized chemistry emissions and multi-agent model) || 123 || {{{file_street_crossings}}} || string ||Street crossings (used for multi-agent model) || 124 || {{{file_tree_height}}} || string ||Tree height (m) for street trees. For each tree only one value can be given at the center of the tree location || 105 || {{{path}}} || string ||Directory where the NetCDF input files reside || 106 || {{{pixel_size}}}* || float ||Horizontal grid spacing (m) of a surface pixel of size {{{dx*dy}}} where {{{dx = dy}}} in the input data || 107 || {{{file_x}}}* || string ||UTM x-coordinates for the simulation domain (m) || 108 || {{{file_y}}}* || string ||UTM y-coordinates for the simulation domain (m) || 109 || {{{file_x_UTM}}}* || string ||UTM x-coordinates for the simulation domain (m) || 110 || {{{file_y_UTM}}}* || string ||UTM y-coordinates for the simulation domain (m) || 111 || {{{file_lat}}}* || string ||Latitude (degrees N) for the simulation domain || 112 || {{{file_lon}}}* || string ||Longitude (degrees E) for the simulation domain || 113 || {{{file_zt}}}* || string ||Terrain height (m) || 114 || {{{file_buildings_2d}}}* || string ||2D Building height (m) || 115 || {{{file_building_id}}}* || string ||Building ids || 116 || {{{file_building_type}}}* || string ||Building type distribution || 117 || {{{file_bridges_2d}}}* || string ||2D Map of bridge height (m) || 118 || {{{file_bridges_id}}}* || string ||Bridge ids || 119 || {{{file_lai}}} || string ||Leaf area index || 120 || {{{file_vegetation_type}}}* || string ||Vegetation type distribution || 121 || {{{file_vegetation_height}}}* || string ||Vegetation height (m) || 122 || {{{file_pavement_type}}}* || string ||Pavement type distribution || 123 || {{{file_water_type}}}* || string ||Water type distribution || 124 || {{{file_street_type}}}* || string ||Street type distribution (used for parameterized chemistry emissions and multi-agent model) || 125 || {{{file_street_crossings}}}* || string ||Street crossings (used for multi-agent model) || 126 || {{{file_tree_height}}} || string ||Tree height (m) for street trees. For each tree only one value can be given at the center of the tree location || 125 127 || {{{file_tree_crown_diameter}}} || string ||Tree crown diameter (m). For each tree only one value can be given at the center of the tree location || 126 128 || {{{file_tree_trunk_diameter}}} || string ||Trunk diameter at breast height (m). For each tree only one value can be given at the center of the tree location || 127 || {{{file_tree_type}}} || string ||Tree type according to the canopy generator tree inventory. For each tree only one value can be given at the center of the tree location || 128 || {{{file_patch_height}}} || string ||2D distribution of the vegetation canopy height || 129 || {{{file_tree_type}}}* || string ||Tree type according to the canopy generator tree inventory. For each tree only one value can be given at the center of the tree location || 130 || {{{file_patch_height}}}* || string ||2D distribution of the vegetation canopy height || 131 || {{{file_patch_type}}} || string ||2D distribution of the vegetation type of vegetation patches || 129 132 || {{{file_vegetation_on_roofs}}} || string ||2D distribution of green roofs. Values can be 0.0-1.0. Intensive vegetation is considered for values >= 0.5, while extensive vegetation is assumed for values > 0.5 || 133 \* This parameter is mandatory 134 130 135 Example: 131 136 {{{ … … 163 168 164 169 ||='''Variable''' =||='''Data type''' =||='''Default value''' =||='''Description''' =|| 165 || {{{pixel_size}}} 166 || {{{origin_x}}} 167 || {{{origin_y}}} 168 || {{{nx}}} 169 || {{{ny}}} 170 || {{{dz}}} 170 || {{{pixel_size}}}* || float || ||Grid spacing in x and y / pixel size (m) || 171 || {{{origin_x}}}* || float || ||x-origin of the model domain (m) with respect to the input data UTM coordinates || 172 || {{{origin_y}}}* || float || ||y-origin of the model domain (m) with respect to the input data UTM coordinates || 173 || {{{nx}}}* || float || ||Number of grid points in x-direction (equals the {{{nx}}} setting in the PALM parameter file || 174 || {{{ny}}}* || float || ||Number of grid points in y-direction (equals the {{{ny}}} setting in the PALM parameter file || 175 || {{{dz}}}* || float || ||Vertical grid spacing in PALM (m). This parameter is needed when {{{buildings_3d}, {{{street_trees}}}, {{{canopy_patches}}}, {{{interpolate_terrain}}}, or {{{use_palm_z_axis}}} is used || 171 176 || {{{buildings_3d}}} || logical || False ||Use 3D buildings via the {{{buildings_3d}}} array to buildings instead of {{{buildings_2d}}}. This parameter must be true if bridges are present in the simulation domain. Note that the processing of 3D buildings by palm_csd is slower than 2D buildings || 172 177 || {{{allow_high_vegetation}}} || logical || False ||If set to {{{True}}}, it is allowed to have high vegetation classes according in the {{{vegetation_type}}} distribution. Note that this can involve very large roughness lengths > 0.5 m. If the vertical grid spacings is close or smaller than this threshold the PALM run will crash and/or does not provide meaningful results. It is generally recommended to set this parameter to {{{False}}} whenever the grid spacing in small enough to resolve canopy patches be 2 or more vertical grid levels. If set to {{{False}}} pixels where a high vegetation type was prescribed will be converted into a 3D leaf area density canopy using the canopy generator || … … 179 184 || {{{overhanging_trees}}} || logical || True ||If set to False, no LAD volumes of trees are generated above surfaces without a vegetation type. || 180 185 || {{{remove_low_lai_tree}}} || logical || False ||If set to True, all trees with an LAI<{{{lai_tree_lower_threshold}}} are removed from the dataset. If set to False, those trees are considered with LAI=lai_tree_lower_threshold. || 186 \* This parameter is mandatory 181 187 182 188 Example:
