Global Flood Engine
Simulates rainfall accumulation pooling into local valleys and depressions.
Overview
Simulates rainfall accumulation pooling into local valleys and depressions.
Inputs (7)
- TerrainMesh (Mesh): Input Terrain Mesh
- Rainfall (Number): Rainfall intensity in Liters/m2/hour (mm/h)
- Duration (Number): Duration of the rain event in hours
- Iterations (Integer): Simulation steps for water flow
- Runoff Coefficient (Number): Multiplier for rainfall (0.0 to 1.0). 1.0 = concrete (no absorption). Can be a single value or a list matching the mesh vertices.
- Boundary Condition (Integer): 0 = Closed (water pools at edges), 1 = Open (water drains off edges)
- Run (Boolean): Optional. False = skip the analysis and keep showing the last results (cached). Share one toggle with the Analysis Dashboard to switch everything on/off together.
Outputs (4)
- FloodMesh (Mesh): Flooded terrain heatmap mesh
- WaterDepths (Number): Water depths at each vertex in meters
- AnalysisPoints (Point): Points corresponding to the water depth values
- Info (Text): Component information and interpretation
Method, assumptions and simplifications
The same notes appear in the component's Info output.
Method
- Every mesh vertex starts with a water depth d = Rainfall × Duration / 1000 × Runoff Coefficient (in m; Rainfall in mm/h, Duration in h). Coefficients are a single value or one per mesh vertex.
- Each iteration, every wet vertex (d > 0.1 mm) finds the connected neighbour with the lowest water level (ground Z + depth). If it is lower, half the level difference is moved to it, limited to the water the vertex holds.
- With Boundary Condition 1 (open), the water at naked-edge vertices is set to 0 after every iteration, so it drains off the model. With 0 (closed) it stays.
- The loop stops after Iterations steps or when no water moved.
- WaterDepths are the final depths per mesh vertex; FloodMesh is coloured light grey below 0.01 m and from cyan to dark blue by depth relative to the maximum.
Assumptions
- Every vertex stands for the same plan area, so moving depth between vertices conserves volume only on an evenly spaced mesh.
- All rain falls at once at the start; Duration only scales the total depth.
- Z is in metres and the mesh is a terrain (one height per plan location).
Simplifications and limits
- No infiltration over time, no flow velocity, roughness or travel time; Iterations are not time steps.
- Water moves at most one mesh edge per iteration, to one neighbour only, so on large or fine meshes the result depends on Iterations and may not reach equilibrium.
- No drainage network, buildings or culverts.
Workflow
- Terrain Mesher or a site mesh -> TerrainMesh.
- WaterDepths with AnalysisPoints -> legend, dashboard or threshold filters.