SUMO - Simulation of Urban MObility
NBEdgeCont Class Reference

Storage for edges, including some functionality operating on multiple edges. More...

#include <NBEdgeCont.h>

Collaboration diagram for NBEdgeCont:
Collaboration graph

Data Structures

struct  PostProcessConnection
 A structure representing a connection between two lanes. More...
 

Public Member Functions

void addRoundabout (const EdgeSet &roundabout)
 add user specified roundabout More...
 
void applyOptions (OptionsCont &oc)
 Initialises the storage by applying given options. More...
 
void clear ()
 Deletes all edges. More...
 
void generateStreetSigns ()
 assigns street signs to edges based on toNode types More...
 
const std::set< EdgeSetgetRoundabouts () const
 Returns the determined roundabouts. More...
 
int guessRoundabouts ()
 Determines which edges belong to roundabouts and increases their priority. More...
 
int guessSidewalks (SUMOReal width, SUMOReal minSpeed, SUMOReal maxSpeed, bool fromPermissions)
 add sidwalks to edges within the given limits or permissions and return the number of edges affected More...
 
void markRoundabouts ()
 mark edge priorities and prohibit turn-arounds for all roundabout edges More...
 
 NBEdgeCont (NBTypeCont &tc)
 Constructor. More...
 
void rename (NBEdge *edge, const std::string &newID)
 Renames the edge. Throws exception if newID already exists. More...
 
bool wasIgnored (std::string id) const
 Returns whether the edge with the id was ignored during parsing. More...
 
bool wasRemoved (std::string id) const
 Returns whether the edge with the id was deleted explicitly. More...
 
 ~NBEdgeCont ()
 Destructor. More...
 
edge access methods
bool insert (NBEdge *edge, bool ignorePrunning=false)
 Adds an edge to the dictionary. More...
 
NBEdgeretrieve (const std::string &id, bool retrieveExtracted=false) const
 Returns the edge that has the given id. More...
 
NBEdgeretrievePossiblySplit (const std::string &id, bool downstream) const
 Tries to retrieve an edge, even if it is splitted. More...
 
NBEdgeretrievePossiblySplit (const std::string &id, const std::string &hint, bool incoming) const
 Tries to retrieve an edge, even if it is splitted. More...
 
NBEdgeretrievePossiblySplit (const std::string &id, SUMOReal pos) const
 Tries to retrieve an edge, even if it is splitted. More...
 
void erase (NBDistrictCont &dc, NBEdge *edge)
 Removes the given edge from the container (deleting it) More...
 
void extract (NBDistrictCont &dc, NBEdge *edge, bool remember=false)
 Removes the given edge from the container like erase but does not delete it. More...
 
std::map< std::string, NBEdge * >::const_iterator begin () const
 Returns the pointer to the begin of the stored edges. More...
 
std::map< std::string, NBEdge * >::const_iterator end () const
 Returns the pointer to the end of the stored edges. More...
 
explicit edge manipulation methods
bool splitAt (NBDistrictCont &dc, NBEdge *edge, NBNode *node)
 Splits the edge at the position nearest to the given node. More...
 
bool splitAt (NBDistrictCont &dc, NBEdge *edge, NBNode *node, const std::string &firstEdgeName, const std::string &secondEdgeName, unsigned int noLanesFirstEdge, unsigned int noLanesSecondEdge, const SUMOReal speed=-1., const int changedLeft=0)
 Splits the edge at the position nearest to the given node using the given modifications. More...
 
bool splitAt (NBDistrictCont &dc, NBEdge *edge, SUMOReal edgepos, NBNode *node, const std::string &firstEdgeName, const std::string &secondEdgeName, unsigned int noLanesFirstEdge, unsigned int noLanesSecondEdge, const SUMOReal speed=-1., const int changedLeft=0)
 Splits the edge at the position nearest to the given node using the given modifications. More...
 
container access methods
unsigned int size () const
 Returns the number of edges. More...
 
std::vector< std::string > getAllNames () const
 Returns all ids of known edges. More...
 
unsigned int getNoEdgeSplits () const
 Returns the number of edge splits. More...
 
Adapting the input
void removeUnwishedEdges (NBDistrictCont &dc)
 Removes unwished edges (not in keep-edges) More...
 
void splitGeometry (NBNodeCont &nc)
 Splits edges into multiple if they have a complex geometry. More...
 
void reduceGeometries (const SUMOReal minDist)
 
void checkGeometries (const SUMOReal maxAngle, const SUMOReal minRadius, bool fix)
 
processing methods
void sortOutgoingLanesConnections ()
 Sorts all lanes of all edges within the container by their direction. More...
 
void computeEdge2Edges (bool noLeftMovers)
 Computes for each edge the approached edges. More...
 
void computeLanes2Edges ()
 Computes for each edge which lanes approach the next edges. More...
 
void recheckLanes ()
 Rechecks whether all lanes have a successor for each of the stored edges. More...
 
void appendTurnarounds (bool noTLSControlled)
 Appends turnarounds to all edges stored in the container. More...
 
void appendTurnarounds (const std::set< std::string > &ids, bool noTLSControlled)
 Appends turnarounds to all edges stored in the container Calls "NBEdge::appendTurnaround" for edges with the given ids. More...
 
void computeEdgeShapes ()
 Computes the shapes of all edges stored in the container. More...
 
void computeLaneShapes ()
 Computes the shapes of all lanes of all edges stored in the container. More...
 
void clearControllingTLInformation () const
 Clears information about controlling traffic lights for all connenections of all edges. More...
 
void joinSameNodeConnectingEdges (NBDistrictCont &dc, NBTrafficLightLogicCont &tlc, EdgeVector edges)
 Joins the given edges because they connect the same nodes. More...
 
void recheckLaneSpread ()
 Rechecks whether the lane spread is proper. More...
 
Connections handling
void addPostProcessConnection (const std::string &from, int fromLane, const std::string &to, int toLane, bool mayDefinitelyPass, bool keepClear, SUMOReal contPos)
 Adds a connection which could not be set during loading. More...
 
void recheckPostProcessConnections ()
 Try to set any stored connections. More...
 

Private Types

typedef std::map< std::string, NBEdge * > EdgeCont
 The type of the dictionary where an edge may be found by its id. More...
 

Private Member Functions

EdgeVector getGeneratedFrom (const std::string &id) const
 Returns the edges which have been built by splitting the edge of the given id. More...
 
bool ignoreFilterMatch (NBEdge *edge)
 Returns true if this edge matches one of the removal criteria. More...
 
 NBEdgeCont (const NBEdgeCont &s)
 invalidated copy constructor More...
 
NBEdgeContoperator= (const NBEdgeCont &s)
 invalidated assignment operator More...
 

Static Private Member Functions

static SUMOReal formFactor (const EdgeVector &loopEdges)
 compute the form factor for a loop of edges More...
 

Private Attributes

std::vector< PostProcessConnectionmyConnections
 The list of connections to recheck. More...
 
EdgeCont myEdges
 The instance of the dictionary (id->edge) More...
 
unsigned int myEdgesSplit
 the number of splits of edges during the building More...
 
EdgeCont myExtractedEdges
 The extracted nodes which are kept for reference. More...
 
std::set< EdgeSetmyGuessedRoundabouts
 Edges marked as belonging to a roundabout after guessing. More...
 
std::set< std::string > myIgnoredEdges
 The ids of ignored edges. More...
 
std::set< EdgeSetmyRoundabouts
 Edges marked as belonging to a roundabout by the user (each EdgeVector is a roundabout) More...
 
NBTypeContmyTypeCont
 The network builder; used to obtain type information. More...
 
Settings for accepting/dismissing edges
SUMOReal myEdgesMinSpeed
 The minimum speed an edge may have in order to be kept (default: -1) More...
 
bool myRemoveEdgesAfterJoining
 Whether edges shall be joined first, then removed. More...
 
std::set< std::string > myEdges2Keep
 Set of ids of edges which shall explicitly be kept. More...
 
std::set< std::string > myEdges2Remove
 Set of ids of edges which shall explicitly be removed. More...
 
SVCPermissions myVehicleClasses2Keep
 Set of vehicle types which must be allowed on edges in order to keep them. More...
 
SVCPermissions myVehicleClasses2Remove
 Set of vehicle types which need not be supported (edges which allow ONLY these are removed) More...
 
std::set< std::string > myTypes2Keep
 Set of edges types which shall be kept. More...
 
std::set< std::string > myTypes2Remove
 Set of edges types which shall be removed. More...
 
PositionVector myPrunningBoundary
 Boundary within which an edge must be located in order to be kept. More...
 
bool myNeedGeoTransformedPrunningBoundary
 whether a geo transform has been applied to the pruning boundary More...
 

Detailed Description

Storage for edges, including some functionality operating on multiple edges.

Definition at line 66 of file NBEdgeCont.h.

Member Typedef Documentation

typedef std::map<std::string, NBEdge*> NBEdgeCont::EdgeCont
private

The type of the dictionary where an edge may be found by its id.

Definition at line 575 of file NBEdgeCont.h.

Constructor & Destructor Documentation

NBEdgeCont::NBEdgeCont ( NBTypeCont tc)

Constructor.

Parameters
[in]tcThe net builded; used to obtain types

Definition at line 66 of file NBEdgeCont.cpp.

NBEdgeCont::~NBEdgeCont ( )

Destructor.

Definition at line 75 of file NBEdgeCont.cpp.

References clear().

NBEdgeCont::NBEdgeCont ( const NBEdgeCont s)
private

invalidated copy constructor

Member Function Documentation

void NBEdgeCont::addPostProcessConnection ( const std::string &  from,
int  fromLane,
const std::string &  to,
int  toLane,
bool  mayDefinitelyPass,
bool  keepClear,
SUMOReal  contPos 
)

Adds a connection which could not be set during loading.

Parameters
[in]fromThe id of the edge the connection starts at
[in]fromLaneThe number of the lane the connection starts at
[in]toThe id of the edge the connection ends at
[in]toLaneThe number of the lane the connection ends at
[in]mayDefinitelyPassWhether the connection may be passed without braking
[in]keepClearWhether the connection must check to keep the junction clear
[in]contPosCustom position for internal junction

Definition at line 757 of file NBEdgeCont.cpp.

References myConnections.

Referenced by NIXMLConnectionsHandler::parseLaneBound(), and wasRemoved().

void NBEdgeCont::addRoundabout ( const EdgeSet roundabout)

add user specified roundabout

Definition at line 949 of file NBEdgeCont.cpp.

References myRoundabouts, toString(), and WRITE_WARNING.

Referenced by NIImporter_SUMO::_loadNetwork(), NIXMLEdgesHandler::addRoundabout(), and wasRemoved().

void NBEdgeCont::appendTurnarounds ( bool  noTLSControlled)

Appends turnarounds to all edges stored in the container.

Calls "NBEdge::appendTurnaround" for all edges within the container.

Parameters
[in]noTLSControlledWhether the turnaround shall not be connected if the edge is controlled by a tls
Todo:
Recheck whether a visitor-pattern should be used herefor
See also
NBEdge::appendTurnaround

Definition at line 617 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::appendTurnarounds ( const std::set< std::string > &  ids,
bool  noTLSControlled 
)

Appends turnarounds to all edges stored in the container Calls "NBEdge::appendTurnaround" for edges with the given ids.

Parameters
[in]idsThe list of ids for which to append a turnaround
[in]noTLSControlledWhether the turnaround shall not be connected if the edge is controlled by a tls
See also
NBEdge::appendTurnaround

Definition at line 625 of file NBEdgeCont.cpp.

References myEdges.

void NBEdgeCont::applyOptions ( OptionsCont oc)

Initialises the storage by applying given options.

Options, mainly steering the acceptance of edges, are parsed and the according internal variables are set.

Parameters
[in]ocThe options container to read options from
Todo:
Recheck exceptions

Definition at line 81 of file NBEdgeCont.cpp.

References TplConvert::_2SUMOReal(), OptionsCont::exists(), OptionsCont::getBool(), OptionsCont::getFloat(), OptionsCont::getString(), OptionsCont::getStringVector(), OptionsCont::isSet(), NBHelpers::loadEdgesFromFile(), myEdges2Keep, myEdges2Remove, myEdgesMinSpeed, myNeedGeoTransformedPrunningBoundary, myPrunningBoundary, myRemoveEdgesAfterJoining, myTypes2Keep, myTypes2Remove, myVehicleClasses2Keep, myVehicleClasses2Remove, parseVehicleClasses(), and SUMOReal.

Referenced by NBNetBuilder::applyOptions().

void NBEdgeCont::checkGeometries ( const SUMOReal  maxAngle,
const SUMOReal  minRadius,
bool  fix 
)
Parameters
[in]maxAngleThe maximum geometry angle allowed
[in]minRadiusThe minimum turning radius allowed at the start and end
[in]fixWhether to prune geometry points to avoid sharp turns at start and end
See also
NBEdge::checkGeometry

Definition at line 566 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::clear ( )

Deletes all edges.

Definition at line 146 of file NBEdgeCont.cpp.

References myEdges, and myExtractedEdges.

Referenced by ~NBEdgeCont().

void NBEdgeCont::clearControllingTLInformation ( ) const

Clears information about controlling traffic lights for all connenections of all edges.

Definition at line 577 of file NBEdgeCont.cpp.

References myEdges.

Referenced by getNoEdgeSplits(), and NBTrafficLightLogicCont::setTLControllingInformation().

void NBEdgeCont::computeEdge2Edges ( bool  noLeftMovers)

Computes for each edge the approached edges.

Calls "NBEdge::computeEdge2Edges" for all edges within the container.

Parameters
[in]noLeftMoversWhether left-moving connections shall be omitted
Todo:
Recheck whether a visitor-pattern should be used herefor
See also
NBEdge::computeEdge2Edges

Definition at line 593 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::computeEdgeShapes ( )

Computes the shapes of all edges stored in the container.

Calls "NBEdge::computeEdgeShape" for all edges within the container.

Todo:

Recheck whether a visitor-pattern should be used herefor

Recheck usage

See also
NBEdge::computeEdgeShape

Definition at line 633 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::computeLanes2Edges ( )

Computes for each edge which lanes approach the next edges.

Calls "NBEdge::computeLanes2Edges" for all edges within the container.

Todo:
Recheck whether a visitor-pattern should be used herefor
See also
NBEdge::computeLanes2Edges

Definition at line 601 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::computeLaneShapes ( )

Computes the shapes of all lanes of all edges stored in the container.

Calls "NBEdge::computeLaneShapes" for all edges within the container.

Todo:

Recheck whether a visitor-pattern should be used herefor

Recheck usage

See also
NBEdge::computeLaneShapes

Definition at line 641 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::erase ( NBDistrictCont dc,
NBEdge edge 
)

Removes the given edge from the container (deleting it)

Parameters
[in]dcThe district container, in order to remove the edge from sources/sinks
[in]edgeThe edge to remove
Todo:
Recheck whether the district cont is needed - if districts are processed using an external tool

Definition at line 380 of file NBEdgeCont.cpp.

References extract().

Referenced by NIXMLEdgesHandler::addEdge(), NBNodeCont::removeIsolatedRoads(), NBNode::removeSelfLoops(), removeUnwishedEdges(), and splitAt().

void NBEdgeCont::extract ( NBDistrictCont dc,
NBEdge edge,
bool  remember = false 
)

Removes the given edge from the container like erase but does not delete it.

Parameters
[in]dcThe district container, in order to remove the edge from sources/sinks
[in]edgeThe edge to remove
[in]rememberWhether to keep this edge for future reference
Todo:

Recheck whether the district cont is needed - if districts are processed using an external tool

Recheck whether this is used at all and why

Definition at line 387 of file NBEdgeCont.cpp.

References Named::getID(), myEdges, myExtractedEdges, NBEdge::myFrom, NBEdge::myTo, NBNode::removeEdge(), and NBDistrictCont::removeFromSinksAndSources().

Referenced by NIXMLEdgesHandler::deleteEdge(), GNENet::deleteSingleEdge(), erase(), NBNodeCont::joinNodeClusters(), joinSameNodeConnectingEdges(), and NBNodeCont::removeUnwishedNodes().

SUMOReal NBEdgeCont::formFactor ( const EdgeVector loopEdges)
staticprivate

compute the form factor for a loop of edges

Definition at line 930 of file NBEdgeCont.cpp.

References PositionVector::append(), PositionVector::area(), PositionVector::length2D(), M_PI, and SUMOReal.

Referenced by guessRoundabouts(), and wasRemoved().

std::vector< std::string > NBEdgeCont::getAllNames ( ) const

Returns all ids of known edges.

Returns
All ids of known edges
Todo:
Recheck usage, probably, filling a given vector would be better...

Definition at line 519 of file NBEdgeCont.cpp.

References myEdges.

Referenced by GNENet::GNENet(), NBJoinedEdgesMap::init(), NBNodeCont::removeIsolatedRoads(), and size().

EdgeVector NBEdgeCont::getGeneratedFrom ( const std::string &  id) const
private

Returns the edges which have been built by splitting the edge of the given id.

Parameters
[in]idThe id of the original edge
Returns
List of all edges which have been built by splitting the original edge
Todo:
Recheck usage

Definition at line 792 of file NBEdgeCont.cpp.

References myEdges.

Referenced by retrievePossiblySplit(), and wasRemoved().

const std::set< EdgeSet > NBEdgeCont::getRoundabouts ( ) const
int NBEdgeCont::guessRoundabouts ( )

Determines which edges belong to roundabouts and increases their priority.

Parameters
[out]markedEdges which belong to a roundabout are stored here
Returns
The number of guessed roundabouts

Definition at line 834 of file NBEdgeCont.cpp.

References formFactor(), NBEdge::getAngleAtNode(), NBNode::getConnectionTo(), NBNode::getEdges(), NBEdge::getFromNode(), NBEdge::getToNode(), NBEdge::getTurnDestination(), myEdges, myGuessedRoundabouts, myRoundabouts, NBContHelper::nextCW(), NBHelpers::relAngle(), and SUMOReal.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

int NBEdgeCont::guessSidewalks ( SUMOReal  width,
SUMOReal  minSpeed,
SUMOReal  maxSpeed,
bool  fromPermissions 
)

add sidwalks to edges within the given limits or permissions and return the number of edges affected

Definition at line 1023 of file NBEdgeCont.cpp.

References NBEdge::addSidewalk(), Named::getID(), OptionsCont::getOptions(), NBEdge::getPermissions(), NBEdge::getSpeed(), OptionsCont::getStringVector(), myEdges, and SVC_PEDESTRIAN.

Referenced by NBNetBuilder::compute(), and wasRemoved().

bool NBEdgeCont::insert ( NBEdge edge,
bool  ignorePrunning = false 
)

Adds an edge to the dictionary.

First, it is determined whether the edge shall not be discarded due to any reasons (being outside a boundary, or not in the optional list of edges to import, etc.). If so, the edge is deleted and "true" is returned. "true" is also returned if the edge is accepted - no edge with the same name exists within this container. If another edge with the same name exists, false is returned.

Parameters
[in]edgeThe edge to add
[in]ignorePrunningWhether this edge must not be prunned
Returns
Whether the edge was valid (no edge with the same id is already known)

Definition at line 161 of file NBEdgeCont.cpp.

References NBEdge::dismissVehicleClassInformation(), OptionsCont::exists(), OptionsCont::getBool(), NBEdge::getFromNode(), Named::getID(), OptionsCont::getOptions(), NBEdge::getToNode(), ignoreFilterMatch(), myEdges, myIgnoredEdges, and NBNode::removeEdge().

Referenced by NIImporter_SUMO::_loadNetwork(), NIVissimEdge::buildNBEdge(), NIVissimDistrictConnection::dict_BuildDistricts(), NIImporter_OpenStreetMap::insertEdge(), GNENet::insertEdge(), joinSameNodeConnectingEdges(), NIImporter_ArcView::load(), NIImporter_RobocupRescue::loadEdges(), NIImporter_OpenDrive::loadNetwork(), NIXMLEdgesHandler::myEndElement(), NIImporter_ITSUMO::Handler::myEndElement(), NIImporter_MATSim::EdgesHandler::myStartElement(), NIImporter_VISUM::parse_Connectors(), NIImporter_VISUM::parse_Edges(), NIImporter_DlrNavteq::EdgesHandler::report(), splitAt(), NBEdge::splitGeometry(), and NGNet::toNB().

void NBEdgeCont::joinSameNodeConnectingEdges ( NBDistrictCont dc,
NBTrafficLightLogicCont tlc,
EdgeVector  edges 
)

Joins the given edges because they connect the same nodes.

Parameters
[in]dcThe district container needed to remove edges
[in]tlcThe tls container needed to remove edges
[in]edgesThe edges to join
Todo:
Recheck and describe usage

Definition at line 649 of file NBEdgeCont.cpp.

References NBEdge::addEdge2EdgeConnection(), extract(), Named::getID(), NBEdge::getLanes(), insert(), MAX2(), NBEdge::moveOutgoingConnectionsFrom(), NBNode::replaceIncoming(), NBNode::replaceOutgoing(), NBTrafficLightLogicCont::replaceRemoved(), NBEdge::setEndOffset(), NBEdge::setLaneWidth(), NBEdge::setPermissions(), SUMOReal, NBEdge::UNSPECIFIED_OFFSET, and NBEdge::UNSPECIFIED_WIDTH.

Referenced by getNoEdgeSplits(), and NBNodeCont::joinSimilarEdges().

void NBEdgeCont::markRoundabouts ( )

mark edge priorities and prohibit turn-arounds for all roundabout edges

Definition at line 959 of file NBEdgeCont.cpp.

References NBNode::getIncomingEdges(), getRoundabouts(), NBEdge::getTurnDestination(), NBEdge::LANES2LANES_USER, NBEdge::removeFromConnections(), and NBNode::setRoundabout().

Referenced by NBNetBuilder::compute(), and wasRemoved().

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

invalidated assignment operator

void NBEdgeCont::recheckLanes ( )

Rechecks whether all lanes have a successor for each of the stored edges.

Calls "NBEdge::recheckLanes" for all edges within the container.

Todo:
Recheck whether a visitor-pattern should be used herefor
See also
NBEdge::recheckLanes

Definition at line 609 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::recheckLaneSpread ( )

Rechecks whether the lane spread is proper.

Todo:
Recheck usage; check whether this is really needed and whether it works at all

Definition at line 736 of file NBEdgeCont.cpp.

References LANESPREAD_CENTER, LANESPREAD_RIGHT, and myEdges.

Referenced by getNoEdgeSplits(), and NIImporter_DlrNavteq::loadNetwork().

void NBEdgeCont::reduceGeometries ( const SUMOReal  minDist)
Parameters
[in]ncThe node container needed to build (geometry) nodes
See also
NBEdge::reduceGeometry

Definition at line 558 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::removeUnwishedEdges ( NBDistrictCont dc)

Removes unwished edges (not in keep-edges)

Parameters

Definition at line 530 of file NBEdgeCont.cpp.

References erase(), NBEdge::getFromNode(), Named::getID(), NBEdge::getToNode(), myEdges, myEdges2Keep, and NBNode::removeEdge().

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

void NBEdgeCont::rename ( NBEdge edge,
const std::string &  newID 
)

Renames the edge. Throws exception if newID already exists.

Definition at line 399 of file NBEdgeCont.cpp.

References Named::getID(), myEdges, and Named::setID().

Referenced by GNENet::renameEdge(), and wasRemoved().

NBEdge * NBEdgeCont::retrieve ( const std::string &  id,
bool  retrieveExtracted = false 
) const

Returns the edge that has the given id.

If no edge that has the given id is known, 0 is returned.

Parameters
[in]idThe id of the edge to retrieve
[in]boolWhether extracted edges shall be retrieved as well
Returns
The edge with the given id, 0 if no such edge exists

Definition at line 246 of file NBEdgeCont.cpp.

References myEdges, and myExtractedEdges.

Referenced by NIImporter_SUMO::_loadNetwork(), NIXMLConnectionsHandler::addCrossing(), NIXMLEdgesHandler::addEdge(), NIXMLEdgesHandler::addRoundabout(), NIVissimDisturbance::addToNode(), NIVissimEdge::buildNBEdge(), NBRampsComputer::buildOffRamp(), NBRampsComputer::buildOnRamp(), NBConnection::checkFrom(), NBConnection::checkTo(), NBRampsComputer::computeRamps(), NIXMLEdgesHandler::deleteEdge(), NIVissimDistrictConnection::dict_BuildDistricts(), NIImporter_VISUM::getNamedEdge(), NIImporter_VISUM::getNamedEdgeContinuating(), NIImporter_VISUM::getReversedContinuating(), GNENet::GNENet(), NBJoinedEdgesMap::init(), NIImporter_ArcView::load(), NIImporter_OpenDrive::loadNetwork(), NIXMLEdgesHandler::myEndElement(), NIXMLConnectionsHandler::myStartElement(), NIImporter_VISUM::parse_Connectors(), NIImporter_VISUM::parse_Edges(), NIImporter_VISUM::parse_Lanes(), NIImporter_VISUM::parse_LanesConnections(), NIImporter_VISUM::parse_TurnsToSignalGroups(), NIXMLConnectionsHandler::parseConnection(), NBNodeCont::removeIsolatedRoads(), NIImporter_DlrNavteq::TrafficlightsHandler::report(), NIXMLTrafficLightsHandler::retrieveEdge(), retrievePossiblySplit(), and NWWriter_SUMO::writeRoundabout().

NBEdge * NBEdgeCont::retrievePossiblySplit ( const std::string &  id,
bool  downstream 
) const

Tries to retrieve an edge, even if it is splitted.

The edge given with the id should exist and is followed downstream or upstream, depending on the parameter to the last edge still starting with the id.

Parameters
[in]idThe id of the edge to retrieve
[in]downstreamsearch direction
Returns
The searched edge
Todo:
Recheck usage

Definition at line 282 of file NBEdgeCont.cpp.

References retrieve().

Referenced by NIVissimTL::NIVissimTLSignal::addTo(), NIVissimDisturbance::addToNode(), NIVissimConnection::buildEdgeConnections(), NBConnection::checkFrom(), NBConnection::checkTo(), NIVissimDistrictConnection::dict_BuildDistricts(), recheckPostProcessConnections(), and NIVissimConflictArea::setPriorityRegulation().

NBEdge * NBEdgeCont::retrievePossiblySplit ( const std::string &  id,
const std::string &  hint,
bool  incoming 
) const

Tries to retrieve an edge, even if it is splitted.

To describe which part of the edge shall be returned, the id of a second edge, participating at the node and the information whether to return the outgoing or the incoming is needed.

Parameters
[in]idThe id of the edge to retrieve
[in]hintAn additional information which helps to retrieve the correct edge
[in]incomingWhether the edge to find is an incoming edge at the node "hint" participates
Returns
The searched edge
Todo:
Recheck usage

Definition at line 301 of file NBEdgeCont.cpp.

References getGeneratedFrom(), NBNode::getIncomingEdges(), NBNode::getOutgoingEdges(), NBEdge::myFrom, NBEdge::myTo, and retrieve().

NBEdge * NBEdgeCont::retrievePossiblySplit ( const std::string &  id,
SUMOReal  pos 
) const

Tries to retrieve an edge, even if it is splitted.

To describe which part of the edge shall be returned, a position hint is supplied.

Parameters
[in]idThe id of the edge to retrieve
[in]posAn additional about the position of the basic edge's subpart
Returns
The searched edge
Todo:
Recheck usage

Definition at line 335 of file NBEdgeCont.cpp.

References NBEdge::getLength(), MAX2(), myEdges, retrieve(), and SUMOReal.

unsigned int NBEdgeCont::size ( ) const
inline

Returns the number of edges.

Returns
The number of edges stored in this container

Definition at line 282 of file NBEdgeCont.h.

References getAllNames(), and myEdges.

Referenced by NILoader::load(), main(), and NWWriter_OpenDrive::writeNetwork().

void NBEdgeCont::sortOutgoingLanesConnections ( )

Sorts all lanes of all edges within the container by their direction.

Calls "NBEdge::sortOutgoingLanesConnections" for all edges within the container.

Todo:
Recheck whether a visitor-pattern should be used herefor
See also
NBEdge::sortOutgoingLanesConnections

Definition at line 585 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

bool NBEdgeCont::splitAt ( NBDistrictCont dc,
NBEdge edge,
NBNode node 
)

Splits the edge at the position nearest to the given node.

Uses "splitAt(NBDistrictCont &, NBEdge *, NBNode *, const std::string &, const std::string &, unsigned int , unsigned int)" to perform the split; the edge names are built by appending "[0]" and "[1]", respectively. Both edges will have the same number of lanes.

Parameters
[in]dcThe district container, in order to remove/add the edge from/to sources/sinks
[in]edgeThe edge to split
[in]nodeThe node to split the edge at
Returns
Whether the edge could be split
Exceptions
ProcessErrorIf connections between the edges can not be built
See also
NBEdge::splitAt(NBDistrictCont &, NBEdge *, NBNode *, const std::string &, const std::string &, unsigned int , unsigned int)

Definition at line 411 of file NBEdgeCont.cpp.

References Named::getID(), and NBEdge::myLanes.

Referenced by NIVissimDisturbance::addToNode(), NIVissimEdge::buildNBEdge(), NBRampsComputer::buildOffRamp(), NBRampsComputer::buildOnRamp(), end(), NIXMLEdgesHandler::myEndElement(), NIImporter_VISUM::parse_Lanes(), and splitAt().

bool NBEdgeCont::splitAt ( NBDistrictCont dc,
NBEdge edge,
NBNode node,
const std::string &  firstEdgeName,
const std::string &  secondEdgeName,
unsigned int  noLanesFirstEdge,
unsigned int  noLanesSecondEdge,
const SUMOReal  speed = -1.,
const int  changedLeft = 0 
)

Splits the edge at the position nearest to the given node using the given modifications.

Determines the position of the split by finding the nearest position on the edge to the given node. If this position is too near to the edges begin/end, false is returned.

Otherwise, "splitAt(NBDistrictCont &, NBEdge *, SUMOReal, NBNode *, const std::string &, const std::string &, unsigned int , unsigned int)" is used to perform the split.

Parameters
[in]dcThe district container, in order to remove/add the edge from/to sources/sinks
[in]edgeThe edge to split
[in]nodeThe node to split the edge at
[in]firstEdgeNameThe id the first part of the split edge shall have
[in]secondEdgeNameThe id the second part of the split edge shall have
[in]noLanesFirstEdgeThe number of lanes the second part of the split edge shall have
[in]noLanesSecondEdgeThe number of lanes the second part of the split edge shall have
[in]speedThe speed for the edge after the split
[in]changedLeftThe number of lanes that is added or removed on the left side of the edge (By default all added/removed lanes are assumed to be on the right when computing connections)
Returns
Whether the edge could be split
Exceptions
ProcessErrorIf connections between the edges can not be built
See also
NBEdge::splitAt(NBDistrictCont &, NBEdge *, SUMOReal, NBNode *, const std::string &, const std::string &, unsigned int , unsigned int)

Definition at line 418 of file NBEdgeCont.cpp.

References NBEdge::getGeometry(), NBNode::getPosition(), PositionVector::length(), NBEdge::myFrom, NBEdge::myTo, GeomHelper::nearest_offset_on_line_to_point2D(), PositionVector::nearest_offset_to_point2D(), splitAt(), and SUMOReal.

bool NBEdgeCont::splitAt ( NBDistrictCont dc,
NBEdge edge,
SUMOReal  edgepos,
NBNode node,
const std::string &  firstEdgeName,
const std::string &  secondEdgeName,
unsigned int  noLanesFirstEdge,
unsigned int  noLanesSecondEdge,
const SUMOReal  speed = -1.,
const int  changedLeft = 0 
)

Splits the edge at the position nearest to the given node using the given modifications.

Parameters
[in]dcThe district container, in order to remove/add the edge from/to sources/sinks
[in]edgeThe edge to split
[in]nodeThe node to split the edge at
[in]firstEdgeNameThe id the first part of the split edge shall have
[in]secondEdgeNameThe id the second part of the split edge shall have
[in]noLanesFirstEdgeThe number of lanes the second part of the split edge shall have
[in]noLanesSecondEdgeThe number of lanes the second part of the split edge shall have
[in]speedThe speed for the edge after the split
[in]changedLeftThe number of lanes that is added or removed on the left side of the edge (By default all added/removed lanes are assumed to be on the right when computing connections)
Returns
Whether the edge could be split
Exceptions
ProcessErrorIf connections between the edges can not be built

Definition at line 440 of file NBEdgeCont.cpp.

References NBEdge::addLane2LaneConnection(), NBEdge::copyConnectionsFrom(), erase(), NBNode::getControllingTLS(), NBEdge::getGeometry(), Named::getID(), NBEdge::getNumLanes(), NBNode::getPosition(), insert(), NBEdge::L2L_COMPUTED, MAX2(), MIN2(), myEdges2Keep, myEdges2Remove, myEdgesSplit, NBEdge::myFrom, myRemoveEdgesAfterJoining, NBEdge::myTo, NBNode::removeDoubleEdges(), NBNode::replaceIncoming(), NBNode::replaceOutgoing(), NBEdge::setSpeed(), and PositionVector::splitAt().

void NBEdgeCont::splitGeometry ( NBNodeCont nc)

Splits edges into multiple if they have a complex geometry.

Calls "NBEdge::splitGeometry" for all edges within the container which have more than three positions in their geometry.

Parameters
[in]ncThe node container needed to build (geometry) nodes
See also
NBEdge::splitGeometry

Definition at line 547 of file NBEdgeCont.cpp.

References myEdges.

Referenced by NBNetBuilder::compute(), and getNoEdgeSplits().

bool NBEdgeCont::wasIgnored ( std::string  id) const
inline

Returns whether the edge with the id was ignored during parsing.

Returns
Whether the edge with the id was ignored during parsing

Definition at line 464 of file NBEdgeCont.h.

References myIgnoredEdges.

Referenced by NIImporter_SUMO::_loadNetwork(), NIXMLEdgesHandler::addRoundabout(), and NIXMLConnectionsHandler::myStartElement().

bool NBEdgeCont::wasRemoved ( std::string  id) const
inline

Field Documentation

std::vector<PostProcessConnection> NBEdgeCont::myConnections
private

The list of connections to recheck.

Definition at line 571 of file NBEdgeCont.h.

Referenced by addPostProcessConnection(), and recheckPostProcessConnections().

std::set<std::string> NBEdgeCont::myEdges2Keep
private

Set of ids of edges which shall explicitly be kept.

Definition at line 599 of file NBEdgeCont.h.

Referenced by applyOptions(), ignoreFilterMatch(), removeUnwishedEdges(), and splitAt().

std::set<std::string> NBEdgeCont::myEdges2Remove
private

Set of ids of edges which shall explicitly be removed.

Definition at line 602 of file NBEdgeCont.h.

Referenced by applyOptions(), ignoreFilterMatch(), and splitAt().

SUMOReal NBEdgeCont::myEdgesMinSpeed
private

The minimum speed an edge may have in order to be kept (default: -1)

Definition at line 593 of file NBEdgeCont.h.

Referenced by applyOptions(), and ignoreFilterMatch().

unsigned int NBEdgeCont::myEdgesSplit
private

the number of splits of edges during the building

Definition at line 587 of file NBEdgeCont.h.

Referenced by getNoEdgeSplits(), and splitAt().

EdgeCont NBEdgeCont::myExtractedEdges
private

The extracted nodes which are kept for reference.

Definition at line 581 of file NBEdgeCont.h.

Referenced by clear(), extract(), retrieve(), and wasRemoved().

std::set<EdgeSet> NBEdgeCont::myGuessedRoundabouts
private

Edges marked as belonging to a roundabout after guessing.

Definition at line 626 of file NBEdgeCont.h.

Referenced by getRoundabouts(), and guessRoundabouts().

std::set<std::string> NBEdgeCont::myIgnoredEdges
private

The ids of ignored edges.

Definition at line 584 of file NBEdgeCont.h.

Referenced by insert(), and wasIgnored().

bool NBEdgeCont::myNeedGeoTransformedPrunningBoundary
private

whether a geo transform has been applied to the pruning boundary

Definition at line 620 of file NBEdgeCont.h.

Referenced by applyOptions(), and ignoreFilterMatch().

PositionVector NBEdgeCont::myPrunningBoundary
private

Boundary within which an edge must be located in order to be kept.

Definition at line 617 of file NBEdgeCont.h.

Referenced by applyOptions(), and ignoreFilterMatch().

bool NBEdgeCont::myRemoveEdgesAfterJoining
private

Whether edges shall be joined first, then removed.

Definition at line 596 of file NBEdgeCont.h.

Referenced by applyOptions(), ignoreFilterMatch(), and splitAt().

std::set<EdgeSet> NBEdgeCont::myRoundabouts
private

Edges marked as belonging to a roundabout by the user (each EdgeVector is a roundabout)

Definition at line 624 of file NBEdgeCont.h.

Referenced by addRoundabout(), getRoundabouts(), and guessRoundabouts().

NBTypeCont& NBEdgeCont::myTypeCont
private

The network builder; used to obtain type information.

Definition at line 537 of file NBEdgeCont.h.

Referenced by ignoreFilterMatch().

std::set<std::string> NBEdgeCont::myTypes2Keep
private

Set of edges types which shall be kept.

Definition at line 611 of file NBEdgeCont.h.

Referenced by applyOptions(), and ignoreFilterMatch().

std::set<std::string> NBEdgeCont::myTypes2Remove
private

Set of edges types which shall be removed.

Definition at line 614 of file NBEdgeCont.h.

Referenced by applyOptions(), and ignoreFilterMatch().

SVCPermissions NBEdgeCont::myVehicleClasses2Keep
private

Set of vehicle types which must be allowed on edges in order to keep them.

Definition at line 605 of file NBEdgeCont.h.

Referenced by applyOptions(), and ignoreFilterMatch().

SVCPermissions NBEdgeCont::myVehicleClasses2Remove
private

Set of vehicle types which need not be supported (edges which allow ONLY these are removed)

Definition at line 608 of file NBEdgeCont.h.

Referenced by applyOptions(), and ignoreFilterMatch().


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