2D zones are used as part of the mesh generation process carried out when undertaking 2D Modelling. They can be used to define areas of particular interest for which more detailed analysis is required.
The following describes all the data which can be used to define a 2D zone. For details of results fields, see the 2D Zone Results Data Fields topic.
Fields that are common to the majority of objects can be found in the Common Fields topic.
Database Table Name: hw_2d_zone
Field Name |
Description |
Database Field |
Size |
Precision |
Default |
Error Lower Limit |
Error Upper Limit |
Warning Lower Limit |
Warning Upper Limit |
||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ID |
The name of the zone. |
zone_id |
Text |
64 |
|
0 |
|
|
|
|
|
||||||||||||
Area |
Zone area. Default value calculated from polygon geometry. |
area |
Double |
|
CA |
3 |
|
|
|
|
|
||||||||||||
Maximum triangle area |
A measure of mesh resolution used when creating a 2D mesh. Maximum allowable triangle area for areas in the 2D zone that are not in a mesh zone. |
max_triangle_area |
Double |
|
NA |
3 |
100.0 m2 |
0.001 |
|
|
|
||||||||||||
Minimum element area |
Minimum mesh element area used for calculating results. Mesh elements with area less than the minimum area specified, will be aggregated with adjoining elements, until the minimum area is met. This is done for the purpose of calculating results in order to improve simulation stability and run time. Mesh elements will not be aggregated across wall objects or Mesh zone boundaries. The minimum element area is also applied to limit the extent to which triangles are subdivided during terrain-sensitive meshing. |
min_mesh_element_area |
Double |
|
NA |
3 |
25.0 m2 |
0.001 |
|
|
|
||||||||||||
Mesh generation |
The type of mesh generation. Choices are:
See 2D Mesh Generation Methodology for further information about these two meshing methods. The default meshing method is Clip meshing unless overwritten by a User Defined Default. |
mesh_generation | Text | 20 | 0 |
User Defined Default. |
|||||||||||||||||
Boundary type |
Boundary condition for the 2D zone. (In any boundary case where water is allowed to flow out of the 2D zone, the water volume that has flowed out of the 2D zone is recorded in the log file to check mass conservation.) Note that a Porous Wall, Porous Polygon, Base Linear Structure, 2D Boundary or Building collinear with the boundary of the 2D zone, will override the boundary condition of the 2D zone along the coincident portion of the boundary. In the case of a porous wall, porous polygon or base linear structure coincident portions of the wall/polygon are considered infinitely high, regardless of any crest level specified.
|
boundary_type |
Text |
80 |
|
0 |
Vertical Wall |
|
|
|
|
||||||||||||
Terrain-sensitive meshing |
If checked, terrain-sensitive meshing is applied during the mesh generation process. The Maximum height variation field must be specified. See Terrain-sensitive meshing for more details. |
terrain_sensitive_mesh | Boolean | ||||||||||||||||||||
Maximum height variation |
Enabled when Terrain-sensitive meshing is checked. The maximum height variation that is permitted within a single triangle. Triangles with a height variation greater than this will be split provided this would not result in a triangle smaller than the Minimum element area. |
max_height_variation | Double | L | 3 | 1.0 | 0.001 | ||||||||||||||||
Minimum angle |
Minimum allowable angle between triangle vertices when creating a 2D mesh. |
minimum_angle |
Double |
|
ANGLE |
2 |
25.0 |
0.01 |
35 |
|
|
||||||||||||
Roughness (Manning's n) |
Manning roughness (n), used when creating a 2D mesh. The roughness value assigned to mesh elements in areas in the 2D zone that are not in a roughness zone. This field is automatically disabled if a Roughness definition object is selected in the Roughness definition field. |
roughness |
Double |
|
|
4 |
0.0125 |
0 |
|
|
|
||||||||||||
Roughness definition |
The name of the Roughness definition associated with the 2D zone. Any Roughness definitions already
specified can be selected from the dropdown. Alternatively, a new one can be added or an existing one modified using the
|
roughness_definition_id | Text | 64 |
|
|
|
||||||||||||||||
Apply rainfall etc directly to mesh elements |
If checked, Rainfall profiles and their corresponding Evaporation profiles are applied to 2D mesh elements in the zone. Note: If 2D meshes and subcatchments overlap, rainfall will be applied to both subcatchment and 2D mesh independently by default. To prevent applying rainfall twice in subcatchment areas, set the Apply rainfall etc field to outside subcatchments.
|
apply_rainfall_directly |
Boolean |
|
|
0 |
0 |
|
|
|
|
||||||||||||
Apply rainfall etc |
Enabled when Apply rainfall etc directly to mesh elements is selected. Used to define whether application of rainfall and evaporation will be applied to the entire mesh, or outside of subcatchments only.
|
apply_rainfall_subcatch |
Text |
80 |
|
0 |
everywhere |
|
|
|
|
||||||||||||
Rainfall profile |
The name of the rainfall profile applied to the mesh elements in this polygon. Each profile within a Rainfall Event has a unique name. You must set a value in this field, or set the field flag to #D to use the User Defined Default. If the field does not contain a valid rainfall profile ID, the following action is taken when you run a simulation:
When using a Rainfall Event containing rain-gauge boundary data, the Rainfall Profile is over-ridden and depends on which rain-gauge boundary contains the mesh elements. See Spatially Varying Rainfall. |
rainfall_profile |
Text |
64 |
|
0 |
|
|
|
|
|
||||||||||||
Infiltration surface | The name of the Infiltration Surface (2D) applied to this zone. | infiltration_surface_id | Text | 64 | |||||||||||||||||||
Turbulence Model |
The name of the Turbulence Model (2D) associated with this zone. The specified turbulence model will be used as the default for the 2D zone, i.e. it will be applied to all 2D mesh elements that are not contained in specific Turbulence Zones (2D). |
turbulence_model_id | Text | 64 | |||||||||||||||||||
Rainfall percentage |
Percentage indicating how much of the rainfall depth will fall directly onto the ground within the 2D zone. Used to avoid double counting, e.g. of rainfall falling onto building roofs and flowing directly into the drainage system. |
rainfall_percentage | Double | 3 | 0 | 100 | |||||||||||||||||
Mesh summary |
Read-only field containing meshing summary data (e.g. ground model, data source for voids, break lines and walls, mesh zones used, number of triangles etc.), a list of mesh warnings and resampling information. Only the latest meshing information is stored in this field. Previous meshing summary information will be overwritten if re-meshing of the zone takes place and the mesh results are loaded. See Creating 2D meshes. |
mesh_summary |
Memo |
|
|
0 |
|
|
|
|
|
||||||||||||
Mesh data |
Clicking
|
mesh_data | Array | 0 | |||||||||||||||||||
Subgrid Sampling
|
If checked, Subgrid Sampling is applied to the 2D zone during mesh generation.
Note: Subgrid Sampling (Tech preview) is only available using Clip meshing method of Mesh generation.
See
Subgrid Sampling Methodology for details.
|
subgrid_sampling | Boolean | ||||||||||||||||||||
Subgrid Sampling triangle area | Enabled when Subgrid Sampling is checked and provides a measure of mesh resolution for Subgrid Sampling when creating a 2D mesh.
The maximum area for subgrid triangles in a 2D element. This value must be less than the specified Maximum triangle area. This applies to all subgrid triangle areas in the 2D zone that are not in a mesh zone. This parameter also determines the first entry in the volume/level tables. ICM aggregates the triangle areas of the first triangles in the volume/level tables until the specified maximum area is reached, which becomes the first entry in the volume/level table. |
subgrid_triangle_area | Double | NA | 3 | 10 | 0.001 |