Net Line

This article is a stub.

What are net lines

A line, in network simulation terms, is a connection between different nodes in a resource transport and distribution network. Along with the nodes of the network they form a graph.

How net lines relate to the Tygron Engine

In the Tygron Engine, net lines and net nodes, along with net loads, form distribution networks. They are defined by 2 net nodes, a starting node and an end node, and a net line definition. The collection of net lines and net nodes between two arbitrary net nodes is called a path.

Properties of net lines

Net lines have a number of properties, mostly related to visualization. They also allow for the definitions of arbitrary attributes.

Net line definitions

Each net line has a reference to a net line definition. The net line definition's attributes, such as its color or visualization diameter, are inherited by their net lines. This allows a single set of properties to be applied to all lines in the network.

Attributes

Net lines can have any number of arbitrary attributes. A few attribute names are reserved and have a special function.

DEF_DIAMETER_M: The diameter of the net line. This can be used in calculations and also affects the width of the net line as visible in the 3D World.

FLOW: The flow of a net line indicates the amount of the resource that is transported through this net line. If the network's graph is a tree, the direction is implicit and the value can be consistently positive. In more complicated networks, the direction in which the resource is transported may be relevant, and can be indicated with a positive or negative value. By default, the attribute name FLOW is preferred. The specific attribute name used for this is defined as part of the settings of the net type.

VISUALIZATION_DIAMETER_M: The diameter of the net line. Similar to DEF_DIAMETER_M, this attribute affects the visualized width of the net line in the 3D World, but is not intended to be used in calculations.

Adding and editing net lines

It is possible to edit the net lines of the network, but also to import net lines into the project.

Importing GeoJSON

It is possible to import a geojson file to add net loads to a project.

It is also possible to select the option of importing data in the Net wizard. In both cases, it is recommended to import all network geojson files at the same time where possible: net lines, net line definitions, and net loads.

The net loads GeoJSON file should be composed of point data with the following attributes.

Attribute	Description	Example	Remark
NAME	The name of the net load.	NetLoad 49
NET_TYPE	The type of network this net load belongs to	HEAT	Note that when connecting net loads and net nodes or net lines of different network types while importing, this is considered incorrect input and behavior of the Tygron Engine will be undefined.
STATE	Whether the net load is connected or not.	NOTHING	Any of the timestates mentioned in this article are valid.
NODE_ID	The ID of the net node this load belongs to.	17	If this file is being imported along with a net lines file, this NODE_ID should match one of the net lines START_NODE_IDs or END_NODE_IDs.
CLUSTER_ID	The ID of the cluster this load should belong to.	4	The cluster of net loads this net load should belong to. A cluster is not created automatically, but after importing these clusters can be created using a cluster generation algorithm.
ROOT_LOAD	Whether this net load is a root load or not	0	1 = root load (producer), 0 = a regular load (consumer)
ADDRESSCODE	The postcode this net load is related to.	2514EG 46	When a net load has a postcode which is also found in a building in the 3D world, the net load is automatically linked to that building.