SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
NBEdge Class Reference

The representation of a single edge during network building. More...

#include <NBEdge.h>

Inheritance diagram for NBEdge:
Named

Data Structures

struct  Connection
 A structure which describes a connection between edges or lanes. More...
class  connections_finder
class  connections_fromlane_finder
class  connections_relative_edgelane_sorter
class  connections_toedge_finder
class  connections_toedgelane_finder
struct  Lane
 An (internal) definition of a single lane of an edge. More...
class  MainDirections
class  tls_disable_finder
struct  TLSDisabledConnection
class  ToEdgeConnectionsAdder

Public Types

enum  EdgeBuildingStep {
  INIT_REJECT_CONNECTIONS, INIT, EDGE2EDGES, LANES2EDGES,
  LANES2LANES_RECHECK, LANES2LANES_DONE, LANES2LANES_USER
}
 Current state of the edge within the building process. More...
enum  Lane2LaneInfoType { L2L_COMPUTED, L2L_USER, L2L_VALIDATED }
 Modes of setting connections between lanes. More...

Public Member Functions

void addCrossingPointsAsIncomingWithGivenOutgoing (NBEdge *o, PositionVector &into)
void allowVehicleClass (int lane, SUMOVehicleClass vclass)
 set allowed class for the given lane or for all lanes if -1 is given
void append (NBEdge *continuation)
void appendTurnaround (bool noTLSControlled)
 Add a connection to the previously computed turnaround, if wished.
void buildInnerEdges (const NBNode &n, unsigned int noInternalNoSplits, unsigned int &lno, unsigned int &splitNo)
void clearControllingTLInformation ()
 clears tlID for all connections
bool computeEdge2Edges (bool noLeftMovers)
 computes the edge (step1: computation of approached edges)
bool computeLanes2Edges ()
 computes the edge, step2: computation of which lanes approach the edges)
void decLaneNo (unsigned int by, int dir=0)
void declareConnectionsAsLoaded ()
void disableConnection4TLS (int fromLane, NBEdge *toEdge, int toLane)
void disallowVehicleClass (int lane, SUMOVehicleClass vclass)
 set disallowed class for the given lane or for all lanes if -1 is given
void dismissVehicleClassInformation ()
bool expandableBy (NBEdge *possContinuation) const
SUMOReal getAngleAtNode (const NBNode *const node) const
 Returns the angle of the edge's geometry at the given node.
PositionVector getCCWBoundaryLine (const NBNode &n, SUMOReal offset) const
PositionVector getCWBoundaryLine (const NBNode &n, SUMOReal offset) const
const std::string & getID () const
 Returns the id.
int getJunctionPriority (const NBNode *const node) const
 Returns the junction priority (normalised for the node currently build)
std::string getLaneID (unsigned int lane) const
SUMOReal getLaneSpeed (unsigned int lane) const
LanegetLaneStruct (unsigned int lane)
const LanegetLaneStruct (unsigned int lane) const
SUMOReal getMaxLaneOffset ()
Position getMaxLaneOffsetPositionAt (NBNode *node, SUMOReal width) const
Position getMinLaneOffsetPositionAt (NBNode *node, SUMOReal width) const
SVCPermissions getPermissions (int lane=-1) const
 get the union of allowed classes over all lanes or for a specific lane
NBEdgegetTurnDestination () const
const std::string & getTypeID () const
bool hasLaneSpecificOffset () const
 whether lanes differ in offset
bool hasLaneSpecificPermissions () const
 whether lanes differ in allowed vehicle classes
bool hasLaneSpecificSpeed () const
 whether lanes differ in speed
bool hasLaneSpecificWidth () const
 whether lanes differ in width
bool hasRestrictions () const
 whether at least one lane has restrictions
bool hasSignalisedConnectionTo (const NBEdge *const e) const
void incLaneNo (unsigned int by)
bool isNearEnough2BeJoined2 (NBEdge *e, SUMOReal threshold) const
bool isTurningDirectionAt (const NBNode *n, const NBEdge *const edge) const
 Returns whether the given edge is the opposite direction to this edge.
bool lanesWereAssigned () const
void markAsInLane2LaneState ()
bool mayBeTLSControlled (int fromLane, NBEdge *toEdge, int toLane) const
void moveOutgoingConnectionsFrom (NBEdge *e, unsigned int laneOff)
 NBEdge (const std::string &id, NBNode *from, NBNode *to, std::string type, SUMOReal speed, unsigned int nolanes, int priority, SUMOReal width, SUMOReal offset, const std::string &streetName="", LaneSpreadFunction spread=LANESPREAD_RIGHT)
 Constructor.
 NBEdge (const std::string &id, NBNode *from, NBNode *to, std::string type, SUMOReal speed, unsigned int nolanes, int priority, SUMOReal width, SUMOReal offset, PositionVector geom, const std::string &streetName="", LaneSpreadFunction spread=LANESPREAD_RIGHT, bool tryIgnoreNodePositions=false)
 Constructor.
 NBEdge (const std::string &id, NBNode *from, NBNode *to, NBEdge *tpl)
 Constructor.
bool needsLaneSpecificOutput () const
 whether at least one lane has values differing from the edges values
void preferVehicleClass (int lane, SUMOVehicleClass vclass)
bool recheckLanes ()
void reinit (NBNode *from, NBNode *to, const std::string &type, SUMOReal speed, unsigned int nolanes, int priority, PositionVector geom, SUMOReal width, SUMOReal offset, const std::string &streetName, LaneSpreadFunction spread=LANESPREAD_RIGHT, bool tryIgnoreNodePositions=false)
 Resets initial values.
bool setControllingTLInformation (const NBConnection &c, const std::string &tlID)
 Returns if the link could be set as to be controlled.
void setID (const std::string &newID)
 resets the id
void setJunctionPriority (const NBNode *const node, int prio)
 Sets the junction priority of the edge.
void setLeftHanded ()
 Marks this edge to be left-handed.
void setLoadedLength (SUMOReal val)
void setOffset (int lane, SUMOReal offset)
 set lane specific end-offset (negative lane implies set for all lanes)
void setPermissions (SVCPermissions permissions, int lane=-1)
 set allowed/disallowed classes for the given lane or for all lanes if -1 is given
void setPreferredVehicleClass (SVCPermissions permissions, int lane=-1)
void setSpeed (int lane, SUMOReal offset)
 set lane specific speed (negative lane implies set for all lanes)
void setTurningDestination (NBEdge *e)
void setWidth (int lane, SUMOReal width)
 set lane specific width (negative lane implies set for all lanes)
NBNodetryGetNodeAtPosition (SUMOReal pos, SUMOReal tolerance=5.0) const
 Returns the node at the given edges length (using an epsilon) When no node is existing at the given position, 0 is returned The epsilon is a static member of NBEdge, should be setable via program options.
SUMOReal width () const
 ~NBEdge ()
 Destructor.
Applying offset
void reshiftPosition (SUMOReal xoff, SUMOReal yoff)
 Applies an offset to the edge.
Atomar getter methods
unsigned int getNumLanes () const
 Returns the number of lanes.
int getPriority () const
 Returns the priority of the edge.
NBNodegetFromNode () const
 Returns the origin node of the edge.
NBNodegetToNode () const
 Returns the destination node of the edge.
SUMOReal getAngle () const
 Returns the angle of the edge.
SUMOReal getLength () const
 Returns the computed length of the edge.
SUMOReal getLoadedLength () const
 Returns the length was set explicitly or the computed length if it wasn't set.
bool hasLoadedLength () const
 Returns whether a length was set explicitly.
SUMOReal getSpeed () const
 Returns the speed allowed on this edge.
EdgeBuildingStep getStep () const
 The building step of this edge.
SUMOReal getWidth () const
 Returns the width of lanes of this edge.
const std::string & getStreetName () const
 Returns the street name of this edge.
void setStreetName (const std::string &name)
 sets the street name of this edge
SUMOReal getOffset () const
 Returns the offset to the destination node.
const std::string & getTypeName () const
 Returns the type name.
const std::vector< NBEdge::Lane > & getLanes () const
 Returns the lane definitions.
Edge geometry access and computation
const PositionVectorgetGeometry () const
 Returns the geometry of the edge.
const PositionVector getInnerGeometry () const
 Returns the geometry of the edge without the endpoints.
bool hasDefaultGeometry () const
 Returns whether the geometry consists only of the node positions.
bool hasDefaultGeometryEndpoints () const
 Returns whether the geometry is terminated by the node positions This default may be violated by initializing with tryIgnoreNodePositions=true' or with setGeometry() non-default endpoints are useful to control the generated node shape.
void setGeometry (const PositionVector &g, bool inner=false)
 (Re)sets the edge's geometry
void addGeometryPoint (int index, const Position &p)
 Adds a further geometry point.
void computeEdgeShape ()
 Recomputeds the lane shapes to terminate at the node shape For every lane the intersection with the fromNode and toNode is calculated and the lane shorted accordingly. The edge length is then set to the average of all lane lenghts (which may differ). This average length is used as the lane length when writing the network.
const PositionVectorgetLaneShape (unsigned int i) const
 Returns the shape of the nth lane.
void setLaneSpreadFunction (LaneSpreadFunction spread)
 (Re)sets how the lanes lateral offset shall be computed
LaneSpreadFunction getLaneSpreadFunction () const
 Returns how this edge's lanes' lateral offset is computed.
bool splitGeometry (NBEdgeCont &ec, NBNodeCont &nc)
 Splits this edge at geometry points.
Setting/getting special types
void setAsMacroscopicConnector ()
 Marks this edge as a macroscopic connector.
bool isMacroscopicConnector () const
 Returns whether this edge was marked as a macroscopic connector.
void setIsInnerEdge ()
 Marks this edge being within an intersection.
bool isInnerEdge () const
 Returns whether this edge was marked as being within an intersection.

Static Public Member Functions

static bool connections_sorter (const Connection &c1, const Connection &c2)
static std::pair< SUMOReal,
SUMOReal
laneOffset (const Position &from, const Position &to, SUMOReal lanewidth, unsigned int lane, size_t noLanes, LaneSpreadFunction lsf, bool leftHand)
 Computes the offset from the edge shape on the current segment.

Static Public Attributes

static const SUMOReal UNSPECIFIED_LOADED_LENGTH = -1
 no length override given
static const SUMOReal UNSPECIFIED_OFFSET = 0
 unspecified lane offset
static const SUMOReal UNSPECIFIED_WIDTH = -1
 unspecified lane width

Protected Attributes

std::string myID
 The name of the object.

Private Member Functions

PositionVector computeLaneShape (unsigned int lane) throw (InvalidArgument)
 Computes the shape for the given lane.
void computeLaneShapes ()
unsigned int computePrioritySum (std::vector< unsigned int > *priorities)
void divideOnEdges (const EdgeVector *outgoing)
void init (unsigned int noLanes, bool tryIgnoreNodePositions)
 Initialization routines common to all constructors.
std::pair< SUMOReal, SUMOReallaneOffset (const Position &from, const Position &to, SUMOReal lanewidth, unsigned int lane) throw (InvalidArgument)
 Computes the offset from the edge shape on the current segment.
 NBEdge (const NBEdge &s)
 invalidated copy constructor
NBEdgeoperator= (const NBEdge &s)
 invalidated assignment operator
std::vector< unsigned int > * preparePriorities (const EdgeVector *outgoing)
PositionVector startShapeAt (const PositionVector &laneShape, const NBNode *startNode, unsigned int laneIndex) const

Private Attributes

bool myAmInnerEdge
 Information whether this is a junction-inner edge.
bool myAmLeftHand
 Whether this edge is a left-hand edge.
bool myAmMacroscopicConnector
 Information whether this edge is a (macroscopic) connector.
SUMOReal myAngle
 The angle of the edge.
std::vector< ConnectionmyConnections
 List of connections to following edges.
NBNodemyFrom
 The source and the destination node.
int myFromJunctionPriority
 The priority normalised for the node the edge is outgoing of.
PositionVector myGeom
 The geometry for the edge.
std::vector< LanemyLanes
 Lane information.
LaneSpreadFunction myLaneSpreadFunction
 The information about how to spread the lanes.
SUMOReal myLength
 The length of the edge.
SUMOReal myLoadedLength
 An optional length to use (-1 if not valid)
SUMOReal myOffset
 This edges's offset to the intersection begin (will be applied to all lanes)
int myPriority
 The priority of the edge.
SUMOReal mySpeed
 The maximal speed.
EdgeBuildingStep myStep
 The building step.
std::string myStreetName
 The street name (or whatever arbitrary string you wish to attach)
std::vector
< TLSDisabledConnection
myTLSDisabledConnections
NBNodemyTo
int myToJunctionPriority
 The priority normalised for the node the edge is incoming in.
NBEdgemyTurnDestination
 The turn destination edge.
std::string myType
 The type of the edge.
SUMOReal myWidth
 This width of this edge's lanes.

Friends

class GNEEdge
class GNELane
class NBEdgeCont
class NBEdgeSuccessorBuilder

Setting and getting connections

bool addEdge2EdgeConnection (NBEdge *dest)
 Adds a connection to another edge.
bool addLane2LaneConnection (unsigned int fromLane, NBEdge *dest, unsigned int toLane, Lane2LaneInfoType type, bool mayUseSameDestination=false, bool mayDefinitelyPass=false)
 Adds a connection between the specified this edge's lane and an approached one.
bool addLane2LaneConnections (unsigned int fromLane, NBEdge *dest, unsigned int toLane, unsigned int no, Lane2LaneInfoType type, bool invalidatePrevious=false, bool mayDefinitelyPass=false)
 Builds no connections starting at the given lanes.
void setConnection (unsigned int lane, NBEdge *destEdge, unsigned int destLane, Lane2LaneInfoType type, bool mayUseSameDestination=false, bool mayDefinitelyPass=false)
 Adds a connection to a certain lane of a certain edge.
std::vector< ConnectiongetConnectionsFromLane (unsigned int lane) const
 Returns connections from a given lane.
bool hasConnectionTo (NBEdge *destEdge, unsigned int destLane) const
 Retrieves info about a connection to a certain lane of a certain edge.
bool isConnectedTo (NBEdge *e)
 Returns the information whethe a connection to the given edge has been added (or computed)
const std::vector< Connection > & getConnections () const
 Returns the connections.
std::vector< Connection > & getConnections ()
 Returns the connections.
const EdgeVectorgetConnectedSorted ()
 Returns the list of outgoing edges without the turnaround sorted in clockwise direction.
EdgeVector getConnectedEdges () const
 Returns the list of outgoing edges unsorted.
std::vector< intgetConnectionLanes (NBEdge *currentOutgoing) const
 Returns the list of lanes that may be used to reach the given edge.
void sortOutgoingConnectionsByAngle ()
 sorts the outgoing connections by their angle relative to their junction
void sortOutgoingConnectionsByIndex ()
 sorts the outgoing connections by their from-lane-index and their to-lane-index
void remapConnections (const EdgeVector &incoming)
 Remaps the connection in a way that allows the removal of it.
void removeFromConnections (NBEdge *toEdge, int fromLane=-1, int toLane=-1)
 Removes the specified connection(s)
void invalidateConnections (bool reallowSetting=false)
void replaceInConnections (NBEdge *which, NBEdge *by, unsigned int laneOff)
void replaceInConnections (NBEdge *which, const std::vector< NBEdge::Connection > &origConns)
void copyConnectionsFrom (NBEdge *src)
void moveConnectionToLeft (unsigned int lane)
void moveConnectionToRight (unsigned int lane)

Detailed Description

The representation of a single edge during network building.

Definition at line 69 of file NBEdge.h.


Member Enumeration Documentation

Current state of the edge within the building process.

As the network is build in a cascaded way, considering loaded information, a counter holding the current step is needed. This is done by using this enumeration.

Enumerator:
INIT_REJECT_CONNECTIONS 

The edge has been loaded and connections shall not be added.

INIT 

The edge has been loaded, nothing is computed yet.

EDGE2EDGES 

The relationships between edges are computed/loaded.

LANES2EDGES 

Lanes to edges - relationships are computed/loaded.

LANES2LANES_RECHECK 

Lanes to lanes - relationships are computed; should be recheked.

LANES2LANES_DONE 

Lanes to lanes - relationships are computed; no recheck is necessary/wished.

LANES2LANES_USER 

Lanes to lanes - relationships are loaded; no recheck is necessary/wished.

Definition at line 87 of file NBEdge.h.

Modes of setting connections between lanes.

Enumerator:
L2L_COMPUTED 

The connection was computed.

L2L_USER 

The connection was given by the user.

L2L_VALIDATED 

The connection was computed and validated.

Definition at line 108 of file NBEdge.h.


Constructor & Destructor Documentation

NBEdge::NBEdge ( const std::string &  id,
NBNode from,
NBNode to,
std::string  type,
SUMOReal  speed,
unsigned int  nolanes,
int  priority,
SUMOReal  width,
SUMOReal  offset,
const std::string &  streetName = "",
LaneSpreadFunction  spread = LANESPREAD_RIGHT 
)

Constructor.

Use this if no edge geometry is given.

Parameters:
[in]idThe id of the edge
[in]fromThe node the edge starts at
[in]toThe node the edge ends at
[in]typeThe type of the edge (my be =="")
[in]speedThe maximum velocity allowed on this edge
[in]nolanesThe number of lanes this edge has
[in]priorityThis edge's priority
[in]widthThis edge's lane width
[in]offsetAdditional offset to the destination node
[in]streetNameThe street name (need not be unique)
[in]spreadHow the lateral offset of the lanes shall be computed
See also:
init
LaneSpreadFunction

Definition at line 162 of file NBEdge.cpp.

References init().

Referenced by splitGeometry().

NBEdge::NBEdge ( const std::string &  id,
NBNode from,
NBNode to,
std::string  type,
SUMOReal  speed,
unsigned int  nolanes,
int  priority,
SUMOReal  width,
SUMOReal  offset,
PositionVector  geom,
const std::string &  streetName = "",
LaneSpreadFunction  spread = LANESPREAD_RIGHT,
bool  tryIgnoreNodePositions = false 
)

Constructor.

Use this if the edge's geometry is given.

Parameters:
[in]idThe id of the edge
[in]fromThe node the edge starts at
[in]toThe node the edge ends at
[in]typeThe type of the edge (may be =="")
[in]speedThe maximum velocity allowed on this edge
[in]nolanesThe number of lanes this edge has
[in]priorityThis edge's priority
[in]widthThis edge's lane width
[in]offsetAdditional offset to the destination node
[in]geomThe edge's geomatry
[in]streetNameThe street name (need not be unique)
[in]spreadHow the lateral offset of the lanes shall be computed
[in]tryIgnoreNodePositionsDoes not add node geometries if geom.size()>=2
See also:
init
LaneSpreadFunction

Definition at line 182 of file NBEdge.cpp.

References init().

NBEdge::NBEdge ( const std::string &  id,
NBNode from,
NBNode to,
NBEdge tpl 
)

Constructor.

Use this to copy attribuets from another edge

Parameters:
[in]idThe id of the edge
[in]fromThe node the edge starts at
[in]toThe node the edge ends at
[in]tplThe template edge to copy attributes from

Definition at line 203 of file NBEdge.cpp.

References getLaneSpeed(), getNumLanes(), getPermissions(), init(), setPermissions(), and setSpeed().

NBEdge::~NBEdge ( )

Destructor.

Definition at line 306 of file NBEdge.cpp.

NBEdge::NBEdge ( const NBEdge s)
private

invalidated copy constructor


Member Function Documentation

void NBEdge::addCrossingPointsAsIncomingWithGivenOutgoing ( NBEdge o,
PositionVector into 
)
bool NBEdge::addEdge2EdgeConnection ( NBEdge dest)

Adds a connection to another edge.

If the given edge does not start at the node this edge ends on, false is returned.

All other cases return true. Though, a connection may not been added if this edge is in step "INIT_REJECT_CONNECTIONS". Also, this method assures that a connection to an edge is set only once, no multiple connections to next edge are stored.

After a first connection to an edge was set, the process step is set to "EDGE2EDGES".

Note:
Passing 0 implicitly removes all existing connections
Parameters:
[in]destThe connection's destination edge
Returns:
Whether the connection was valid

Definition at line 497 of file NBEdge.cpp.

References EDGE2EDGES, INIT_REJECT_CONNECTIONS, invalidateConnections(), myConnections, myFrom, myStep, and myTo.

Referenced by addLane2LaneConnection(), NBEdgeCont::joinSameNodeConnectingEdges(), NIXMLConnectionsHandler::myStartElement(), NIImporter_VISUM::parse_Turns(), and remapConnections().

void NBEdge::addGeometryPoint ( int  index,
const Position p 
)

Adds a further geometry point.

Some importer do not know an edge's geometry when it is initialised. This method allows to insert further geometry points after the edge has been built.

Parameters:
[in]indexThe position at which the point shall be added
[in]pThe point to add

Definition at line 445 of file NBEdge.cpp.

References PositionVector::insertAt(), and myGeom.

Referenced by NIImporter_VISUM::parse_EdgePolys().

bool NBEdge::addLane2LaneConnection ( unsigned int  fromLane,
NBEdge dest,
unsigned int  toLane,
Lane2LaneInfoType  type,
bool  mayUseSameDestination = false,
bool  mayDefinitelyPass = false 
)

Adds a connection between the specified this edge's lane and an approached one.

If the given edge does not start at the node this edge ends on, false is returned.

All other cases return true. Though, a connection may not been added if this edge is in step "INIT_REJECT_CONNECTIONS". Before the lane-to-lane connection is set, a connection between edges is established using "addEdge2EdgeConnection". Then, "setConnection" is called for inserting the lane-to-lane connection.

Parameters:
[in]fromLaneThe connection's starting lane (of this edge)
[in]destThe connection's destination edge
[in]toLaneThe connection's destination lane
[in]typeThe connections's type
[in]mayUseSameDestinationWhether this connection may be set though connecting an already connected lane
[in]mayDefinitelyPassWhether this connection is definitely undistrubed (special case for on-ramps)
Returns:
Whether the connection was added / exists
See also:
addEdge2EdgeConnection
setConnection
Todo:
Check difference between "setConnection" and "addLane2LaneConnection"

Definition at line 521 of file NBEdge.cpp.

References addEdge2EdgeConnection(), INIT_REJECT_CONNECTIONS, myFrom, myStep, myTo, and setConnection().

Referenced by NIImporter_SUMO::_loadNetwork(), addLane2LaneConnections(), NIVissimConnection::buildEdgeConnections(), NBNodeCont::joinNodeClusters(), moveOutgoingConnectionsFrom(), NIXMLEdgesHandler::myEndElement(), NIImporter_VISUM::parse_LanesConnections(), NIXMLConnectionsHandler::parseLaneBound(), and NBEdgeCont::splitAt().

bool NBEdge::addLane2LaneConnections ( unsigned int  fromLane,
NBEdge dest,
unsigned int  toLane,
unsigned int  no,
Lane2LaneInfoType  type,
bool  invalidatePrevious = false,
bool  mayDefinitelyPass = false 
)

Builds no connections starting at the given lanes.

If "invalidatePrevious" is true, a call to "invalidateConnections(true)" is done. This method loops through the given connections to set, calling "addLane2LaneConnection" for each.

Parameters:
[in]fromLaneThe first of the connections' starting lanes (of this edge)
[in]destThe connections' destination edge
[in]toLaneThe first of the connections' destination lanes
[in]noThe number of connections to set
[in]typeThe connections' type
[in]invalidatePreviousWhether previously set connection shall be deleted
[in]mayDefinitelyPassWhether these connections are definitely undistrubed (special case for on-ramps)
Returns:
Whether the connections were added / existed
See also:
addLane2LaneConnection
invalidateConnections

Definition at line 543 of file NBEdge.cpp.

References addLane2LaneConnection(), and invalidateConnections().

Referenced by NBNodeCont::buildOffRamp(), NBNodeCont::buildOnRamp(), and NBNode::computeLanes2Lanes().

void NBEdge::allowVehicleClass ( int  lane,
SUMOVehicleClass  vclass 
)

set allowed class for the given lane or for all lanes if -1 is given

Definition at line 1838 of file NBEdge.cpp.

References myLanes.

Referenced by NINavTeqHelper::addVehicleClasses(), disallowVehicleClass(), and preferVehicleClass().

void NBEdge::append ( NBEdge continuation)
void NBEdge::appendTurnaround ( bool  noTLSControlled)

Add a connection to the previously computed turnaround, if wished.

If a turning direction exists (myTurnDestination!=0) and either the edge is not controlled by a tls or noTLSControlled is false, a connection to the edge stored in myTurnDestination is added (from the leftmost lane of this edge to the leftmost lane of myTurnDestination).

Parameters:
[in]noTLSControlledWhether the turnaround shall not be connected if this edge is controlled by a tls

Definition at line 1423 of file NBEdge.cpp.

References getNumLanes(), NBNode::isTLControlled(), L2L_VALIDATED, myLanes, myTo, myTurnDestination, and setConnection().

void NBEdge::clearControllingTLInformation ( )

clears tlID for all connections

Definition at line 1621 of file NBEdge.cpp.

References myConnections.

bool NBEdge::computeEdge2Edges ( bool  noLeftMovers)

computes the edge (step1: computation of approached edges)

Definition at line 1215 of file NBEdge.cpp.

References EDGE2EDGES, NBNode::getOutgoingEdges(), NBNode::isLeftMover(), myConnections, myStep, and myTo.

void NBEdge::computeEdgeShape ( )

Recomputeds the lane shapes to terminate at the node shape For every lane the intersection with the fromNode and toNode is calculated and the lane shorted accordingly. The edge length is then set to the average of all lane lenghts (which may differ). This average length is used as the lane length when writing the network.

Note:
All lanes of an edge in a sumo net must have the same nominal length but may differ in actual geomtric length.
Depends on previous call to NBNodeCont::computeNodeShapes

Definition at line 356 of file NBEdge.cpp.

References Line::atan2DegreeAngle(), GeomHelper::getMinAngleDiff(), PositionVector::length(), myFrom, Named::myID, myLanes, myLength, myTo, POSITION_EPS, PositionVector::reverse(), PositionVector::size(), startShapeAt(), SUMOReal, and WRITE_MESSAGE.

bool NBEdge::computeLanes2Edges ( )

computes the edge, step2: computation of which lanes approach the edges)

Definition at line 1236 of file NBEdge.cpp.

References divideOnEdges(), EDGE2EDGES, getConnectedSorted(), LANES2EDGES, myConnections, and myStep.

void NBEdge::computeLaneShapes ( )
private

Definition at line 1046 of file NBEdge.cpp.

References computeLaneShape(), Named::getID(), myFrom, myGeom, myLanes, myTo, and WRITE_WARNING.

Referenced by decLaneNo(), incLaneNo(), init(), and setGeometry().

unsigned int NBEdge::computePrioritySum ( std::vector< unsigned int > *  priorities)
private

computes the sum of the given list's entries (sic!)

Definition at line 1413 of file NBEdge.cpp.

Referenced by divideOnEdges().

static bool NBEdge::connections_sorter ( const Connection c1,
const Connection c2 
)
inlinestatic
void NBEdge::copyConnectionsFrom ( NBEdge src)

Definition at line 829 of file NBEdge.cpp.

References myConnections, and myStep.

Referenced by NBEdgeCont::splitAt().

void NBEdge::decLaneNo ( unsigned int  by,
int  dir = 0 
)
void NBEdge::declareConnectionsAsLoaded ( )
inline

Definition at line 950 of file NBEdge.h.

References LANES2LANES_USER, and myStep.

Referenced by NIImporter_SUMO::_loadNetwork().

void NBEdge::disableConnection4TLS ( int  fromLane,
NBEdge toEdge,
int  toLane 
)
void NBEdge::disallowVehicleClass ( int  lane,
SUMOVehicleClass  vclass 
)

set disallowed class for the given lane or for all lanes if -1 is given

Definition at line 1851 of file NBEdge.cpp.

References allowVehicleClass(), and myLanes.

void NBEdge::dismissVehicleClassInformation ( )

Definition at line 1974 of file NBEdge.cpp.

References myLanes, and SVCFreeForAll.

Referenced by NBEdgeCont::insert().

void NBEdge::divideOnEdges ( const EdgeVector outgoing)
private
bool NBEdge::expandableBy ( NBEdge possContinuation) const

!! if (myAllowedOnLanes!=possContinuation->myAllowedOnLanes || myNotAllowedOnLanes!=possContinuation->myNotAllowedOnLanes) { return false; }

Definition at line 1675 of file NBEdge.cpp.

References EDGE2EDGES, getConnectedEdges(), getConnectionLanes(), getPriority(), INIT, INIT_REJECT_CONNECTIONS, LANES2EDGES, LANES2LANES_DONE, LANES2LANES_RECHECK, LANES2LANES_USER, myConnections, myLanes, mySpeed, and myStep.

SUMOReal NBEdge::getAngle ( ) const
inline
SUMOReal NBEdge::getAngleAtNode ( const NBNode *const  node) const

Returns the angle of the edge's geometry at the given node.

The angle is signed, regards direction, and starts at 12 o'clock (north->south), proceeds positive clockwise.

Parameters:
[in]nodeThe node for which the edge's angle shall be returned
Returns:
This edge's angle at the given node

Definition at line 1023 of file NBEdge.cpp.

References Line::atan2DegreeAngle(), PositionVector::getBegLine(), PositionVector::getEndLine(), myFrom, myGeom, and myTo.

Referenced by NBNode::computeLanes2Lanes(), NBTurningDirectionsComputer::computeTurnDirectionsForNode(), NBNodesEdgesSorter::edge_by_junction_angle_sorter::getConvAngle(), NBNode::getDirection(), NBNode::isLeftMover(), isTurningDirectionAt(), and NBEdgePriorityComputer::setPriorityJunctionPriorities().

PositionVector NBEdge::getCCWBoundaryLine ( const NBNode n,
SUMOReal  offset 
) const

Definition at line 1654 of file NBEdge.cpp.

References PositionVector::move2side(), myAmLeftHand, myFrom, and myLanes.

EdgeVector NBEdge::getConnectedEdges ( ) const

Returns the list of outgoing edges unsorted.

Returns:
Connected edges

Definition at line 674 of file NBEdge.cpp.

References myConnections.

Referenced by NIVissimDisturbance::addToNode(), expandableBy(), NBTrafficLightDefinition::forbids(), NBContHelper::same_connection_edge_sorter::getMinMaxRelAngles(), and remapConnections().

const EdgeVector * NBEdge::getConnectedSorted ( )

Returns the list of outgoing edges without the turnaround sorted in clockwise direction.

Returns:
Connected edges, sorted clockwise

Definition at line 646 of file NBEdge.cpp.

References NBNode::getOutgoingEdges(), myConnections, myTo, and myTurnDestination.

Referenced by computeLanes2Edges().

std::vector< int > NBEdge::getConnectionLanes ( NBEdge currentOutgoing) const

Returns the list of lanes that may be used to reach the given edge.

Returns:
Lanes approaching the given edge

Definition at line 686 of file NBEdge.cpp.

References myConnections, and myTurnDestination.

Referenced by NBNode::ApproachingDivider::execute(), and expandableBy().

const std::vector<Connection>& NBEdge::getConnections ( ) const
inline
std::vector<Connection>& NBEdge::getConnections ( )
inline

Returns the connections.

Returns:
This edge's connections to following edges

Definition at line 676 of file NBEdge.h.

References myConnections.

std::vector< NBEdge::Connection > NBEdge::getConnectionsFromLane ( unsigned int  lane) const

Returns connections from a given lane.

This method goes through "myConnections" and copies those which are starting at the given lane.

Parameters:
[in]laneThe lane which connections shall be returned
Returns:
The connections from the given lane
See also:
NBEdge::Connection

Definition at line 615 of file NBEdge.cpp.

References myConnections.

Referenced by NIVissimTL::NIVissimTLSignal::addTo(), NBOwnTLDef::collectLinks(), NBLoadedTLDef::collectLinks(), NBOwnTLDef::computeUnblockedWeightedStreamNumber(), moveOutgoingConnectionsFrom(), NBOwnTLDef::myCompute(), and NBRequest::writeLaneResponse().

PositionVector NBEdge::getCWBoundaryLine ( const NBNode n,
SUMOReal  offset 
) const

Definition at line 1639 of file NBEdge.cpp.

References PositionVector::move2side(), myAmLeftHand, myFrom, and myLanes.

const std::string& Named::getID ( ) const
inlineinherited

Returns the id.

Returns:
The stored id

Reimplemented in MS_E2_ZS_CollectorOverLanes.

Definition at line 61 of file Named.h.

References Named::myID.

Referenced by MSDetectorControl::add(), ShapeContainer::add(), RORouteDef_Alternatives::addAlternative(), MSNet::addBusStop(), NBLoadedSUMOTLDef::addConnection(), NLHandler::addConnection(), NIImporter_OpenDrive::addE2EConnectionsSecure(), RONet::addNode(), NIImporter_SUMO::addPhase(), RONet::addRouteDef(), NBDistrict::addSink(), NBDistrict::addSource(), MSRouteHandler::addStop(), NIXMLTrafficLightsHandler::addTlConnection(), NIVissimDisturbance::addToNode(), MSVehicle::addTraciStop(), NIVisumTL::build(), MS_E2_ZS_CollectorOverLanes::buildCollector(), NIImporter_VISUM::buildDistrictNode(), NIVissimConnection::buildEdgeConnections(), buildInnerEdges(), NIVissimEdge::buildNBEdge(), NBNodeCont::buildOffRamp(), NBNodeCont::buildOnRamp(), ODDistrictHandler::closeDistrict(), NBTrafficLightDefinition::collectEdges(), NBOwnTLDef::collectLinks(), NBTrafficLightDefinition::compute(), NBNode::computeInternalLaneShape(), computeLaneShapes(), NBNode::computeLogic(), NBNode::computeNodeShape(), NBTrafficLightLogicCont::computeSingleLogic(), NBTurningDirectionsComputer::computeTurnDirectionsForNode(), connections_sorter(), MSLane::detectCollisions(), NIVissimDistrictConnection::dict_BuildDistricts(), MSE3Collector::enter(), Command_SaveTLSSwitches::execute(), MSVTypeProbe::execute(), NBNodeCont::extract(), NBTrafficLightLogicCont::extract(), NBEdgeCont::extract(), MSNet::getBusStopID(), NIImporter_VISUM::getNamedEdgeContinuating(), NLTriggerBuilder::getPosition(), NBNode::getPossiblySplittedIncoming(), NBNode::getPossiblySplittedOutgoing(), NIImporter_VISUM::getReversedContinuating(), NBEdgeCont::ignoreFilterMatch(), MSActuatedTrafficLightLogic::init(), MSAgentbasedTrafficLightLogic::init(), NIImporter_SUMO::initTrafficLightLogic(), NIXMLTrafficLightsHandler::initTrafficLightLogic(), NBDistrictCont::insert(), NBTrafficLightLogicCont::insert(), NBNodeCont::insert(), NBEdgeCont::insert(), NBEdgeCont::joinSameNodeConnectingEdges(), MSE3Collector::leave(), NIImporter_OpenDrive::loadNetwork(), MSLane::moveCritical(), MSVehicle::MSVehicle(), RORDLoader_SUMOBase::myCharacters(), NBOwnTLDef::myCompute(), NBLoadedTLDef::myCompute(), NIXMLTrafficLightsHandler::myEndElement(), NIXMLEdgesHandler::myEndElement(), NIImporter_SUMO::myEndElement(), NIXMLConnectionsHandler::myStartElement(), MSLaneSpeedTrigger::myStartElement(), MSTriggeredRerouter::myStartElement(), NBConnection::NBConnection(), NBRequest::NBRequest(), MSDevice_Tripinfo::notifyEnter(), MSDevice_Tripinfo::notifyLeave(), Named::ComparatorIdLess::operator()(), NBTurningDirectionsComputer::combination_by_angle_sorter::operator()(), NBOwnTLDef::edge_by_incoming_priority_sorter::operator()(), NBNetBuilder::by_id_sorter::operator()(), NBContHelper::same_connection_edge_sorter::operator()(), NBNode::nodes_by_id_sorter::operator()(), NIImporter_VISUM::parse_EdgePolys(), NIImporter_VISUM::parse_Lanes(), NIImporter_VISUM::parse_LanesConnections(), NIImporter_VISUM::parse_Turns(), NIImporter_VISUM::parse_TurnsToSignalGroups(), NIXMLConnectionsHandler::parseDeprecatedLaneDefinition(), NIXMLConnectionsHandler::parseLaneBound(), NBLoadedTLDef::SignalGroup::patchTYellow(), RORouteDef_Complete::preComputeCurrentRoute(), TraCIServerAPI_Lane::processGet(), TraCIServerAPI_TLS::processGet(), TraCIServerAPI_InductionLoop::processGet(), TraCIServerAPI_Vehicle::processGet(), NWWriter_SUMO::prohibitionConnection(), NBLoadedTLDef::SignalGroup::remapIncoming(), NBLoadedTLDef::SignalGroup::remapOutgoing(), NBLoadedSUMOTLDef::removeConnection(), NBNode::removeSelfLoops(), NBEdgeCont::removeUnwishedEdges(), NBNodeCont::removeUnwishedNodes(), NBNodeCont::rename(), NBEdgeCont::rename(), NBConnection::replaceFrom(), MSBaseVehicle::replaceRouteEdges(), NBConnection::replaceTo(), NIXMLTrafficLightsHandler::retrieveLaneIndex(), NBNodeCont::setAsTLControlled(), setControllingTLInformation(), MSLane::setCritical(), NIXMLEdgesHandler::setNodes(), NBOwnTLDef::setTLControllingInformation(), NBLoadedSUMOTLDef::setTLControllingInformation(), NBLoadedTLDef::setTLControllingInformation(), NBEdgeCont::splitAt(), RORDLoader_SUMOBase::startRoute(), startShapeAt(), NIXMLConnectionsHandler::validateLaneInfo(), MSInstantInductLoop::write(), NWWriter_SUMO::writeConnection(), NWWriter_SUMO::writeDistrict(), NWWriter_SUMO::writeEdge(), MSMeanData::writeEdge(), NWWriter_XML::writeEdgesAndConnections(), NWWriter_SUMO::writeInternalConnections(), NWWriter_SUMO::writeJunction(), NWWriter_OpenDrive::writeNetwork(), NWWriter_XML::writeNodes(), MSInductLoop::writeTypedXMLOutput(), MSRouteProbe::writeXMLOutput(), and MSE2Collector::writeXMLOutput().

const PositionVector NBEdge::getInnerGeometry ( ) const

Returns the geometry of the edge without the endpoints.

Definition at line 321 of file NBEdge.cpp.

References getGeometry(), PositionVector::pop_back(), and PositionVector::pop_front().

int NBEdge::getJunctionPriority ( const NBNode *const  node) const

Returns the junction priority (normalised for the node currently build)

If the given node is neither the edge's start nor the edge's ending node, the behaviour is undefined.

Parameters:
[in]nodeThe node for which the edge's priority shall be returned
Returns:
The edge's priority at the given node
Todo:
Maybe the edge priority whould be stored in the node

Definition at line 1003 of file NBEdge.cpp.

References myFrom, myFromJunctionPriority, and myToJunctionPriority.

Referenced by NBOwnTLDef::getToPrio(), NBEdge::MainDirections::MainDirections(), NBNode::needsCont(), NBOwnTLDef::edge_by_incoming_priority_sorter::operator()(), and NBRequest::setBlocking().

std::string NBEdge::getLaneID ( unsigned int  lane) const
const std::vector<NBEdge::Lane>& NBEdge::getLanes ( ) const
inline

Returns the lane definitions.

Returns:
The stored lane definitions

Definition at line 444 of file NBEdge.h.

References myLanes.

Referenced by NWWriter_SUMO::writeEdge(), NWWriter_XML::writeEdgesAndConnections(), and NWWriter_OpenDrive::writeNetwork().

const PositionVector & NBEdge::getLaneShape ( unsigned int  i) const

Returns the shape of the nth lane.

Returns:
The shape of the lane given by its index (counter from right)

Definition at line 433 of file NBEdge.cpp.

References myLanes.

Referenced by buildInnerEdges(), and NBNode::computeInternalLaneShape().

SUMOReal NBEdge::getLaneSpeed ( unsigned int  lane) const

Definition at line 1040 of file NBEdge.cpp.

References myLanes.

Referenced by NBEdge(), and NBEdgeCont::splitAt().

LaneSpreadFunction NBEdge::getLaneSpreadFunction ( ) const
inline

Returns how this edge's lanes' lateral offset is computed.

Returns:
The type of lateral offset that is applied on this edge
See also:
LaneSpreadFunction

Definition at line 533 of file NBEdge.h.

References myLaneSpreadFunction.

Referenced by NIXMLEdgesHandler::addEdge(), NBNodeCont::buildOffRamp(), NBNodeCont::buildOnRamp(), NBNodeCont::joinNodeClusters(), NWWriter_SUMO::writeEdge(), and NWWriter_XML::writeEdgesAndConnections().

Lane& NBEdge::getLaneStruct ( unsigned int  lane)
inline

Definition at line 939 of file NBEdge.h.

References myLanes.

Referenced by NBNode::computeInternalLaneShape().

const Lane& NBEdge::getLaneStruct ( unsigned int  lane) const
inline

Definition at line 944 of file NBEdge.h.

References myLanes.

SUMOReal NBEdge::getLength ( ) const
inline

Returns the computed length of the edge.

Returns:
The edge's computed length

Definition at line 365 of file NBEdge.h.

References myLength.

Referenced by NBJoinedEdgesMap::init(), NIXMLEdgesHandler::myEndElement(), NIImporter_VISUM::parse_Lanes(), NBEdgeCont::retrievePossiblySplitted(), and NWWriter_OpenDrive::writeNetwork().

SUMOReal NBEdge::getLoadedLength ( ) const
inline

Returns the length was set explicitly or the computed length if it wasn't set.

Todo:
consolidate use of myLength and myLoaded length
Returns:
The edge's specified length

Definition at line 374 of file NBEdge.h.

References myLength, and myLoadedLength.

Referenced by NIXMLEdgesHandler::addEdge(), NBNodeCont::joinSimilarEdges(), NWWriter_SUMO::writeEdge(), and NWWriter_XML::writeEdgesAndConnections().

SUMOReal NBEdge::getMaxLaneOffset ( )

Definition at line 1501 of file NBEdge.cpp.

References myLanes, SUMO_const_laneWidthAndOffset, and SUMOReal.

Position NBEdge::getMaxLaneOffsetPositionAt ( NBNode node,
SUMOReal  width 
) const
Position NBEdge::getMinLaneOffsetPositionAt ( NBNode node,
SUMOReal  width 
) const
SUMOReal NBEdge::getOffset ( ) const
inline

Returns the offset to the destination node.

Returns:
The offset to the destination node

Definition at line 428 of file NBEdge.h.

References myOffset.

Referenced by NIXMLEdgesHandler::addEdge(), hasLaneSpecificOffset(), NBNodeCont::joinNodeClusters(), and NWWriter_XML::writeEdgesAndConnections().

SVCPermissions NBEdge::getPermissions ( int  lane = -1) const

get the union of allowed classes over all lanes or for a specific lane

Definition at line 1953 of file NBEdge.cpp.

References myLanes.

Referenced by NIXMLEdgesHandler::addEdge(), NBEdgeCont::ignoreFilterMatch(), and NBEdge().

EdgeBuildingStep NBEdge::getStep ( ) const
inline

The building step of this edge.

Returns:
The current building step for this edge
Todo:
Recheck usage!
See also:
EdgeBuildingStep

Definition at line 400 of file NBEdge.h.

References myStep.

const std::string& NBEdge::getStreetName ( ) const
inline
NBNode* NBEdge::getToNode ( ) const
inline
const std::string& NBEdge::getTypeID ( ) const
inline
const std::string& NBEdge::getTypeName ( ) const
inline

Returns the type name.

Returns:
The name of this edge's type

Definition at line 436 of file NBEdge.h.

References myType.

Referenced by NWWriter_SUMO::writeEdge().

SUMOReal NBEdge::getWidth ( ) const
inline

Returns the width of lanes of this edge.

Returns:
The width of lanes of this edge

Definition at line 408 of file NBEdge.h.

References myWidth.

Referenced by NIXMLEdgesHandler::addEdge(), hasLaneSpecificWidth(), NBNodeCont::joinNodeClusters(), and NWWriter_XML::writeEdgesAndConnections().

bool NBEdge::hasConnectionTo ( NBEdge destEdge,
unsigned int  destLane 
) const

Retrieves info about a connection to a certain lane of a certain edge.

Turnaround edge is ignored!

Parameters:
[in]destEdgeThe connection's destination edge
[in]destLaneThe connection's destination lane
Returns:
whether a connection to the specified lane exists

Definition at line 627 of file NBEdge.cpp.

References myConnections.

Referenced by NIXMLConnectionsHandler::myStartElement(), NIXMLConnectionsHandler::parseLaneBound(), and setConnection().

bool NBEdge::hasDefaultGeometry ( ) const

Returns whether the geometry consists only of the node positions.

Definition at line 330 of file NBEdge.cpp.

References hasDefaultGeometryEndpoints(), myGeom, and PositionVector::size().

Referenced by NIXMLEdgesHandler::addEdge(), NWWriter_SUMO::writeEdge(), and NWWriter_XML::writeEdgesAndConnections().

bool NBEdge::hasDefaultGeometryEndpoints ( ) const

Returns whether the geometry is terminated by the node positions This default may be violated by initializing with tryIgnoreNodePositions=true' or with setGeometry() non-default endpoints are useful to control the generated node shape.

Definition at line 336 of file NBEdge.cpp.

References PositionVector::getBegin(), PositionVector::getEnd(), NBNode::getPosition(), myFrom, myGeom, and myTo.

Referenced by hasDefaultGeometry().

bool NBEdge::hasLaneSpecificOffset ( ) const

whether lanes differ in offset

Definition at line 1197 of file NBEdge.cpp.

References getOffset(), and myLanes.

Referenced by needsLaneSpecificOutput(), and NWWriter_XML::writeEdgesAndConnections().

bool NBEdge::hasLaneSpecificPermissions ( ) const

whether lanes differ in allowed vehicle classes

Definition at line 1161 of file NBEdge.cpp.

References myLanes.

bool NBEdge::hasLaneSpecificSpeed ( ) const

whether lanes differ in speed

Definition at line 1186 of file NBEdge.cpp.

References getSpeed(), and myLanes.

Referenced by needsLaneSpecificOutput(), and NWWriter_XML::writeEdgesAndConnections().

bool NBEdge::hasLaneSpecificWidth ( ) const

whether lanes differ in width

Definition at line 1175 of file NBEdge.cpp.

References getWidth(), and myLanes.

Referenced by needsLaneSpecificOutput(), NWWriter_XML::writeEdgesAndConnections(), and NWWriter_OpenDrive::writeNetwork().

bool NBEdge::hasLoadedLength ( ) const
inline

Returns whether a length was set explicitly.

Returns:
Wether the edge's length was specified

Definition at line 382 of file NBEdge.h.

References myLoadedLength.

Referenced by NIXMLEdgesHandler::addEdge(), NWWriter_SUMO::writeEdge(), and NWWriter_XML::writeEdgesAndConnections().

bool NBEdge::hasRestrictions ( ) const

whether at least one lane has restrictions

Definition at line 1150 of file NBEdge.cpp.

References myLanes, and SVCFreeForAll.

Referenced by needsLaneSpecificOutput().

bool NBEdge::hasSignalisedConnectionTo ( const NBEdge *const  e) const

Definition at line 1758 of file NBEdge.cpp.

References myConnections.

Referenced by NBRequest::forbids().

void NBEdge::init ( unsigned int  noLanes,
bool  tryIgnoreNodePositions 
)
private

Initialization routines common to all constructors.

Checks whether the number of lanes>0, whether the junction's from- and to-nodes are given (!=0) and whether they are distict. Throws a ProcessError if any of these checks fails.

Adds the nodes positions to geometry if it shall not be ignored or if the geometry is empty.

Computes the angle and length, and adds this edge to its node as outgoing/incoming. Builds lane informations.

Parameters:
[in]noLanesThe number of lanes this edge has
[in]tryIgnoreNodePositionsDoes not add node geometries if geom.size()>=2

Definition at line 259 of file NBEdge.cpp.

References PositionVector::add(), NBNode::addIncomingEdge(), NBNode::addOutgoingEdge(), NBHelpers::angle(), PositionVector::clear(), computeLaneShapes(), Position::distanceTo(), NBNode::getPosition(), myAngle, myFrom, myGeom, Named::myID, myLanes, myLength, myTo, POSITION_EPS, PositionVector::push_back(), PositionVector::push_back_noDoublePos(), PositionVector::push_front(), PositionVector::push_front_noDoublePos(), PositionVector::removeDoublePoints(), PositionVector::size(), WRITE_ERROR, Position::x(), and Position::y().

Referenced by NBEdge(), and reinit().

bool NBEdge::isConnectedTo ( NBEdge e)

Returns the information whethe a connection to the given edge has been added (or computed)

Turnaround edge is not ignored!

Parameters:
[in]eThe destination edge
Returns:
Whether a connection to the specified edge exists

Definition at line 633 of file NBEdge.cpp.

References myConnections, and myTurnDestination.

Referenced by NBTurningDirectionsComputer::computeTurnDirectionsForNode(), NIXMLConnectionsHandler::myStartElement(), and NBNode::removeSelfLoops().

bool NBEdge::isInnerEdge ( ) const
inline

Returns whether this edge was marked as being within an intersection.

Returns:
Whether this edge was marked as being within an intersection

Definition at line 771 of file NBEdge.h.

References myAmInnerEdge.

Referenced by NBNode::stateCode().

bool NBEdge::isMacroscopicConnector ( ) const
inline

Returns whether this edge was marked as a macroscopic connector.

Returns:
Whether this edge was marked as a macroscopic connector

Definition at line 756 of file NBEdge.h.

References myAmMacroscopicConnector.

Referenced by NBNodeCont::mayNeedOffRamp(), NBNodeCont::mayNeedOnRamp(), and NWWriter_SUMO::writeEdge().

bool NBEdge::isNearEnough2BeJoined2 ( NBEdge e,
SUMOReal  threshold 
) const

Definition at line 1782 of file NBEdge.cpp.

References PositionVector::distances(), getGeometry(), and myGeom.

Referenced by NBNodeCont::joinSimilarEdges().

bool NBEdge::isTurningDirectionAt ( const NBNode n,
const NBEdge *const  edge 
) const

Returns whether the given edge is the opposite direction to this edge.

Parameters:
[in]nThe node at which this may be turnaround direction
[in]edgeThe edge which may be the turnaround direction
Returns:
Whether the given edge is this edge's turnaround direction

Definition at line 1438 of file NBEdge.cpp.

References getAngleAtNode(), myFrom, myTo, myTurnDestination, and SUMOReal.

Referenced by NBNode::getDirection(), NBNode::isLeftMover(), NBOwnTLDef::myCompute(), NBContHelper::opposite_finder::operator()(), NBRequest::setBlocking(), and NBNodesEdgesSorter::swapWhenReversed().

std::pair< SUMOReal, SUMOReal > NBEdge::laneOffset ( const Position from,
const Position to,
SUMOReal  lanewidth,
unsigned int  lane,
size_t  noLanes,
LaneSpreadFunction  lsf,
bool  leftHand 
)
static

Computes the offset from the edge shape on the current segment.

Definition at line 1127 of file NBEdge.cpp.

References GeomHelper::getNormal90D_CW(), LANESPREAD_RIGHT, and SUMOReal.

Referenced by NIImporter_SUMO::reconstructEdgeShape().

std::pair< SUMOReal, SUMOReal > NBEdge::laneOffset ( const Position from,
const Position to,
SUMOReal  lanewidth,
unsigned int  lane 
) throw (InvalidArgument)
private

Computes the offset from the edge shape on the current segment.

Definition at line 1119 of file NBEdge.cpp.

bool NBEdge::lanesWereAssigned ( ) const

Definition at line 1495 of file NBEdge.cpp.

References LANES2LANES_DONE, LANES2LANES_USER, and myStep.

Referenced by NIVissimTL::NIVissimTLSignal::addTo().

void NBEdge::markAsInLane2LaneState ( )

Definition at line 1831 of file NBEdge.cpp.

References NBNode::getOutgoingEdges(), LANES2LANES_DONE, myStep, and myTo.

bool NBEdge::mayBeTLSControlled ( int  fromLane,
NBEdge toEdge,
int  toLane 
) const
void NBEdge::moveConnectionToLeft ( unsigned int  lane)
private

moves a connection one place to the left; Attention! no checking for field validity

Definition at line 836 of file NBEdge.cpp.

References getTurnDestination(), L2L_VALIDATED, myAmLeftHand, myConnections, setConnection(), NBEdge::Connection::toEdge, and NBEdge::Connection::toLane.

Referenced by recheckLanes().

void NBEdge::moveConnectionToRight ( unsigned int  lane)
private

moves a connection one place to the right; Attention! no checking for field validity

Definition at line 859 of file NBEdge.cpp.

References getTurnDestination(), L2L_VALIDATED, myAmLeftHand, myConnections, setConnection(), NBEdge::Connection::toEdge, and NBEdge::Connection::toLane.

Referenced by recheckLanes().

void NBEdge::moveOutgoingConnectionsFrom ( NBEdge e,
unsigned int  laneOff 
)
bool NBEdge::needsLaneSpecificOutput ( ) const

whether at least one lane has values differing from the edges values

Definition at line 1208 of file NBEdge.cpp.

References hasLaneSpecificOffset(), hasLaneSpecificSpeed(), hasLaneSpecificWidth(), and hasRestrictions().

Referenced by NWWriter_XML::writeEdgesAndConnections().

NBEdge& NBEdge::operator= ( const NBEdge s)
private

invalidated assignment operator

void NBEdge::preferVehicleClass ( int  lane,
SUMOVehicleClass  vclass 
)

Definition at line 1864 of file NBEdge.cpp.

References allowVehicleClass(), and myLanes.

std::vector< unsigned int > * NBEdge::preparePriorities ( const EdgeVector outgoing)
private

recomputes the priorities and manipulates them for a distribution of lanes on edges which is more like in real-life

Definition at line 1371 of file NBEdge.cpp.

References NBEdge::MainDirections::DIR_FORWARD, NBEdge::MainDirections::DIR_RIGHTMOST, NBEdge::MainDirections::empty(), NBEdge::MainDirections::includes(), myLanes, and myTo.

Referenced by divideOnEdges().

bool NBEdge::recheckLanes ( )

recheck whether all lanes within the edge are all right and optimises the connections once again

Definition at line 1260 of file NBEdge.cpp.

References LANES2LANES_DONE, LANES2LANES_USER, moveConnectionToLeft(), moveConnectionToRight(), myConnections, myLanes, and myStep.

void NBEdge::reinit ( NBNode from,
NBNode to,
const std::string &  type,
SUMOReal  speed,
unsigned int  nolanes,
int  priority,
PositionVector  geom,
SUMOReal  width,
SUMOReal  offset,
const std::string &  streetName,
LaneSpreadFunction  spread = LANESPREAD_RIGHT,
bool  tryIgnoreNodePositions = false 
)

Resets initial values.

Parameters:
[in]fromThe node the edge starts at
[in]toThe node the edge ends at
[in]typeThe type of the edge (may be =="")
[in]speedThe maximum velocity allowed on this edge
[in]nolanesThe number of lanes this edge has
[in]priorityThis edge's priority
[in]geomThe edge's geomatry
[in]widthThis edge's lane width
[in]offsetAdditional offset to the destination node
[in]streetNameThe street name (need not be unique)
[in]spreadHow the lateral offset of the lanes shall be computed
[in]tryIgnoreNodePositionsDoes not add node geometries if geom.size()>=2

Definition at line 226 of file NBEdge.cpp.

References StringUtils::convertUmlaute(), init(), myFrom, myGeom, myLaneSpreadFunction, myLoadedLength, myOffset, myPriority, mySpeed, myStreetName, myTo, myType, myWidth, NBNode::removeEdge(), UNSPECIFIED_LOADED_LENGTH, and width().

Referenced by NIXMLEdgesHandler::addEdge(), and NBNodeCont::joinNodeClusters().

void NBEdge::remapConnections ( const EdgeVector incoming)

Remaps the connection in a way that allows the removal of it.

This edge (which is a self loop edge, in fact) connections are spread over the valid incoming edges

Todo:
recheck!

Definition at line 712 of file NBEdge.cpp.

References addEdge2EdgeConnection(), EDGE2EDGES, getConnectedEdges(), myStep, and removeFromConnections().

Referenced by NBNode::removeSelfLoops().

void NBEdge::removeFromConnections ( NBEdge toEdge,
int  fromLane = -1,
int  toLane = -1 
)

Removes the specified connection(s)

Parameters:
[in]toEdgeThe destination edge
[in]fromLaneThe lane from which connections shall be removed; -1 means remove all
[in]toLaneThe lane to which connections shall be removed; -1 means remove all

Definition at line 728 of file NBEdge.cpp.

References NBEdge::Connection::fromLane, myConnections, myTurnDestination, NBEdge::Connection::toEdge, and NBEdge::Connection::toLane.

Referenced by decLaneNo(), NIXMLConnectionsHandler::myStartElement(), remapConnections(), and replaceInConnections().

void NBEdge::replaceInConnections ( NBEdge which,
NBEdge by,
unsigned int  laneOff 
)

Definition at line 760 of file NBEdge.cpp.

References myConnections, myTurnDestination, and UNUSED_PARAMETER.

Referenced by NBNode::replaceOutgoing().

void NBEdge::replaceInConnections ( NBEdge which,
const std::vector< NBEdge::Connection > &  origConns 
)

Definition at line 775 of file NBEdge.cpp.

References L2L_COMPUTED, myConnections, removeFromConnections(), and setConnection().

void NBEdge::reshiftPosition ( SUMOReal  xoff,
SUMOReal  yoff 
)

Applies an offset to the edge.

Parameters:
[in]xoffThe x-offset to apply
[in]yoffThe y-offset to apply

Definition at line 311 of file NBEdge.cpp.

References myGeom, myLanes, and PositionVector::reshiftRotate().

void NBEdge::setAsMacroscopicConnector ( )
inline

Marks this edge as a macroscopic connector.

Definition at line 748 of file NBEdge.h.

References myAmMacroscopicConnector.

Referenced by NIImporter_VISUM::parse_Connectors().

void NBEdge::setConnection ( unsigned int  lane,
NBEdge destEdge,
unsigned int  destLane,
Lane2LaneInfoType  type,
bool  mayUseSameDestination = false,
bool  mayDefinitelyPass = false 
)

Adds a connection to a certain lane of a certain edge.

Parameters:
[in]laneThe connection's starting lane (of this edge)
[in]destEdgeThe connection's destination edge
[in]destLaneThe connection's destination lane
[in]typeThe connections's type
[in]mayUseSameDestinationWhether this connection may be set though connecting an already connected lane
[in]mayDefinitelyPassWhether this connection is definitely undistrubed (special case for on-ramps)
Todo:
Check difference between "setConnection" and "addLane2LaneConnection"

Definition at line 560 of file NBEdge.cpp.

References getLaneID(), hasConnectionTo(), INIT_REJECT_CONNECTIONS, L2L_COMPUTED, L2L_USER, LANES2LANES_DONE, LANES2LANES_RECHECK, LANES2LANES_USER, myConnections, myLanes, myStep, and WRITE_ERROR.

Referenced by addLane2LaneConnection(), appendTurnaround(), NBNode::computeLanes2Lanes(), moveConnectionToLeft(), moveConnectionToRight(), and replaceInConnections().

void NBEdge::setGeometry ( const PositionVector g,
bool  inner = false 
)

(Re)sets the edge's geometry

Replaces the edge's prior geometry by the given. Then, computes the geometries of all lanes using computeLaneShapes. Definitely not the best way to have it accessable from outside...

Parameters:
[in]gThe edge's new geometry
[in]innerwhether g should be interpreted as inner points
Todo:
Recheck usage, disallow access
See also:
computeLaneShapes

Definition at line 343 of file NBEdge.cpp.

References computeLaneShapes(), PositionVector::getBegin(), PositionVector::getEnd(), myGeom, PositionVector::push_back(), and PositionVector::push_front().

Referenced by NBNodeCont::buildOffRamp(), NBNodeCont::buildOnRamp(), NBNodeCont::joinNodeClusters(), and NIXMLEdgesHandler::myEndElement().

void Named::setID ( const std::string &  newID)
inlineinherited

resets the id

Definition at line 67 of file Named.h.

References Named::myID.

Referenced by NBNodeCont::rename(), and NBEdgeCont::rename().

void NBEdge::setIsInnerEdge ( )
inline

Marks this edge being within an intersection.

Definition at line 763 of file NBEdge.h.

References myAmInnerEdge.

void NBEdge::setJunctionPriority ( const NBNode *const  node,
int  prio 
)

Sets the junction priority of the edge.

Parameters:
[in]nodeThe node for which the edge's priority is given
[in]prioThe edge's new priority at this node
Todo:
Maybe the edge priority whould be stored in the node

Definition at line 1013 of file NBEdge.cpp.

References myFrom, myFromJunctionPriority, and myToJunctionPriority.

Referenced by NBEdgePriorityComputer::extractAndMarkFirst(), and NBEdgePriorityComputer::setPriorityJunctionPriorities().

void NBEdge::setLaneSpreadFunction ( LaneSpreadFunction  spread)

(Re)sets how the lanes lateral offset shall be computed

Parameters:
[in]spreadThe type of lateral offset to apply
See also:
LaneSpreadFunction

Definition at line 439 of file NBEdge.cpp.

References myLaneSpreadFunction.

Referenced by NIImporter_VISUM::parse_Edges().

void NBEdge::setLeftHanded ( )
inline

Marks this edge to be left-handed.

Definition at line 310 of file NBEdge.h.

References myAmLeftHand.

Referenced by NBEdgeCont::insert().

void NBEdge::setLoadedLength ( SUMOReal  val)
void NBEdge::setOffset ( int  lane,
SUMOReal  offset 
)

set lane specific end-offset (negative lane implies set for all lanes)

Definition at line 1893 of file NBEdge.cpp.

References myLanes, and myOffset.

Referenced by NIImporter_SUMO::_loadNetwork(), and NIXMLEdgesHandler::addLane().

void NBEdge::setPermissions ( SVCPermissions  permissions,
int  lane = -1 
)

set allowed/disallowed classes for the given lane or for all lanes if -1 is given

Definition at line 1925 of file NBEdge.cpp.

References myLanes.

Referenced by NIImporter_SUMO::_loadNetwork(), NIXMLEdgesHandler::addEdge(), NIXMLEdgesHandler::addLane(), NINavTeqHelper::addVehicleClasses(), NIImporter_OpenStreetMap::insertEdge(), and NBEdge().

void NBEdge::setPreferredVehicleClass ( SVCPermissions  permissions,
int  lane = -1 
)

Definition at line 1939 of file NBEdge.cpp.

References myLanes.

Referenced by NIXMLEdgesHandler::addLane().

void NBEdge::setSpeed ( int  lane,
SUMOReal  offset 
)

set lane specific speed (negative lane implies set for all lanes)

Definition at line 1909 of file NBEdge.cpp.

References myLanes, and mySpeed.

Referenced by NIImporter_SUMO::_loadNetwork(), NIXMLEdgesHandler::addLane(), NIVissimEdge::buildNBEdge(), NBEdge(), and NBEdgeCont::splitAt().

void NBEdge::setStreetName ( const std::string &  name)
inline

sets the street name of this edge

Definition at line 421 of file NBEdge.h.

References myStreetName.

void NBEdge::setTurningDestination ( NBEdge e)

Definition at line 1034 of file NBEdge.cpp.

References myTurnDestination.

void NBEdge::setWidth ( int  lane,
SUMOReal  width 
)

set lane specific width (negative lane implies set for all lanes)

Definition at line 1877 of file NBEdge.cpp.

References myLanes, myWidth, and width().

Referenced by NIImporter_SUMO::_loadNetwork(), and NIXMLEdgesHandler::addLane().

void NBEdge::sortOutgoingConnectionsByAngle ( )

sorts the outgoing connections by their angle relative to their junction

Definition at line 700 of file NBEdge.cpp.

References myConnections, and myTo.

void NBEdge::sortOutgoingConnectionsByIndex ( )

sorts the outgoing connections by their from-lane-index and their to-lane-index

Definition at line 706 of file NBEdge.cpp.

References connections_sorter(), and myConnections.

Referenced by NWWriter_XML::writeEdgesAndConnections(), and NWWriter_SUMO::writeNetwork().

bool NBEdge::splitGeometry ( NBEdgeCont ec,
NBNodeCont nc 
)

Splits this edge at geometry points.

Parameters:
[in]ecThe edge cont to add new edges to
[in]ncThe node cont to add new nodes to
Returns:
Whether the geometry was changed

Definition at line 451 of file NBEdge.cpp.

References NBNode::addIncomingEdge(), PositionVector::clear(), NBNode::getPosition(), INIT, NBNodeCont::insert(), NBEdgeCont::insert(), myFrom, myGeom, Named::myID, myLanes, myLaneSpreadFunction, myPriority, mySpeed, myStep, myStreetName, myTo, myType, myWidth, NBEdge(), PositionVector::push_back(), NBNode::removeEdge(), NBNodeCont::retrieve(), PositionVector::size(), toString(), and UNSPECIFIED_OFFSET.

PositionVector NBEdge::startShapeAt ( const PositionVector laneShape,
const NBNode startNode,
unsigned int  laneIndex 
) const
private
NBNode * NBEdge::tryGetNodeAtPosition ( SUMOReal  pos,
SUMOReal  tolerance = 5.0 
) const

Returns the node at the given edges length (using an epsilon) When no node is existing at the given position, 0 is returned The epsilon is a static member of NBEdge, should be setable via program options.

Definition at line 1466 of file NBEdge.cpp.

References myFrom, myLength, and myTo.

SUMOReal NBEdge::width ( ) const

Friends And Related Function Documentation

friend class GNEEdge
friend

Definition at line 76 of file NBEdge.h.

friend class GNELane
friend

used for visualization (NETEDIT)

Definition at line 75 of file NBEdge.h.

friend class NBEdgeCont
friend

Definition at line 72 of file NBEdge.h.

friend class NBEdgeSuccessorBuilder
friend

used for the computation of connections to following edges

Definition at line 71 of file NBEdge.h.


Field Documentation

bool NBEdge::myAmInnerEdge
private

Information whether this is a junction-inner edge.

Definition at line 1162 of file NBEdge.h.

Referenced by isInnerEdge(), and setIsInnerEdge().

bool NBEdge::myAmLeftHand
private

Whether this edge is a left-hand edge.

Definition at line 1158 of file NBEdge.h.

Referenced by divideOnEdges(), getCCWBoundaryLine(), getCWBoundaryLine(), moveConnectionToLeft(), moveConnectionToRight(), and setLeftHanded().

bool NBEdge::myAmMacroscopicConnector
private

Information whether this edge is a (macroscopic) connector.

Definition at line 1165 of file NBEdge.h.

Referenced by isMacroscopicConnector(), and setAsMacroscopicConnector().

SUMOReal NBEdge::myAngle
private

The angle of the edge.

Definition at line 1115 of file NBEdge.h.

Referenced by getAngle(), and init().

int NBEdge::myFromJunctionPriority
private

The priority normalised for the node the edge is outgoing of.

Definition at line 1132 of file NBEdge.h.

Referenced by getJunctionPriority(), and setJunctionPriority().

LaneSpreadFunction NBEdge::myLaneSpreadFunction
private

The information about how to spread the lanes.

Definition at line 1141 of file NBEdge.h.

Referenced by getLaneSpreadFunction(), reinit(), setLaneSpreadFunction(), NBEdgeCont::splitAt(), and splitGeometry().

SUMOReal NBEdge::myLength
private

The length of the edge.

Definition at line 1112 of file NBEdge.h.

Referenced by append(), computeEdgeShape(), getLength(), getLoadedLength(), init(), and tryGetNodeAtPosition().

SUMOReal NBEdge::myLoadedLength
private

An optional length to use (-1 if not valid)

Definition at line 1155 of file NBEdge.h.

Referenced by getLoadedLength(), hasLoadedLength(), reinit(), and setLoadedLength().

SUMOReal NBEdge::myOffset
private

This edges's offset to the intersection begin (will be applied to all lanes)

Definition at line 1144 of file NBEdge.h.

Referenced by getOffset(), reinit(), setOffset(), and NBEdgeCont::splitAt().

int NBEdge::myPriority
private

The priority of the edge.

Definition at line 1118 of file NBEdge.h.

Referenced by getPriority(), reinit(), and splitGeometry().

SUMOReal NBEdge::mySpeed
private

The maximal speed.

Definition at line 1121 of file NBEdge.h.

Referenced by expandableBy(), getSpeed(), reinit(), setSpeed(), NBEdgeCont::splitAt(), and splitGeometry().

std::string NBEdge::myStreetName
private

The street name (or whatever arbitrary string you wish to attach)

Definition at line 1177 of file NBEdge.h.

Referenced by getStreetName(), reinit(), setStreetName(), and splitGeometry().

std::vector<TLSDisabledConnection> NBEdge::myTLSDisabledConnections
private
int NBEdge::myToJunctionPriority
private

The priority normalised for the node the edge is incoming in.

Definition at line 1135 of file NBEdge.h.

Referenced by getJunctionPriority(), and setJunctionPriority().

std::string NBEdge::myType
private

The type of the edge.

Definition at line 1106 of file NBEdge.h.

Referenced by getTypeID(), getTypeName(), reinit(), NBEdgeCont::splitAt(), and splitGeometry().

SUMOReal NBEdge::myWidth
private

This width of this edge's lanes.

Definition at line 1147 of file NBEdge.h.

Referenced by getWidth(), reinit(), setWidth(), NBEdgeCont::splitAt(), and splitGeometry().

const SUMOReal NBEdge::UNSPECIFIED_LOADED_LENGTH = -1
static

no length override given

Definition at line 194 of file NBEdge.h.

Referenced by NIImporter_SUMO::addEdge(), NIXMLEdgesHandler::addEdge(), and reinit().


The documentation for this class was generated from the following files: