Network: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[File:Api_current_situation_network.png|thumb|right|400px|Network with [[Net Node]]s connected by [[Net Line]]s, [[Net Load]]s clustered by [[Net Cluster]]s and configured by [[Net Setting]s]]
[[File:Api_current_situation_network.png|thumb|right|400px|Network with [[Net Node]]s connected by [[Net Line]]s, [[Net Load]]s clustered by [[Net Cluster]]s and configured by [[Net Setting]]s]]
 
Networks in the platform are composed of multiple constituent components:
Networks in the platform are composed of multiple constituent components:
* [[Net Type]]: A categorization of the network.  
* [[Net Type]]: A categorization of the network.  
* [[Net Node]]s: A node present in one or more networks
* [[Net Node]]s: A node present in one or more networks
* [[Net Line]]s: A connection between two net nodes
* [[Net Line]]s: A connection between two net nodes
** Has an associated [[net function]], which in turn is related to a specific [[net type]].
** Has an associated [[Net Function]], which in turn is related to a specific [[net type]].
* [[Net Load]]s: A definition of supply or demand in the network  
* [[Net Load]]s: A definition of supply or demand in the network  
** Belongs to a particular [[net type]]  
** Belongs to a particular [[Net Type]]  
** Is associated to [[net node]].
** Is associated to [[Net Node]].
** Can be activated or deactivated with specific time states.
** Can be activated or deactivated with specific time states.
* [[Net Cluster]]s: Cluster of net loads that provides group (de)activation.
* [[Net Cluster]]s: Cluster of net loads that provides group (de)activation.
** Can be associated with [[net load]]s of different [[net type]]s
** Can be associated with [[Net Load]]s of different [[Net Type]]s
* [[Net Setting]]s: Settings related to the configuration of a Network of a specific Net Type.
* [[Net Setting]]s: Settings related to the configuration of a Network of a specific Net Type.




===Net type===
Each network is related to a predefined resource type. This is known as the net type. The network then is the system through which resources travels from elements of supply to elements of demand. Each network of a separate type is a separate entity, and networks of different types do not affect each other. The following network types are currently available:
* ELECTRICITY
* GAS
* HEAT
* INTERNET
* SEWER


===Restrictions on networks===
===Restrictions on networks===
* Networks cannot contain any cycles. All networks should be defined as a tree. If the network is not structured as a tree, network generation and other calculations may have unexpected results.
* Networks cannot contain any cycles. All networks should be defined as a tree. If the network is not structured as a tree, network generation and other calculations may have unexpected results.
* A net node can be connected to 1, 2, or more [[net line]]s, except when that node is a [[net load|load node]]. In that case, a net node can only be connected to exactly 1 net line.
* A net node can be connected to 1, 2, or more [[net line]]s, except when that node is a [[net load|load node]]. In that case, a net node can only be connected to exactly 1 net line.
* Behavior for networks linked with buildings which are altered during a session are undefined. When using network functionality, the buildings linked to by the network should not be demolished, [[upgrade]]d, sold to other stakeholders, or otherwise changed.
* Behavior for networks linked with buildings which are altered during a session are undefined. When using network functionality, the buildings linked to by the network should not be demolished, [[Upgrade Type|upgrade]]d, sold to other stakeholders, or otherwise changed.


==How-to's==
{{article end
|howtos=
* [[How to generate a network using the network wizard]]
* [[How to generate a network using the network wizard]]
* [[How to import an existing network]]
* [[How to import an existing network]]
* [[How to manually edit a network]]
* [[How to manually edit a network]]
 
* [[How to check for errors when using the network wizard]]
==Adding and editing networks==
* [[How to check for errors when using the net validation panel]]
Because networks are complex elements in a project, there are multiple topics devoted to creating and verifying your network.
|seealso=
 
===Ways of creating a network===
There are multiple ways to add a network to a project. Depending on the availability of data and the prospective complexity of the network some methods may be more appropriate.
 
====Generating====
It is possible to let the {{software}} [[Generating network|generate a network]] for you. This can be done using the Net wizard, which will guide you through the process.
{{Editor location|Net Wizard}}
 
====Importing Data====
 
{{stub|type=section}}
 
====Manually====
Although not very practical, it is possible to create or edit networks manually, by placing [[net line]]s and [[net load]]s in the world piece by piece.
 
===Checking for errors===
When there is doubt on whether the network has been created correctly, there are options to have the {{software}} check for issues automatically.
 
====Network wizard====
When creating or importing network data using the net wizard, but also when stepping through the available steps of the wizard without effecting any changes, there are 2 validation steps where all preceding information is checked. These validation steps will check the following for all [[Network_settings#Active|active network types]]:
* There is a root node
* All net lines are connected directly or indirectly to the root node
* All net loads are connected via paths composed of net lines to the root note
* All net nodes with only 1 net line connected to them have a net load connected to them
* All net nodes with a net load connected to them only have 1 net line connected to them
<!--* There are no cycles in the network (except for the GAS network type)-->
* All net loads are part of a cluster
 
====Net validation====
The net validation panel will check the following for a given network type:
* There is a root node
* All net lines are connected directly or indirectly to the root node
<!--* All net loads are connected via paths composed of net lines to the root note-->
* All net nodes with only 1 net line connected to them have a net load connected to them
* All net nodes with a net load connected to them only have 1 net line connected to them
<!--* There are no cycles in the network (except for the GAS network type)-->
<!--* All net loads are part of a cluster-->
You will also be able to "highlight" the network. This will highlight all segments of the network that are connected to the root node. All sections of the network that aren't connected in any way to the root node are not connected. This allows you to find small fractures which disconnect sections of the network.
 
==See Also==
* [[Network Overview Overlay]]
* [[Network Overview Overlay]]
* [[Network Ownership Overlay]]
* [[Network Ownership Overlay]]
* [[Network Distance Overlay]]
* [[Network Distance Overlay]]
* [[File:Network_VT.jpg| link=https://youtu.be/k4WDyjdurU4|left|thumb|Network and network generation]]
|videos=
:[[File:Network_VT.jpg| link=https://youtu.be/k4WDyjdurU4|left|thumb|Network and network generation]]
}}


{{Template:Editor current situation nav}}
{{Template:Editor current situation nav}}

Latest revision as of 15:14, 29 February 2024

Network with Net Nodes connected by Net Lines, Net Loads clustered by Net Clusters and configured by Net Settings

Networks in the platform are composed of multiple constituent components:

  • Net Type: A categorization of the network.
  • Net Nodes: A node present in one or more networks
  • Net Lines: A connection between two net nodes
  • Net Loads: A definition of supply or demand in the network
    • Belongs to a particular Net Type
    • Is associated to Net Node.
    • Can be activated or deactivated with specific time states.
  • Net Clusters: Cluster of net loads that provides group (de)activation.
  • Net Settings: Settings related to the configuration of a Network of a specific Net Type.


Restrictions on networks

  • Networks cannot contain any cycles. All networks should be defined as a tree. If the network is not structured as a tree, network generation and other calculations may have unexpected results.
  • A net node can be connected to 1, 2, or more net lines, except when that node is a load node. In that case, a net node can only be connected to exactly 1 net line.
  • Behavior for networks linked with buildings which are altered during a session are undefined. When using network functionality, the buildings linked to by the network should not be demolished, upgraded, sold to other stakeholders, or otherwise changed.