Line-based building (Water Overlay)

Line-based buildings are Buildings for which their geometry is interpreted as a 2 dimensional line with two end points.

Examples of line-based buildings are the following hydraulic structures:

Icon	Name	Name
	Culvert	Flow in both directions possible.
	Weir	Conditional flow, based on the weir's height. Flow possible in both ways.
	Pump	Pumps water from the entry with the lowest water level to the entry with the highest water level.

Polygon skeleton

A method to obtain line geometries from a polygonal geometry is called topological skeletonization. In the case of Line-based buildings, we want to obtain only a single line segment. The current implementation follows these steps:

1. Skeletonize a building's polygon. This potentially produces a multi-line geometry.
2. Take the first point and the last point of this line geometry. These two points will form the line segment used for the line-based building.

Simple rectangle polygon.

This approach has certain limitations depending on the polygon geometry. See the following images:

• 

  Case one: Polygon with skeleton that has 3 end points.

• 

  Case two: Circle polygon without any end points.

• 

  Case three: Almost circular polygon with very small skeleton.

In case one, the resulting skeleton lines have 3 different end points. Which of these points will be the first and last end point is dependent on the sequence of coordinates in the polygon.
In case two, the polygon is a perfect circle, resulting in no skeleton line.
In case three, the skeleton line is very small, for example 1 centimeter. This may not be desirable when the end points need to be separated more than a certain amount.

More complex but common situation:

• 

  Skeleton of semi-complex building polygon.

• 

  Resulting roof from building polygon and skeleton.

Generally, this kind of polygon is undesirable for a line-based building, since it will generate a skeleton with many end points.

Direction

For some structures, a direction is relevant to determine from which location (A) to which location (B) water flows, and to relate any output attributes related to properties on either side of the Building. Particular types of structures may have their own rules for determining their "direction" as such. If those rules are absent (such as for a culvert), or unclear (such as based on higher of 2 water levels, but both water levels are the same), the direction is determined based on the computed skeleton line of the structure.

The Tygron Client displays the endpoint names (A, B) when you enable the Water Overlay and zoom into the structure location. Whether A or B corresponds to a specific side is determined by the structure’s skeleton line and can be retrieved via the Building API. The first coordinate represents side A, and the last coordinate represents side B.

General advice

• The line-based buildings should be supplied as rectangles or line-buffered polygons.
• The length of the polygon along the line should be longer than the width of the polygon perpendicular to the line.

See also

• Point-based building (Water Overlay)
• Area-based building (Water Overlay)
• Topological skeleton

API Endpoints

• Api session items buildings.

---

Water Module

Water Module

Tutorials

Overview

Theory

Benchmarks

Group

Hydraulic structures

Inlet

Inlet q • Inlet area • Inlet capacity •  Lower threshold •  Upper threshold • Inlet underground

Pump

Pump q •  Lower threshold •  Upper threshold • Pump angle • Pump capacity • Pump area

Culvert

Culvert diameter • Culvert rectangular height • Culvert threshold • Culvert n

Weir

Weir height • Weir width • Weir angle • Weir coefficient • Weir n • Weir target level

Sewer overflow

Sewer overflow • Sewer overflow speed

Drainage

Drainage q • Drainage datum • Drainage active • Drainage overflow threshold

Output

Object flow output • Object height output • Object datum output a • Object datum output b • Object water area output • Object width output • Weir dam output

Related

Building attributes • Hydrological features •  Terrain attributes • Model attributes • Results • Simulation data