org.opentrafficsim.core.network.factory

Class LaneFactory

java.lang.Object

org.opentrafficsim.core.network.factory.LaneFactory

public final class LaneFactory
extends Object

Copyright (c) 2013-2015 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

$LastChangedDate: 2015-07-28 17:11:47 +0200 (Tue, 28 Jul 2015) $, @version $Revision: 1165 $, by $Author: averbraeck $, initial version 30 okt. 2014

Author:

Peter Knoppers

Method Summary

Modifier and Type	Method and Description
static Lane<String,String>	makeLane(String name, OTSNode<String> from, OTSNode<String> to, OTSPoint3D[] intermediatePoints, LaneType<String> laneType, DoubleScalar.Abs<SpeedUnit> speedLimit, OTSDEVSSimulatorInterface simulator) Create a simple Lane.
static CrossSectionLink<String,String>	makeLink(String name, OTSNode<String> from, OTSNode<String> to, OTSPoint3D[] intermediatePoints) Create a Link along intermediate coordinates from one Node to another.
static Lane<String,String>[]	makeMultiLane(String name, OTSNode<String> from, OTSNode<String> to, OTSPoint3D[] intermediatePoints, int laneCount, int laneOffsetAtStart, int laneOffsetAtEnd, LaneType<String> laneType, DoubleScalar.Abs<SpeedUnit> speedLimit, OTSDEVSSimulatorInterface simulator) Create a simple road with the specified number of Lanes. This method returns an array of Lane.
static Lane<String,String>[]	makeMultiLane(String name, OTSNode<String> from, OTSNode<String> to, OTSPoint3D[] intermediatePoints, int laneCount, LaneType<String> laneType, DoubleScalar.Abs<SpeedUnit> speedLimit, OTSDEVSSimulatorInterface simulator) Create a simple road with the specified number of Lanes. This method returns an array of Lane.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

makeLink

public static CrossSectionLink<String,String> makeLink(String name,
                                                       OTSNode<String> from,
                                                       OTSNode<String> to,
                                                       OTSPoint3D[] intermediatePoints)

Create a Link along intermediate coordinates from one Node to another.

Parameters:

name - String; name of the new Link

from - Node; start Node of the new Link

to - Node; end Node of the new Link

intermediatePoints - OTSPoint3D[]; array of intermediate coordinates (may be null)

Returns:

Link; the newly constructed Link

makeLane

public static Lane<String,String> makeLane(String name,
                                           OTSNode<String> from,
                                           OTSNode<String> to,
                                           OTSPoint3D[] intermediatePoints,
                                           LaneType<String> laneType,
                                           DoubleScalar.Abs<SpeedUnit> speedLimit,
                                           OTSDEVSSimulatorInterface simulator)
                                    throws RemoteException,
                                           NamingException,
                                           NetworkException,
                                           OTSGeometryException

Create a simple Lane.

Parameters:

name - String; name of the Lane (and also of the Link that owns it)

from - Node; starting node of the new Lane

to - Node; ending node of the new Lane

intermediatePoints - OTSPoint3D[]; intermediate coordinates or null to create a straight road

laneType - LaneType; type of the new Lane

speedLimit - DoubleScalar.Abs<SpeedUnit>; the speed limit on the new Lane

simulator - OTSDEVSSimulatorInterface; the simulator

Returns:

Lane; the new Lane

Throws:

NamingException - when names cannot be registered for animation

RemoteException - on communications failure

NetworkException - on network inconsistency

OTSGeometryException - when creation of center line or contour fails

makeMultiLane

public static Lane<String,String>[] makeMultiLane(String name,
                                                  OTSNode<String> from,
                                                  OTSNode<String> to,
                                                  OTSPoint3D[] intermediatePoints,
                                                  int laneCount,
                                                  int laneOffsetAtStart,
                                                  int laneOffsetAtEnd,
                                                  LaneType<String> laneType,
                                                  DoubleScalar.Abs<SpeedUnit> speedLimit,
                                                  OTSDEVSSimulatorInterface simulator)
                                           throws RemoteException,
                                                  NamingException,
                                                  NetworkException,
                                                  OTSGeometryException

Create a simple road with the specified number of Lanes.
This method returns an array of Lane. These lanes are embedded in a Link that can be accessed through the getParentLink method of the Lane.

Parameters:

name - String; name of the Link

from - Node; starting node of the new Lane

to - Node; ending node of the new Lane

intermediatePoints - OTSPoint3D[]; intermediate coordinates or null to create a straight road

laneCount - int; number of lanes in the road

laneOffsetAtStart - int; extra offset from design line in lane widths at start of link

laneOffsetAtEnd - int; extra offset from design line in lane widths at end of link

laneType - LaneType; type of the new Lanes

speedLimit - DoubleScalar.Abs<SpeedUnit>; the speed limit on all lanes

simulator - OTSDEVSSimulatorInterface; the simulator

Returns:

Lane<String, String>[]; array containing the new Lanes

Throws:

NamingException - when names cannot be registered for animation

RemoteException - on communications failure

NetworkException - on topological problems

OTSGeometryException - when creation of center line or contour fails

makeMultiLane

public static Lane<String,String>[] makeMultiLane(String name,
                                                  OTSNode<String> from,
                                                  OTSNode<String> to,
                                                  OTSPoint3D[] intermediatePoints,
                                                  int laneCount,
                                                  LaneType<String> laneType,
                                                  DoubleScalar.Abs<SpeedUnit> speedLimit,
                                                  OTSDEVSSimulatorInterface simulator)
                                           throws RemoteException,
                                                  NamingException,
                                                  NetworkException,
                                                  OTSGeometryException

Create a simple road with the specified number of Lanes.
This method returns an array of Lane. These lanes are embedded in a Link that can be accessed through the getParentLink method of the Lane.

Parameters:

name - String; name of the Link

from - Node; starting node of the new Lane

to - Node; ending node of the new Lane

intermediatePoints - OTSPoint3D[]; intermediate coordinates or null to create a straight road

laneCount - int; number of lanes in the road

laneType - LaneType; type of the new Lanes

speedLimit - DoubleScalar.Abs<SpeedUnit> the speed limit (applies to all generated lanes)

simulator - OTSDEVSSimulatorInterface; the simulator

Returns:

Lane<String, String>[]; array containing the new Lanes

Throws:

NamingException - when names cannot be registered for animation

RemoteException - on communications failure

NetworkException - on topological problems

OTSGeometryException - when creation of center line or contour fails