Network Node

Overview and Key Concepts

Network nodes are used to define a network of paths that transporters and operators follow. The paths can be modified using spline points to add curvature to the path. By default, objects travelling on a network will follow the shortest path between their origin and destination.

Events

For information on events, see the Event Listening page.

The network node has the following events:

On Arrival

On Arrival fires when a traveler arrives at the node.

It has the following parameters:

Event Parameter Type Explanation
Traveler Object The object traversing the network
To Edge int The rank of the edge the traveler will continue on
From Edge int The rank of the edge the traveler arrived on

On Continue

On Continue fires right before a traveler leaves the node.

It has the following parameters:

Event Parameter Type Explanation
Traveler Object The object traversing the network
To Edge int The rank of the edge the traveler will continue on
From Edge int The rank of the edge the traveler arrived on

States

The network node does not implement any states.

Statistics

The network node does not track any statistics.

Properties

The network node object has four tabs with various properties. The last three tabs are common to Travel Network objects. For more information about the properties on those tabs, see:

Only the NetworkNode tab is unique to the network node object. The properties on this tab will be explained in more detail in the following sections.

Maximum Travelers at Node

This number defines how many transporters that are not traveling on the network can be stationed at the node. This would represent the transporters that are not currently executing a travel task, but are doing other things while "stationed" at the node.

Side Offset

This number defines a distance to the right of outgoing paths that travelers will be offset. It does not affect the distance that the traveler travels, but is purely for visual purposes, so travelers going in different directions along the same path don't run over each other.

Name

This field allows the user to name each connection in the network. These names should be descriptive of any special purpose this connection has in the model.

Connection Type

This drop-down list allows the user to define how this connection behaves. There are three options.

No Connection

Transporters cannot travel on this connection. The connection is drawn in red in the view window.

Passing

Transporters are allowed to pass each other on this connection. The connection is drawn in green in the view window.

No Passing

Transporters will not pass each other on this connection. The minimum distance between transporters on the path can be set by the user in the Spacing field of the dialog. These connections are drawn in yellow in the view window.

Spacing

This number determines the minimum distance allowed between two transporters on a connection that is designated as no passing. This is the distance from the back of one traveler to the front of the traveler behind it.

Speed Limit

This number determines the maximum speed that a traveler can travel along this connection.

Current Distance

This number shows you the current distance that is being simulated for that connection. If the virtual distance is specified as 0, then it will be the actual distance of the spline path. Otherwise it will be the distance that is specified in the virtual distance field.

Virtual Distance

This number let's you specify an exact distance for the connection.