SUMO - Simulation of Urban MObility

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 computeTurningDirections ()
 computes which edge shall be the turn-around one, if any
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
SUMOVehicleClasses getAllowedVehicleClasses () const
 get the union of allowed classes over all lanes
SUMOVehicleClasses getAllowedVehicleClasses (unsigned int lane) const
 get allowed classed for the given lane
SUMOReal getAngle (const NBNode &atNode) const
PositionVector getCCWBoundaryLine (const NBNode &n, SUMOReal offset) const
PositionVector getCWBoundaryLine (const NBNode &n, SUMOReal offset) const
SUMOVehicleClasses getDisallowedVehicleClasses (unsigned int lane) const
 get disallowed classed for the given lane
SUMOVehicleClasses getDisallowedVehicleClasses () const
 get the union of disallowed classes over all lanes
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
const Lane & getLaneStruct (unsigned int lane) const
Lane & getLaneStruct (unsigned int lane)
SUMOReal getMaxLaneOffset ()
Position getMaxLaneOffsetPositionAt (NBNode *node, SUMOReal width) const
Position getMinLaneOffsetPositionAt (NBNode *node, SUMOReal width) const
SUMOReal getNormedAngle () const
SUMOReal getNormedAngle (const NBNode &atNode) const
NBEdge * getTurnDestination () const
const std::string & getTypeID () const
bool hasLaneSpecificAllow () const
 whether lanes differ in allowed vehicle classes
bool hasLaneSpecificDisallow () const
 whether lanes differ in disallowed vehicle classes
bool hasLaneSpecificOffset () const
 whether lanes differ in offset
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, PositionVector geom, const std::string &streetName="", LaneSpreadFunction spread=LANESPREAD_RIGHT, bool tryIgnoreNodePositions=false)
 Constructor.
 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, 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 setSpeed (int lane, SUMOReal offset)
 set lane specific speed (negative lane implies set for all lanes)
void setTurningDestination (NBEdge *e)
void setVehicleClasses (const SUMOVehicleClasses &allowed, const SUMOVehicleClasses &disallowed, int lane=-1)
 set allowed/disallowed classes for the given lane or for all lanes if -1 is given
void setWidth (int lane, SUMOReal width)
 set lane specific width (negative lane implies set for all lanes)
NBNode * 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.
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.
NBNode * getFromNode () const
 Returns the origin node of the edge.
NBNode * getToNode () 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 PositionVector & getGeometry () 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 PositionVector & getLaneShape (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 Member Functions

bool acceptBeingTurning (NBEdge *e)

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, SUMOReal > laneOffset (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
NBEdge & operator= (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< Connection > myConnections
 List of connections to following edges.
NBNode * myFrom
 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< Lane > myLanes
 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
NBNode * myTo
int myToJunctionPriority
 The priority normalised for the node the edge is incoming in.
NBEdge * myTurnDestination
 The turn destination edge.
std::string myType
 The type of the edge.
SUMOReal myWidth
 This width of this edge's lanes.
Temporary variables for turning edge computation
SUMOReal myAmTurningWithAngle
 Was assigned as a turn with this angle.
NBEdge * myAmTurningOf
 Was assigned as a turning edge of this one.

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< Connection > getConnectionsFromLane (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 EdgeVector * getConnectedSorted ()
 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< int > getConnectionLanes (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 getAllowedVehicleClasses(), getDisallowedVehicleClasses(), getLaneSpeed(), getNumLanes(), init(), setSpeed(), and setVehicleClasses().

NBEdge::~NBEdge ( )

Destructor.

Definition at line 310 of file NBEdge.cpp.

NBEdge::NBEdge ( const NBEdge &  s) [private]

invalidated copy constructor


Member Function Documentation

bool NBEdge::acceptBeingTurning ( NBEdge *  e) [protected]
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 501 of file NBEdge.cpp.

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

Referenced by addLane2LaneConnection(), NBEdgeCont::joinSameNodeConnectingEdges(), NIXMLConnectionsHandler::myStartElement(), 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 449 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 525 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 547 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 1941 of file NBEdge.cpp.

References getLaneID(), myLanes, SUMO_ATTR_DISALLOW, toString(), and WRITE_WARNING.

Referenced by NIXMLEdgesHandler::addLane(), NINavTeqHelper::addVehicleClasses(), and setVehicleClasses().

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 1500 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 1698 of file NBEdge.cpp.

References myConnections.

bool NBEdge::computeEdge2Edges ( bool  noLeftMovers)

computes the edge (step1: computation of approached edges)

Definition at line 1292 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 360 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 1313 of file NBEdge.cpp.

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

PositionVector NBEdge::computeLaneShape ( unsigned int  lane) throw (InvalidArgument) [private]
void NBEdge::computeLaneShapes ( ) [private]

Definition at line 1109 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 1490 of file NBEdge.cpp.

Referenced by divideOnEdges().

void NBEdge::computeTurningDirections ( )

computes which edge shall be the turn-around one, if any

Definition at line 1035 of file NBEdge.cpp.

References getAngle(), NBNode::getOutgoingEdges(), isConnectedTo(), myConnections, myTo, myTurnDestination, NBHelpers::relAngle(), setTurningDestination(), and SUMOReal.

Referenced by acceptBeingTurning().

static bool NBEdge::connections_sorter ( const Connection &  c1,
const Connection &  c2 
) [inline, static]
void NBEdge::copyConnectionsFrom ( NBEdge *  src)

Definition at line 833 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 957 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 1962 of file NBEdge.cpp.

References getLaneID(), myLanes, SUMO_ATTR_ALLOW, toString(), and WRITE_WARNING.

Referenced by NIXMLEdgesHandler::addLane(), and setVehicleClasses().

void NBEdge::dismissVehicleClassInformation ( )

Definition at line 2099 of file NBEdge.cpp.

References myLanes.

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 1752 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.

SUMOVehicleClasses NBEdge::getAllowedVehicleClasses ( ) const

get the union of allowed classes over all lanes

Definition at line 2057 of file NBEdge.cpp.

References myLanes.

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

SUMOVehicleClasses NBEdge::getAllowedVehicleClasses ( unsigned int  lane) const

get allowed classed for the given lane

Definition at line 2079 of file NBEdge.cpp.

References myLanes.

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

Definition at line 1731 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 678 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 650 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 690 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 675 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 619 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 1716 of file NBEdge.cpp.

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

SUMOVehicleClasses NBEdge::getDisallowedVehicleClasses ( ) const

get the union of disallowed classes over all lanes

Definition at line 2068 of file NBEdge.cpp.

References myLanes.

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

SUMOVehicleClasses NBEdge::getDisallowedVehicleClasses ( unsigned int  lane) const

get disallowed classed for the given lane

Definition at line 2086 of file NBEdge.cpp.

References myLanes.

const std::string& Named::getID ( ) const [inline, inherited]

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 ShapeContainer::add(), MSDetectorControl::add(), RORouteDef_Alternatives::addAlternative(), MSNet::addBusStop(), NLHandler::addConnection(), NBLoadedSUMOTLDef::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(), RORouteDef_Complete::buildCurrentRoute(), 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(), connections_sorter(), MSLane::detectCollisions(), NIVissimDistrictConnection::dict_BuildDistricts(), MSE3Collector::enter(), MSVTypeProbe::execute(), Command_SaveTLSSwitches::execute(), NBTrafficLightLogicCont::extract(), NBNodeCont::extract(), NBEdgeCont::extract(), MSNet::getBusStopID(), NIImporter_VISUM::getNamedEdgeContinuating(), NLTriggerBuilder::getPosition(), NBNode::getPossiblySplittedIncoming(), NBNode::getPossiblySplittedOutgoing(), NIImporter_VISUM::getReversedContinuating(), NBEdgeCont::ignoreFilterMatch(), MSUnboundActuatedTrafficLightLogic::init(), MSAgentbasedTrafficLightLogic::init(), MSActuatedTrafficLightLogic::init(), NIXMLTrafficLightsHandler::initTrafficLightLogic(), NIImporter_SUMO::initTrafficLightLogic(), NBTrafficLightLogicCont::insert(), NBNodeCont::insert(), NBEdgeCont::insert(), NBDistrictCont::insert(), NBNodeCont::joinJunctions(), 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(), MSTriggeredRerouter::myStartElement(), MSLaneSpeedTrigger::myStartElement(), NBConnection::NBConnection(), NBRequest::NBRequest(), MSDevice_Tripinfo::notifyEnter(), MSDevice_Tripinfo::notifyLeave(), NBOwnTLDef::edge_by_incoming_priority_sorter::operator()(), NBNode::nodes_by_id_sorter::operator()(), NBNetBuilder::by_id_sorter::operator()(), NBContHelper::same_connection_edge_sorter::operator()(), Named::ComparatorIdLess::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(), TraCIServerAPI_Vehicle::processGet(), TraCIServerAPI_TLS::processGet(), TraCIServerAPI_Lane::processGet(), TraCIServerAPI_InductionLoop::processGet(), NWWriter_SUMO::prohibitionConnection(), NBLoadedTLDef::SignalGroup::remapIncoming(), NBLoadedTLDef::SignalGroup::remapOutgoing(), NBLoadedSUMOTLDef::removeConnection(), NBNode::removeSelfLoops(), NBEdgeCont::removeUnwishedEdges(), NBNodeCont::removeUnwishedNodes(), NBConnection::replaceFrom(), MSBaseVehicle::replaceRouteEdges(), NBConnection::replaceTo(), NIXMLTrafficLightsHandler::retrieveLaneIndex(), NBNodeCont::setAsTLControlled(), setControllingTLInformation(), MSLane::setCritical(), NIXMLEdgesHandler::setNodes(), NBOwnTLDef::setTLControllingInformation(), NBLoadedTLDef::setTLControllingInformation(), NBLoadedSUMOTLDef::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 325 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 1015 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 443 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 437 of file NBEdge.cpp.

References myLanes.

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

SUMOReal NBEdge::getLaneSpeed ( unsigned int  lane) const

Definition at line 1103 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 532 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 946 of file NBEdge.h.

References myLanes.

Referenced by NBNode::computeInternalLaneShape().

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

Definition at line 951 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 364 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 373 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 1578 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::getNormedAngle ( ) const

Definition at line 1878 of file NBEdge.cpp.

References myAngle, and SUMOReal.

Referenced by NBContHelper::edge_by_junction_angle_sorter::getConvAngle().

SUMOReal NBEdge::getNormedAngle ( const NBNode &  atNode) const

Definition at line 1867 of file NBEdge.cpp.

References getAngle(), and SUMOReal.

SUMOReal NBEdge::getOffset ( ) const [inline]

Returns the offset to the destination node.

Returns:
The offset to the destination node

Definition at line 427 of file NBEdge.h.

References myOffset.

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

int NBEdge::getPriority ( ) const [inline]
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 399 of file NBEdge.h.

References myStep.

const std::string& NBEdge::getStreetName ( ) 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 435 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 407 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 631 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 334 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 340 of file NBEdge.cpp.

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

Referenced by hasDefaultGeometry().

bool NBEdge::hasLaneSpecificAllow ( ) const

whether lanes differ in allowed vehicle classes

Definition at line 1224 of file NBEdge.cpp.

References myLanes.

bool NBEdge::hasLaneSpecificDisallow ( ) const

whether lanes differ in disallowed vehicle classes

Definition at line 1238 of file NBEdge.cpp.

References myLanes.

bool NBEdge::hasLaneSpecificOffset ( ) const

whether lanes differ in offset

Definition at line 1274 of file NBEdge.cpp.

References getOffset(), and myLanes.

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

bool NBEdge::hasLaneSpecificSpeed ( ) const

whether lanes differ in speed

Definition at line 1263 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 1252 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 381 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 1213 of file NBEdge.cpp.

References myLanes.

Referenced by needsLaneSpecificOutput().

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

Definition at line 1835 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 NBNode::addIncomingEdge(), NBNode::addOutgoingEdge(), NBHelpers::angle(), PositionVector::clear(), computeLaneShapes(), Position::distanceTo(), NBNode::getPosition(), myAngle, myFrom, myGeom, Named::myID, myLanes, myLength, myOffset, mySpeed, myTo, myWidth, NBEdge::Lane::offset, POSITION_EPS, PositionVector::push_back(), PositionVector::push_back_noDoublePos(), PositionVector::push_front(), PositionVector::push_front_noDoublePos(), PositionVector::removeDoublePoints(), PositionVector::size(), NBEdge::Lane::speed, NBEdge::Lane::width, 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 637 of file NBEdge.cpp.

References myConnections, and myTurnDestination.

Referenced by computeTurningDirections(), 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 770 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 755 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 1859 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 1515 of file NBEdge.cpp.

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

Referenced by NBNode::getDirection(), NBOwnTLDef::myCompute(), NBContHelper::opposite_finder::operator()(), NBRequest::setBlocking(), and NBNode::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 1190 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 1182 of file NBEdge.cpp.

bool NBEdge::lanesWereAssigned ( ) const

Definition at line 1572 of file NBEdge.cpp.

References LANES2LANES_DONE, LANES2LANES_USER, and myStep.

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

void NBEdge::markAsInLane2LaneState ( )

Definition at line 1934 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 840 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 863 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 1285 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 1983 of file NBEdge.cpp.

References myLanes.

Referenced by NIXMLEdgesHandler::addLane().

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 1448 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 1337 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 716 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 732 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 764 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 779 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 315 of file NBEdge.cpp.

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

void NBEdge::setAsMacroscopicConnector ( ) [inline]

Marks this edge as a macroscopic connector.

Definition at line 747 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 564 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 347 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) [inline, inherited]

resets the id

Definition at line 67 of file Named.h.

References Named::myID.

void NBEdge::setIsInnerEdge ( ) [inline]

Marks this edge being within an intersection.

Definition at line 762 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 1025 of file NBEdge.cpp.

References myFrom, myFromJunctionPriority, and myToJunctionPriority.

Referenced by NBNode::extractAndMarkFirst(), and NBNode::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 443 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 309 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 2014 of file NBEdge.cpp.

References myLanes, and myOffset.

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

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

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

Definition at line 2030 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 420 of file NBEdge.h.

References myStreetName.

void NBEdge::setTurningDestination ( NBEdge *  e)
void NBEdge::setVehicleClasses ( const SUMOVehicleClasses &  allowed,
const SUMOVehicleClasses &  disallowed,
int  lane = -1 
)

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

Definition at line 2046 of file NBEdge.cpp.

References allowVehicleClass(), and disallowVehicleClass().

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

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

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

Definition at line 1998 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 704 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 710 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 455 of file NBEdge.cpp.

References NBNode::addIncomingEdge(), PositionVector::clear(), NBNode::getPosition(), INIT, NBEdgeCont::insert(), NBNodeCont::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]

returns a modified version of laneShape which starts at the outside of startNode. laneShape may be shorted or extended

Note:
see [wiki:Developer/Network_Building_Process]

Definition at line 393 of file NBEdge.cpp.

References PositionVector::eraseAt(), Line::extrapolateBy(), PositionVector::getBegLine(), Named::getID(), getLaneID(), Line::getPositionAtDistance(), NBNode::getShape(), PositionVector::getSubpart(), PositionVector::intersects(), Line::intersectsAtLengths2D(), PositionVector::intersectsAtLengths2D(), PositionVector::length(), Line::p1(), Line::p2(), PositionVector::push_front_noDoublePos(), and SUMOReal.

Referenced by computeEdgeShape().

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 1543 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

Information whether this is a junction-inner edge.

Definition at line 1180 of file NBEdge.h.

Referenced by isInnerEdge(), and setIsInnerEdge().

Whether this edge is a left-hand edge.

Definition at line 1167 of file NBEdge.h.

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

Information whether this edge is a (macroscopic) connector.

Definition at line 1183 of file NBEdge.h.

Referenced by isMacroscopicConnector(), and setAsMacroscopicConnector().

Was assigned as a turning edge of this one.

Definition at line 1176 of file NBEdge.h.

Referenced by acceptBeingTurning().

SUMOReal NBEdge::myAmTurningWithAngle [private]

Was assigned as a turn with this angle.

Definition at line 1174 of file NBEdge.h.

Referenced by acceptBeingTurning().

SUMOReal NBEdge::myAngle [private]

The angle of the edge.

Definition at line 1124 of file NBEdge.h.

Referenced by getAngle(), getNormedAngle(), and init().

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

Definition at line 1141 of file NBEdge.h.

Referenced by getJunctionPriority(), and setJunctionPriority().

The information about how to spread the lanes.

Definition at line 1150 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 1121 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 1164 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 1153 of file NBEdge.h.

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

int NBEdge::myPriority [private]

The priority of the edge.

Definition at line 1127 of file NBEdge.h.

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

SUMOReal NBEdge::mySpeed [private]

The maximal speed.

Definition at line 1130 of file NBEdge.h.

Referenced by expandableBy(), getSpeed(), incLaneNo(), init(), 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 1195 of file NBEdge.h.

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

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

Definition at line 1144 of file NBEdge.h.

Referenced by getJunctionPriority(), and setJunctionPriority().

std::string NBEdge::myType [private]

The type of the edge.

Definition at line 1115 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 1156 of file NBEdge.h.

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

const SUMOReal NBEdge::UNSPECIFIED_LOADED_LENGTH = -1 [static]

no length override given

Definition at line 193 of file NBEdge.h.

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


The documentation for this class was generated from the following files:
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Friends Defines