Type Parameters:: N - network node, an instance of INode; P - network path, an instance of IPath

All Superinterfaces:: IRouteProvider<ShortestPathData<N,P>>, java.io.Serializable

All Known Implementing Classes:: AbstractNetwork, ConveyorNetwork, GISNetwork, Network

public interface INetwork<N extends INode<N,P>,P extends IPath<N>>
extends IRouteProvider<ShortestPathData<N,P>>

Basic interface of network for agent movement based on markup elements.

Author:: AnyLogic North America, LLC https://anylogic.com

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`add(N n)`	Adds node to network.
`void`	`add(P p)`	Adds relation to network.
`java.lang.Class<? extends ExtAgentWithSpatialMetrics>`	`getCompatibleAgentExtensionClass()`	This method is internal and shouldn't be called by user. it may be removed/renamed in future.
`double`	`getDistance(Point source, Point target, ShortestPathData<N,P> data)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, N from, N to, ShortestPathData<N,P> data)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, N from, N to, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, N from, P to, double toOffset, ShortestPathData<N,P> data)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, N from, P to, double toOffset, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, P from, double fromOffset, N to, ShortestPathData<N,P> data)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, P from, double fromOffset, N to, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, P from, double fromOffset, P to, double toOffset, ShortestPathData<N,P> data)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(Point source, Point target, P from, double fromOffset, P to, double toOffset, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance between two points using the network paths.
`double`	`getDistance(N from, N to, ShortestPathData<N,P> data)`	Calculates the distance from source object in the network to the target object.
`double`	`getDistance(N from, N to, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance from source object in the network to the target object.
`double`	`getDistance(N from, P to, double toOffset, ShortestPathData<N,P> data)`	Calculates the distance from source object in the network to the target object.
`double`	`getDistance(N from, P to, double toOffset, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance from source object in the network to the target object.
`double`	`getDistance(P from, double fromOffset, N to, ShortestPathData<N,P> data)`	Calculates the distance from source object in the network to the target object.
`double`	`getDistance(P from, double fromOffset, N to, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance from source object in the network to the target object.
`double`	`getDistance(P from, double fromOffset, P to, double toOffset, ShortestPathData<N,P> data)`	Calculates the distance from source object in the network to the target object.
`double`	`getDistance(P from, double fromOffset, P to, double toOffset, ShortestPathData<N,P> data, LengthUnits units)`	Calculates the distance from source object in the network to the target object.
`INetworkMarkupElement`	`getNearestNetworkElement(double x, double y, double z, Point out)`	Looking for the closest markup element in this network to the given coordinates.
`INetworkMarkupElement`	`getNearestNetworkElement(Point givenPoint, Point out)`	Looking for the closest markup element in this network to the given point.
`N`	`getNearestNode(Point p)`	Looking for the closest node in this network to the given point.
`N`	`getNode(int index)`
`int`	`getNodeCount()`	Amount of nodes in this network.
`P`	`getPath(int index)`
`int`	`getPathCount()`	Amount of paths in this network.
`double`	`getPlainDistance(Point firstPoint, Point secondPoint)`	Straight line distance between two points.
`double`	`getPlainDistance(Point firstPoint, Point secondPoint, LengthUnits units)`	Straight line distance between two points in given units of length.
`Position`	`getPosition(ShortestPathData<N,P> data, double reverseOffset, LengthUnits units, Position out)`	Calculates current position on the shortest path through network by the given offset
`Position`	`getPosition(ShortestPathData<N,P> data, double reverseOffset, Position out)`	Calculates current position on the shortest path through network by the given offset
`java.util.List<INetwork<?,?>>`	`getRelatedNetworks()`
`Agent`	`getSpace()`	Returns the space where the markup element is defined
`java.util.List<N>`	`nodes()`
`java.util.List<P>`	`paths()`
`java.util.List<NetworkPort>`	`ports()`

Methods inherited from interface com.anylogic.engine.IRouteProvider

getDistance, getLength, getPathData, getPositionAtOffset

Method Detail

add

void add(N n)

Adds node to network. Don't call this method when network has been initialized.

Parameters:: n - network node, instance of INode

add

void add(P p)

Adds relation to network. Don't call this method when network has been initialized.

Parameters:: p - network path, instance of IPath

getNearestNode

N getNearestNode(Point p)

Looking for the closest node in this network to the given point.

Parameters:: p - the given point
Returns:

getNearestNetworkElement

INetworkMarkupElement getNearestNetworkElement(double x,
                                               double y,
                                               double z,
                                               Point out)

Looking for the closest markup element in this network to the given coordinates.

Parameters:: x - the x given coordinate; y - the y given coordinate; z - the z given coordinate; out - the point in this markup element nearest to the given coordinates
Returns:: nearest markup element

getNearestNetworkElement

INetworkMarkupElement getNearestNetworkElement(Point givenPoint,
                                               Point out)

Looking for the closest markup element in this network to the given point.

Parameters:: givenPoint - the given point; out - the point in this markup element nearest to the given point
Returns:: nearest markup element

getNode

N getNode(int index)

getNodeCount

int getNodeCount()

Amount of nodes in this network.

Returns:: amount of nodes

getPath

P getPath(int index)

getPathCount

int getPathCount()

Amount of paths in this network.

Returns:: amount of paths

ports

java.util.List<NetworkPort> ports()

Returns:: all ports of this network

nodes

java.util.List<N> nodes()

Returns:: all nodes of this network

paths

java.util.List<P> paths()

Returns:: all paths of this network

getRelatedNetworks

@AnyLogicInternalAPI
java.util.List<INetwork<?,?>> getRelatedNetworks()

Returns:: list of related networks

getDistance

double getDistance(N from,
                   N to,
                   ShortestPathData<N,P> data)

Calculates the distance from source object in the network to the target object. Source and target points can be extracted from source and target objects in the following ways:

From network node - extracted point is a connection point of the node and the path, that will be used to calculate distance

From path and offset - extracted point lies at the certain distance (offset) from the start of the path

Parameters:: from - from node; to - to node; data - output object to write to, may be null
Returns:: distance between two points in the network

getDistance

double getDistance(N from,
                   N to,
                   ShortestPathData<N,P> data,
                   LengthUnits units)

Calculates the distance from source object in the network to the target object. Source and target points can be extracted from source and target objects in the following ways:

From network node - extracted point is a connection point of the node and the path, that will be used to calculate distance

From path and offset - extracted point lies at the certain distance (offset) from the start of the path

Parameters:: from - source node; to - target node; data - output object to write to, may be null; units - length units
Returns:: distance between two points in the network

getDistance

double getDistance(N from,
                   P to,
                   double toOffset,
                   ShortestPathData<N,P> data)

Calculates the distance from source object in the network to the target object. Source and target points can be extracted from source and target objects in the following ways:

From network node - extracted point is a connection point of the node and the path, that will be used to calculate distance

From path and offset - extracted point lies at the certain distance (offset) from the start of the path

Parameters:: from - source node; to - target path; toOffset - offset on the target path; data - output object to write to, may be null
Returns:: distance between two points in the network

getDistance

double getDistance(N from,
                   P to,
                   double toOffset,
                   ShortestPathData<N,P> data,
                   LengthUnits units)

Calculates the distance from source object in the network to the target object. Source and target points can be extracted from source and target objects in the following ways:

From network node - extracted point is a connection point of the node and the path, that will be used to calculate distance

From path and offset - extracted point lies at the certain distance (offset) from the start of the path

Parameters:: from - source node; to - target path; toOffset - offset on the target path; data - output object to write to, may be null; units - length units
Returns:: distance between two points in the network

getDistance

double getDistance(P from,
                   double fromOffset,
                   N to,
                   ShortestPathData<N,P> data)

Calculates the distance from source object in the network to the target object. Source and target points can be extracted from source and target objects in the following ways:

From network node - extracted point is a connection point of the node and the path, that will be used to calculate distance

From path and offset - extracted point lies at the certain distance (offset) from the start of the path

Parameters:: from - source path; fromOffset - offset on the source path; to - target node; data - output object to write to, may be null
Returns:: distance between two points in the network

getDistance

double getDistance(P from,
                   double fromOffset,
                   N to,
                   ShortestPathData<N,P> data,
                   LengthUnits units)

Calculates the distance from source object in the network to the target object. Source and target points can be extracted from source and target objects in the following ways:

From network node - extracted point is a connection point of the node and the path, that will be used to calculate distance

From path and offset - extracted point lies at the certain distance (offset) from the start of the path

Parameters:: from - source path; fromOffset - offset on the source path; to - target node; data - output object to write to, may be null; units - length units
Returns:: distance between two points in the network

getDistance

double getDistance(P from,
                   double fromOffset,
                   P to,
                   double toOffset,
                   ShortestPathData<N,P> data)

Calculates the distance from source object in the network to the target object. Source and target points can be extracted from source and target objects in the following ways:

From network node - extracted point is a connection point of the node and the path, that will be used to calculate distance

From path and offset - extracted point lies at the certain distance (offset) from the start of the path

Parameters:: from - source path; fromOffset - offset on the source path; to - target path; toOffset - offset on the target path; data - output object to write to, may be null
Returns:: distance between two points in the network

getDistance

double getDistance(P from,
                   double fromOffset,
                   P to,
                   double toOffset,
                   ShortestPathData<N,P> data,
                   LengthUnits units)

Calculates the distance from source object in the network to the target object. Source and target points can be extracted from source and target objects in the following ways:

From network node - extracted point is a connection point of the node and the path, that will be used to calculate distance

From path and offset - extracted point lies at the certain distance (offset) from the start of the path

Parameters:: from - source path; fromOffset - offset on the source path; to - target path; toOffset - offset on the target path; data - output object to write to, may be null; units - length units
Returns:: distance between two points in the network

getDistance

double getDistance(Point source,
                   Point target,
                   N from,
                   N to,
                   ShortestPathData<N,P> data)

Calculates the distance between two points using the network paths. Source and target points do not have to belong to the network. You have two options in terms of 'connecting' the source point to the network start point and the network end point to the target point, namely: