Eclipse SUMO - Simulation of Urban MObility
Loading...
Searching...
No Matches
NIXMLEdgesHandler Class Reference

Importer for network edges stored in XML. More...

#include <NIXMLEdgesHandler.h>

Inheritance diagram for NIXMLEdgesHandler:
[legend]
Collaboration diagram for NIXMLEdgesHandler:
[legend]

Data Structures

class  split_by_pos_finder
 Finds a split at the given position. More...
 

Public Member Functions

void characters (const XMLCh *const chars, const XERCES3_SIZE_t length)
 The inherited method called when characters occurred.
 
void endElement (const XMLCh *const uri, const XMLCh *const localname, const XMLCh *const qname)
 The inherited method called when a tag is being closed.
 
const std::string & getFileName () const
 returns the current file name
 
 NIXMLEdgesHandler (NBNodeCont &nc, NBEdgeCont &ec, NBTypeCont &tc, NBDistrictCont &dc, NBTrafficLightLogicCont &tlc, OptionsCont &options)
 Constructor.
 
void registerParent (const int tag, GenericSAXHandler *handler)
 Assigning a parent handler which is enabled when the specified tag is closed.
 
void setFileName (const std::string &name)
 Sets the current file name.
 
void startElement (const XMLCh *const uri, const XMLCh *const localname, const XMLCh *const qname, const XERCES_CPP_NAMESPACE::Attributes &attrs)
 The inherited method called when a new tag opens.
 
 ~NIXMLEdgesHandler ()
 Destructor.
 

Private Member Functions

void addEdge (const SUMOSAXAttributes &attrs)
 Parses an edge and stores the values in "myCurrentEdge".
 
void addLane (const SUMOSAXAttributes &attrs)
 Parses a lane and modifies myCurrentEdge according to the given attribures.
 
void addRoundabout (const SUMOSAXAttributes &attrs)
 Parses a roundabout and stores it in myEdgeCont.
 
void addSplit (const SUMOSAXAttributes &attrs)
 Parses a split and stores it in mySplits. Splits are executed Upon reading the end tag of an edge.
 
void deleteEdge (const SUMOSAXAttributes &attrs)
 parses delete tag and deletes the specified edge or lane
 
 NIXMLEdgesHandler (const NIXMLEdgesHandler &s)
 invalid copy constructor
 
NIXMLEdgesHandleroperator= (const NIXMLEdgesHandler &s)
 invalid assignment operator
 

Private Attributes

NBEdgemyCurrentEdge
 The currently processed edge.
 
int myCurrentLaneIndex
 The currently processed lane index.
 
bool myHaveReportedAboutOverwriting
 Information whether at least one edge's attributes were overwritten.
 
bool myHaveReportedAboutTypeOverride
 Information whether at least one edge's type was changed.
 
bool myHaveWarnedAboutDeprecatedLaneId
 
bool myIsUpdate
 Whether this edge definition is an update of a previously inserted edge.
 
const bool myKeepEdgeShape
 Whether the edge shape shall be kept generally.
 
std::vector< Parameterised * > myLastParameterised
 element to receive parameters
 
GeoConvHelpermyLocation = nullptr
 The coordinate transformation which was used compute the node coordinates.
 
std::vector< NBEdgeCont::SplitmySplits
 The list of this edge's splits.
 
Currently parsed edge's values
std::string myCurrentID
 The current edge's id.
 
double myCurrentSpeed
 The current edge's maximum speed.
 
double myCurrentFriction
 The current edge's friction.
 
int myCurrentPriority
 The current edge's priority.
 
int myCurrentLaneNo
 The current edge's number of lanes.
 
double myCurrentWidth
 The current edge's lane width.
 
double myCurrentEndOffset
 The current edge's offset till the destination node.
 
std::string myCurrentStreetName
 The current edge's street name.
 
std::string myCurrentType
 The current edge's type.
 
NBNodemyFromNode
 The nodes the edge starts and ends at.
 
NBNodemyToNode
 
double myLength
 The current edge's length.
 
PositionVector myShape
 The shape of the edge.
 
LaneSpreadFunction myLanesSpread
 Information about how to spread the lanes.
 
SVCPermissions myPermissions
 Information about lane permissions.
 
bool myReinitKeepEdgeShape
 Whether the edge shape shall be kept at reinitilization.
 
double mySidewalkWidth
 The width of the sidewalk that shall be added to the current edge.
 
double myBikeLaneWidth
 The width of the bike lane that shall be added to the current edge.
 
Used instance containers (access to nodes, edges, types, etc.)
NBNodeContmyNodeCont
 The nodes container (for retrieval of referenced nodes)
 
NBEdgeContmyEdgeCont
 The edges container (for insertion of build edges)
 
NBTypeContmyTypeCont
 The types container (for retrieval of type defaults)
 
NBDistrictContmyDistrictCont
 The districts container (needed if an edge must be split)
 
NBTrafficLightLogicContmyTLLogicCont
 The traffic lights container to add built tls to (when invalidating tls because of splits)
 

inherited from GenericSAXHandler

OptionsContmyOptions
 A reference to the program's options.
 
void myStartElement (int element, const SUMOSAXAttributes &attrs)
 Called on the opening of a tag;.
 
void myEndElement (int element)
 Called when a closing tag occurs.
 
PositionVector tryGetShape (const SUMOSAXAttributes &attrs)
 Tries to parse the shape definition.
 
LaneSpreadFunction tryGetLaneSpread (const SUMOSAXAttributes &attrs)
 Tries to parse the spread type.
 
bool setNodes (const SUMOSAXAttributes &attrs)
 Sets from/to node information of the currently parsed edge.
 

attributes parsing

AttrMap myPredefinedTags
 
std::vector< std::string > myPredefinedTagsMML
 the map from ids to their string representation
 
typedef std::vector< XMLCh * > AttrMap
 

elements parsing

TagMap myTagMap
 
std::vector< std::string > myCharactersVector
 A list of character strings obtained so far to build the complete characters string at the end.
 
GenericSAXHandlermyParentHandler
 The handler to give control back to.
 
int myParentIndicator
 The tag indicating that control should be given back.
 
std::string myFileName
 The name of the currently parsed file.
 
std::string myExpectedRoot
 The root element to expect, empty string disables the check.
 
bool myCollectCharacterData = false
 whether the reader should collect character data
 
bool myRootSeen = false
 whether the reader has already seen the root element
 
int mySection = -1
 The tag indicating the current section to parse.
 
bool mySectionSeen = false
 whether the reader has already seen the begin of the section
 
bool mySectionEnded = false
 whether the reader has already seen the end of the section
 
bool mySectionOpen = false
 whether an element of the current section is open
 
std::pair< int, SUMOSAXAttributes * > myNextSectionStart
 
typedef std::map< std::string, int > TagMap
 

SAX ErrorHandler callbacks

void warning (const XERCES_CPP_NAMESPACE::SAXParseException &exception)
 Handler for XML-warnings.
 
void error (const XERCES_CPP_NAMESPACE::SAXParseException &exception)
 Handler for XML-errors.
 
void fatalError (const XERCES_CPP_NAMESPACE::SAXParseException &exception)
 Handler for XML-errors.
 
void setSection (const int element, const bool seen)
 
bool sectionFinished () const
 
std::pair< int, SUMOSAXAttributes * > retrieveNextSectionStart ()
 
void needsCharacterData (const bool value=true)
 
std::string buildErrorMessage (const XERCES_CPP_NAMESPACE::SAXParseException &exception)
 Builds an error message.
 
virtual void myCharacters (int element, const std::string &chars)
 Callback method for characters to implement by derived classes.
 
void callParentEnd (int element)
 signal endElement to the parent handler (special case for MSCalibrator)
 
XMLCh * convert (const std::string &name) const
 converts from c++-string into unicode
 
int convertTag (const std::string &tag) const
 Converts a tag from its string into its numerical representation.
 

Detailed Description

Importer for network edges stored in XML.

This SAX-handler parses edge information and stores it in the given container.

Todo:

revalidate node retrieval

One day, one should rethink the order of parsing. Now, the handler is able to load edges, using information from the types, first, and extending them by given information. In addition, if the read edge is already known, its values are also used. Then, defining vehicles allowed per lane, and additional edge split definitions add some further complexity. This all works somehow for most of our use cases, but it's definitely not as consistent that everything what seems to be possible would also work appropriately.

Definition at line 62 of file NIXMLEdgesHandler.h.

Member Typedef Documentation

◆ AttrMap

typedef std::vector<XMLCh*> GenericSAXHandler::AttrMap
privateinherited

Definition at line 303 of file GenericSAXHandler.h.

◆ TagMap

typedef std::map<std::string, int> GenericSAXHandler::TagMap
privateinherited

Definition at line 317 of file GenericSAXHandler.h.

Constructor & Destructor Documentation

◆ NIXMLEdgesHandler() [1/2]

NIXMLEdgesHandler::NIXMLEdgesHandler ( NBNodeCont nc,
NBEdgeCont ec,
NBTypeCont tc,
NBDistrictCont dc,
NBTrafficLightLogicCont tlc,
OptionsCont options 
)

Constructor.

Parameters
[in]ncThe nodes container (for retrieval of referenced nodes)
[in]ecThe edges container (for insertion of build edges)
[in]tcThe types container (for retrieval of type defaults)
[in]dcThe districts container (needed if an edge must be split)
[in]optionsThe options to use while building edges

Definition at line 51 of file NIXMLEdgesHandler.cpp.

◆ ~NIXMLEdgesHandler()

NIXMLEdgesHandler::~NIXMLEdgesHandler ( )

Destructor.

Definition at line 73 of file NIXMLEdgesHandler.cpp.

References myLocation.

◆ NIXMLEdgesHandler() [2/2]

NIXMLEdgesHandler::NIXMLEdgesHandler ( const NIXMLEdgesHandler s)
private

invalid copy constructor

Member Function Documentation

◆ addEdge()

void NIXMLEdgesHandler::addEdge ( const SUMOSAXAttributes attrs)
private

Parses an edge and stores the values in "myCurrentEdge".

Parameters
[in]attrsThe attributes to get the edge's values from

Definition at line 159 of file NIXMLEdgesHandler.cpp.

References NBEdgeCont::erase(), StringBijection< T >::get(), SUMOSAXAttributes::get(), NBEdge::getBidiEdge(), OptionsCont::getBool(), NBEdge::getDistance(), NBTypeCont::getEdgeType(), NBTypeCont::getEdgeTypeBikeLaneWidth(), NBTypeCont::getEdgeTypeFriction(), NBTypeCont::getEdgeTypeNumLanes(), NBTypeCont::getEdgeTypePermissions(), NBTypeCont::getEdgeTypePriority(), NBTypeCont::getEdgeTypeSidewalkWidth(), NBTypeCont::getEdgeTypeSpeed(), NBTypeCont::getEdgeTypeSpreadType(), NBTypeCont::getEdgeTypeWidth(), NBEdge::getGeometry(), Named::getID(), NBEdge::getLaneSpreadFunction(), NBEdge::getLoadedLength(), NBEdge::getNumLanes(), SUMOSAXAttributes::getOpt(), NBEdge::getPriority(), NBEdge::getStreetName(), OptionsCont::getString(), SUMOSAXAttributes::getStringSecure(), NBEdge::getTypeID(), SUMOSAXAttributes::hasAttribute(), NBEdge::hasDefaultGeometry(), NBEdge::hasLoadedLength(), OptionsCont::isDefault(), NBTypeCont::knows(), SUMOXMLDefinitions::LaneSpreadFunctions, NBTypeCont::EdgeTypeDefinition::laneTypeDefinitions, myBikeLaneWidth, myCurrentEdge, myCurrentEndOffset, myCurrentFriction, myCurrentID, myCurrentLaneNo, myCurrentPriority, myCurrentSpeed, myCurrentStreetName, myCurrentType, myCurrentWidth, myDistrictCont, myEdgeCont, myFromNode, myHaveReportedAboutOverwriting, myHaveReportedAboutTypeOverride, myIsUpdate, myKeepEdgeShape, myLanesSpread, myLastParameterised, myLength, myOptions, myPermissions, myReinitKeepEdgeShape, myShape, mySidewalkWidth, mySplits, myToNode, myTypeCont, NBTypeCont::EdgeTypeDefinition::needsLaneType(), parseVehicleClasses(), NBEdge::reinit(), NBEdgeCont::retrieve(), OptionsCont::set(), NBEdge::setBidi(), NBEdge::setDistance(), NBEdge::setFriction(), NBEdge::setLaneWidth(), NBEdge::setLoadedLength(), setNodes(), NBEdge::setPermissions(), NBEdge::setSpeed(), SUMO_ATTR_ALLOW, SUMO_ATTR_BIDI, SUMO_ATTR_BIKELANEWIDTH, SUMO_ATTR_DISALLOW, SUMO_ATTR_DISTANCE, SUMO_ATTR_ENDOFFSET, SUMO_ATTR_FRICTION, SUMO_ATTR_ID, SUMO_ATTR_LENGTH, SUMO_ATTR_NAME, SUMO_ATTR_NUMLANES, SUMO_ATTR_PRIORITY, SUMO_ATTR_REMOVE, SUMO_ATTR_SIDEWALKWIDTH, SUMO_ATTR_SPEED, SUMO_ATTR_TYPE, SUMO_ATTR_WIDTH, SVC_UNSPECIFIED, TL, tryGetLaneSpread(), tryGetShape(), NBEdge::UNSPECIFIED_FRICTION, NBEdge::UNSPECIFIED_LOADED_LENGTH, NBEdge::UNSPECIFIED_OFFSET, NBEdge::UNSPECIFIED_SPEED, NBEdge::UNSPECIFIED_WIDTH, WRITE_ERRORF, WRITE_MESSAGEF, and WRITE_WARNINGF.

Referenced by myStartElement().

Here is the caller graph for this function:

◆ addLane()

void NIXMLEdgesHandler::addLane ( const SUMOSAXAttributes attrs)
private

◆ addRoundabout()

void NIXMLEdgesHandler::addRoundabout ( const SUMOSAXAttributes attrs)
private

Parses a roundabout and stores it in myEdgeCont.

Parameters
[in]attrsThe attributes to get the roundabouts values from

Definition at line 696 of file NIXMLEdgesHandler.cpp.

References NBEdgeCont::addRoundabout(), SUMOSAXAttributes::get(), myEdgeCont, NBEdgeCont::retrieve(), SUMO_ATTR_EDGES, TL, NBEdgeCont::wasIgnored(), and WRITE_ERRORF.

Referenced by myStartElement().

Here is the caller graph for this function:

◆ addSplit()

◆ buildErrorMessage()

std::string GenericSAXHandler::buildErrorMessage ( const XERCES_CPP_NAMESPACE::SAXParseException &  exception)
protectedinherited

Builds an error message.

The error message includes the file name and the line/column information as supported by the given SAXParseException

Parameters
[in]exceptionThe name of the currently processed file
Returns
A string describing the given exception

Definition at line 205 of file GenericSAXHandler.cpp.

References GenericSAXHandler::getFileName(), and TL.

Referenced by GenericSAXHandler::error(), GenericSAXHandler::fatalError(), and GenericSAXHandler::warning().

Here is the caller graph for this function:

◆ callParentEnd()

void GenericSAXHandler::callParentEnd ( int  element)
protectedinherited

signal endElement to the parent handler (special case for MSCalibrator)

Definition at line 247 of file GenericSAXHandler.cpp.

References GenericSAXHandler::myEndElement(), and GenericSAXHandler::myParentHandler.

Referenced by MSCalibrator::myEndElement().

Here is the caller graph for this function:

◆ characters()

void GenericSAXHandler::characters ( const XMLCh *const  chars,
const XERCES3_SIZE_t  length 
)
inherited

The inherited method called when characters occurred.

The retrieved characters are converted into a string and appended into a private buffer. They are reported as soon as the element ends.

Todo:

recheck/describe what happens with characters when a new element is opened

describe characters processing in the class' head

Definition at line 186 of file GenericSAXHandler.cpp.

References GenericSAXHandler::myCharactersVector, GenericSAXHandler::myCollectCharacterData, and StringUtils::transcode().

◆ convert()

XMLCh * GenericSAXHandler::convert ( const std::string &  name) const
privateinherited

converts from c++-string into unicode

Todo:
recheck encoding
Parameters
[in]nameThe string to convert
Returns
The string converted into a XMLCh-string

Definition at line 86 of file GenericSAXHandler.cpp.

Referenced by GenericSAXHandler::GenericSAXHandler().

Here is the caller graph for this function:

◆ convertTag()

int GenericSAXHandler::convertTag ( const std::string &  tag) const
privateinherited

Converts a tag from its string into its numerical representation.

Returns the enum-representation stored for the given tag. If the tag is not known, SUMO_TAG_NOTHING is returned.

Parameters
[in]tagThe string to convert
Returns
The int-value that represents the string, SUMO_TAG_NOTHING if the named attribute is not known

Definition at line 195 of file GenericSAXHandler.cpp.

References GenericSAXHandler::myTagMap, and SUMO_TAG_NOTHING.

Referenced by GenericSAXHandler::endElement(), and GenericSAXHandler::startElement().

Here is the caller graph for this function:

◆ deleteEdge()

void NIXMLEdgesHandler::deleteEdge ( const SUMOSAXAttributes attrs)
private

parses delete tag and deletes the specified edge or lane

Parameters
[in]attrsThe attributes to get the edge id and the optional lane index from

Definition at line 623 of file NIXMLEdgesHandler.cpp.

References NBEdge::deleteLane(), NBEdgeCont::extract(), SUMOSAXAttributes::get(), SUMOSAXAttributes::getOpt(), myCurrentID, myDistrictCont, myEdgeCont, NBEdgeCont::retrieve(), SUMO_ATTR_ID, SUMO_ATTR_INDEX, SUMO_TAG_DEL, toString(), and WRITE_WARNING.

Referenced by myStartElement().

Here is the caller graph for this function:

◆ endElement()

void GenericSAXHandler::endElement ( const XMLCh *const  uri,
const XMLCh *const  localname,
const XMLCh *const  qname 
)
inherited

The inherited method called when a tag is being closed.

This method calls the user-implemented methods myCharacters with the previously collected and converted characters.

Then, myEndElement is called, supplying it the qname converted to its enum- and string-representations.

Todo:

recheck/describe encoding of the string-representation

do not generate and report the string-representation

Definition at line 134 of file GenericSAXHandler.cpp.

References GenericSAXHandler::convertTag(), GenericSAXHandler::myCharacters(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myEndElement(), GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, GenericSAXHandler::mySection, GenericSAXHandler::mySectionOpen, XMLSubSys::setHandler(), SUMO_TAG_INCLUDE, SUMO_TAG_NOTHING, and StringUtils::transcode().

◆ error()

void GenericSAXHandler::error ( const XERCES_CPP_NAMESPACE::SAXParseException &  exception)
inherited

Handler for XML-errors.

The message is built using buildErrorMessage and thrown within a ProcessError.

Parameters
[in]exceptionThe occurred exception to process
Exceptions
ProcessErrorOn any call

Definition at line 224 of file GenericSAXHandler.cpp.

References GenericSAXHandler::buildErrorMessage().

Referenced by MSRouteHandler::addFlowTransportable(), MSRouteHandler::addTransportable(), MSRouteHandler::closeTransportable(), NIImporter_OpenDrive::geomFromSpiral(), and MSRouteHandler::interpretDepartPosLat().

Here is the caller graph for this function:

◆ fatalError()

void GenericSAXHandler::fatalError ( const XERCES_CPP_NAMESPACE::SAXParseException &  exception)
inherited

Handler for XML-errors.

The message is built using buildErrorMessage and thrown within a ProcessError.

Exceptions
ProcessErrorOn any call
Parameters
[in]exceptionThe occurred exception to process

Definition at line 230 of file GenericSAXHandler.cpp.

References GenericSAXHandler::buildErrorMessage().

◆ getFileName()

◆ myCharacters()

void GenericSAXHandler::myCharacters ( int  element,
const std::string &  chars 
)
protectedvirtualinherited

Callback method for characters to implement by derived classes.

Called by "endElement" (see there).

Parameters
[in]elementThe opened element, given as a int
[in]charsThe complete embedded character string @exceptions ProcessError These method may throw a ProcessError if something fails

Reimplemented in NIImporter_ITSUMO::Handler, and NIImporter_OpenDrive.

Definition at line 240 of file GenericSAXHandler.cpp.

Referenced by GenericSAXHandler::endElement().

Here is the caller graph for this function:

◆ myEndElement()

◆ myStartElement()

◆ needsCharacterData()

void GenericSAXHandler::needsCharacterData ( const bool  value = true)
inlineinherited

Definition at line 220 of file GenericSAXHandler.h.

References GenericSAXHandler::myCollectCharacterData.

Referenced by NIImporter_ITSUMO::loadNetwork(), NIImporter_OpenDrive::loadNetwork(), and NIImporter_OpenDrive::myCharacters().

Here is the caller graph for this function:

◆ operator=()

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

invalid assignment operator

◆ registerParent()

void GenericSAXHandler::registerParent ( const int  tag,
GenericSAXHandler handler 
)
inherited

Assigning a parent handler which is enabled when the specified tag is closed.

Definition at line 178 of file GenericSAXHandler.cpp.

References GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, and XMLSubSys::setHandler().

Referenced by NLTriggerBuilder::parseAndBuildCalibrator(), NLTriggerBuilder::parseAndBuildLaneSpeedTrigger(), and NLTriggerBuilder::parseAndBuildRerouter().

Here is the caller graph for this function:

◆ retrieveNextSectionStart()

std::pair< int, SUMOSAXAttributes * > GenericSAXHandler::retrieveNextSectionStart ( )
inlineinherited

Definition at line 213 of file GenericSAXHandler.h.

References GenericSAXHandler::myNextSectionStart.

Referenced by SUMOSAXReader::parseSection().

Here is the caller graph for this function:

◆ sectionFinished()

bool GenericSAXHandler::sectionFinished ( ) const
inlineinherited

Definition at line 209 of file GenericSAXHandler.h.

References GenericSAXHandler::mySectionEnded.

Referenced by SUMOSAXReader::parseSection().

Here is the caller graph for this function:

◆ setFileName()

void GenericSAXHandler::setFileName ( const std::string &  name)
inherited

Sets the current file name.

Parameters
[in]nameThe name of the currently processed file
Todo:
Hmmm - this is as unsafe as having a direct access to the variable; recheck

Definition at line 74 of file GenericSAXHandler.cpp.

References GenericSAXHandler::myFileName.

Referenced by NIImporter_SUMO::_loadNetwork(), MSStateHandler::MSStateTimeHandler::getTime(), GUISettingsHandler::GUISettingsHandler(), NIImporter_OpenStreetMap::load(), NIImporter_Vissim::load(), PCNetProjectionLoader::load(), NITypeLoader::load(), loadNet(), ROLoader::loadNet(), NIImporter_ITSUMO::loadNetwork(), NIImporter_MATSim::loadNetwork(), NIImporter_OpenDrive::loadNetwork(), main(), and XMLSubSys::runParser().

Here is the caller graph for this function:

◆ setNodes()

bool NIXMLEdgesHandler::setNodes ( const SUMOSAXAttributes attrs)
private

Sets from/to node information of the currently parsed edge.

If the nodes could be retrieved/built, they are set in myFromNode/myToNode, respectively, and true is returned. If not, false is returned.

Parameters
[in]attrsThe SAX-attributes to parse the nodes from
Returns
Whether valid nodes exist

Definition at line 541 of file NIXMLEdgesHandler.cpp.

References SUMOSAXAttributes::get(), NBEdge::getFromNode(), NBEdge::getToNode(), SUMOSAXAttributes::hasAttribute(), myCurrentEdge, myCurrentID, myFromNode, myIsUpdate, myNodeCont, myToNode, NBNodeCont::retrieve(), SUMO_ATTR_FROM, SUMO_ATTR_TO, TL, and WRITE_ERRORF.

Referenced by addEdge().

Here is the caller graph for this function:

◆ setSection()

void GenericSAXHandler::setSection ( const int  element,
const bool  seen 
)
inlineinherited

Definition at line 202 of file GenericSAXHandler.h.

References GenericSAXHandler::mySection, GenericSAXHandler::mySectionEnded, GenericSAXHandler::mySectionOpen, and GenericSAXHandler::mySectionSeen.

Referenced by SUMOSAXReader::parseSection().

Here is the caller graph for this function:

◆ startElement()

void GenericSAXHandler::startElement ( const XMLCh *const  uri,
const XMLCh *const  localname,
const XMLCh *const  qname,
const XERCES_CPP_NAMESPACE::Attributes &  attrs 
)
inherited

The inherited method called when a new tag opens.

The method parses the supplied XMLCh*-qname using the internal name/enum-map to obtain the enum representation of the attribute name.

Then, "myStartElement" is called supplying the enumeration value, the string-representation of the name and the attributes.

Todo:

recheck/describe encoding of the string-representation

do not generate and report the string-representation

Definition at line 99 of file GenericSAXHandler.cpp.

References GenericSAXHandler::convertTag(), FileHelpers::getConfigurationRelative(), GenericSAXHandler::getFileName(), SUMOSAXAttributesImpl_Xerces::getString(), FileHelpers::isAbsolute(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myExpectedRoot, GenericSAXHandler::myNextSectionStart, GenericSAXHandler::myPredefinedTags, GenericSAXHandler::myPredefinedTagsMML, GenericSAXHandler::myRootSeen, GenericSAXHandler::mySection, GenericSAXHandler::mySectionEnded, GenericSAXHandler::mySectionOpen, GenericSAXHandler::mySectionSeen, GenericSAXHandler::myStartElement(), XMLSubSys::runParser(), SUMO_ATTR_HREF, SUMO_TAG_INCLUDE, TL, StringUtils::transcode(), and WRITE_WARNINGF.

◆ tryGetLaneSpread()

LaneSpreadFunction NIXMLEdgesHandler::tryGetLaneSpread ( const SUMOSAXAttributes attrs)
private

Tries to parse the spread type.

Definition at line 608 of file NIXMLEdgesHandler.cpp.

References StringBijection< T >::get(), SUMOSAXAttributes::getOpt(), SUMOXMLDefinitions::LaneSpreadFunctions, myCurrentID, myLanesSpread, SUMO_ATTR_SPREADTYPE, TL, toString(), and WRITE_WARNINGF.

Referenced by addEdge().

Here is the caller graph for this function:

◆ tryGetShape()

PositionVector NIXMLEdgesHandler::tryGetShape ( const SUMOSAXAttributes attrs)
private

Tries to parse the shape definition.

Returns the edge's geometry (may be empty if no one was defined). Writes an error message if an error occurred.

Parameters
[in]attrsThe attributes to read the shape from
Returns
The edge's shape

Definition at line 578 of file NIXMLEdgesHandler.cpp.

References NBNetBuilder::addGeometrySegments(), OptionsCont::getFloat(), SUMOSAXAttributes::getOpt(), OptionsCont::getOptions(), NBNode::getPosition(), SUMOSAXAttributes::hasAttribute(), myCurrentID, myFromNode, myKeepEdgeShape, myLocation, myReinitKeepEdgeShape, myShape, myToNode, SUMO_ATTR_SHAPE, TL, NBNetBuilder::transformCoordinates(), and WRITE_ERRORF.

Referenced by addEdge().

Here is the caller graph for this function:

◆ warning()

void GenericSAXHandler::warning ( const XERCES_CPP_NAMESPACE::SAXParseException &  exception)
inherited

Handler for XML-warnings.

The message is built using buildErrorMessage and reported to the warning-instance of the MsgHandler.

Parameters
[in]exceptionThe occurred exception to process

Definition at line 218 of file GenericSAXHandler.cpp.

References GenericSAXHandler::buildErrorMessage(), and WRITE_WARNING.

Field Documentation

◆ myBikeLaneWidth

double NIXMLEdgesHandler::myBikeLaneWidth
private

The width of the bike lane that shall be added to the current edge.

Definition at line 188 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), and myEndElement().

◆ myCharactersVector

std::vector<std::string> GenericSAXHandler::myCharactersVector
privateinherited

A list of character strings obtained so far to build the complete characters string at the end.

Definition at line 324 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::characters(), GenericSAXHandler::endElement(), and GenericSAXHandler::startElement().

◆ myCollectCharacterData

bool GenericSAXHandler::myCollectCharacterData = false
privateinherited

whether the reader should collect character data

Definition at line 339 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::characters(), and GenericSAXHandler::needsCharacterData().

◆ myCurrentEdge

NBEdge* NIXMLEdgesHandler::myCurrentEdge
private

The currently processed edge.

Definition at line 219 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), addLane(), addSplit(), myEndElement(), myStartElement(), and setNodes().

◆ myCurrentEndOffset

double NIXMLEdgesHandler::myCurrentEndOffset
private

The current edge's offset till the destination node.

Definition at line 158 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myCurrentFriction

double NIXMLEdgesHandler::myCurrentFriction
private

The current edge's friction.

Definition at line 146 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myCurrentID

std::string NIXMLEdgesHandler::myCurrentID
private

The current edge's id.

Definition at line 140 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), addLane(), addSplit(), deleteEdge(), myEndElement(), myStartElement(), setNodes(), tryGetLaneSpread(), and tryGetShape().

◆ myCurrentLaneIndex

int NIXMLEdgesHandler::myCurrentLaneIndex
private

The currently processed lane index.

Definition at line 222 of file NIXMLEdgesHandler.h.

Referenced by addLane(), myEndElement(), and myStartElement().

◆ myCurrentLaneNo

int NIXMLEdgesHandler::myCurrentLaneNo
private

The current edge's number of lanes.

Definition at line 152 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myCurrentPriority

int NIXMLEdgesHandler::myCurrentPriority
private

The current edge's priority.

Definition at line 149 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myCurrentSpeed

double NIXMLEdgesHandler::myCurrentSpeed
private

The current edge's maximum speed.

Definition at line 143 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myCurrentStreetName

std::string NIXMLEdgesHandler::myCurrentStreetName
private

The current edge's street name.

Definition at line 161 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myCurrentType

std::string NIXMLEdgesHandler::myCurrentType
private

The current edge's type.

Definition at line 164 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myCurrentWidth

double NIXMLEdgesHandler::myCurrentWidth
private

The current edge's lane width.

Definition at line 155 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myDistrictCont

NBDistrictCont& NIXMLEdgesHandler::myDistrictCont
private

The districts container (needed if an edge must be split)

Definition at line 210 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), deleteEdge(), and myEndElement().

◆ myEdgeCont

NBEdgeCont& NIXMLEdgesHandler::myEdgeCont
private

The edges container (for insertion of build edges)

Definition at line 204 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), addRoundabout(), addSplit(), deleteEdge(), and myEndElement().

◆ myExpectedRoot

std::string GenericSAXHandler::myExpectedRoot
privateinherited

The root element to expect, empty string disables the check.

Definition at line 336 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::startElement().

◆ myFileName

std::string GenericSAXHandler::myFileName
privateinherited

The name of the currently parsed file.

Definition at line 333 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::getFileName(), and GenericSAXHandler::setFileName().

◆ myFromNode

NBNode* NIXMLEdgesHandler::myFromNode
private

The nodes the edge starts and ends at.

Definition at line 167 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), setNodes(), and tryGetShape().

◆ myHaveReportedAboutOverwriting

bool NIXMLEdgesHandler::myHaveReportedAboutOverwriting
private

Information whether at least one edge's attributes were overwritten.

Definition at line 249 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myHaveReportedAboutTypeOverride

bool NIXMLEdgesHandler::myHaveReportedAboutTypeOverride
private

Information whether at least one edge's type was changed.

Definition at line 252 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myHaveWarnedAboutDeprecatedLaneId

bool NIXMLEdgesHandler::myHaveWarnedAboutDeprecatedLaneId
private

Definition at line 254 of file NIXMLEdgesHandler.h.

Referenced by addLane().

◆ myIsUpdate

bool NIXMLEdgesHandler::myIsUpdate
private

Whether this edge definition is an update of a previously inserted edge.

Definition at line 194 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), myEndElement(), and setNodes().

◆ myKeepEdgeShape

const bool NIXMLEdgesHandler::myKeepEdgeShape
private

Whether the edge shape shall be kept generally.

Definition at line 257 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), and tryGetShape().

◆ myLanesSpread

LaneSpreadFunction NIXMLEdgesHandler::myLanesSpread
private

Information about how to spread the lanes.

Definition at line 176 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), and tryGetLaneSpread().

◆ myLastParameterised

std::vector<Parameterised*> NIXMLEdgesHandler::myLastParameterised
private

element to receive parameters

Definition at line 260 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), addLane(), myEndElement(), and myStartElement().

◆ myLength

double NIXMLEdgesHandler::myLength
private

The current edge's length.

Definition at line 170 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myLocation

GeoConvHelper* NIXMLEdgesHandler::myLocation = nullptr
private

The coordinate transformation which was used compute the node coordinates.

Definition at line 263 of file NIXMLEdgesHandler.h.

Referenced by addLane(), addSplit(), myEndElement(), myStartElement(), tryGetShape(), and ~NIXMLEdgesHandler().

◆ myNextSectionStart

std::pair<int, SUMOSAXAttributes*> GenericSAXHandler::myNextSectionStart
privateinherited

◆ myNodeCont

NBNodeCont& NIXMLEdgesHandler::myNodeCont
private

The nodes container (for retrieval of referenced nodes)

Definition at line 201 of file NIXMLEdgesHandler.h.

Referenced by addSplit(), myEndElement(), and setNodes().

◆ myOptions

OptionsCont& NIXMLEdgesHandler::myOptions
private

A reference to the program's options.

Definition at line 133 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), and addSplit().

◆ myParentHandler

GenericSAXHandler* GenericSAXHandler::myParentHandler
privateinherited

The handler to give control back to.

Definition at line 327 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::callParentEnd(), GenericSAXHandler::endElement(), and GenericSAXHandler::registerParent().

◆ myParentIndicator

int GenericSAXHandler::myParentIndicator
privateinherited

The tag indicating that control should be given back.

Definition at line 330 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::endElement(), and GenericSAXHandler::registerParent().

◆ myPermissions

SVCPermissions NIXMLEdgesHandler::myPermissions
private

Information about lane permissions.

Definition at line 179 of file NIXMLEdgesHandler.h.

Referenced by addEdge().

◆ myPredefinedTags

AttrMap GenericSAXHandler::myPredefinedTags
privateinherited

◆ myPredefinedTagsMML

std::vector<std::string> GenericSAXHandler::myPredefinedTagsMML
privateinherited

the map from ids to their string representation

Definition at line 309 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::GenericSAXHandler(), and GenericSAXHandler::startElement().

◆ myReinitKeepEdgeShape

bool NIXMLEdgesHandler::myReinitKeepEdgeShape
private

Whether the edge shape shall be kept at reinitilization.

Definition at line 182 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), and tryGetShape().

◆ myRootSeen

bool GenericSAXHandler::myRootSeen = false
privateinherited

whether the reader has already seen the root element

Definition at line 342 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::startElement().

◆ mySection

int GenericSAXHandler::mySection = -1
privateinherited

The tag indicating the current section to parse.

Definition at line 345 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::endElement(), GenericSAXHandler::setSection(), and GenericSAXHandler::startElement().

◆ mySectionEnded

bool GenericSAXHandler::mySectionEnded = false
privateinherited

whether the reader has already seen the end of the section

Definition at line 351 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::sectionFinished(), GenericSAXHandler::setSection(), and GenericSAXHandler::startElement().

◆ mySectionOpen

bool GenericSAXHandler::mySectionOpen = false
privateinherited

whether an element of the current section is open

Definition at line 354 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::endElement(), GenericSAXHandler::setSection(), and GenericSAXHandler::startElement().

◆ mySectionSeen

bool GenericSAXHandler::mySectionSeen = false
privateinherited

whether the reader has already seen the begin of the section

Definition at line 348 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler::setSection(), and GenericSAXHandler::startElement().

◆ myShape

PositionVector NIXMLEdgesHandler::myShape
private

The shape of the edge.

Definition at line 173 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), and tryGetShape().

◆ mySidewalkWidth

double NIXMLEdgesHandler::mySidewalkWidth
private

The width of the sidewalk that shall be added to the current edge.

Definition at line 185 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), and myEndElement().

◆ mySplits

std::vector<NBEdgeCont::Split> NIXMLEdgesHandler::mySplits
private

The list of this edge's splits.

Definition at line 225 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), addSplit(), and myEndElement().

◆ myTagMap

TagMap GenericSAXHandler::myTagMap
privateinherited

◆ myTLLogicCont

NBTrafficLightLogicCont& NIXMLEdgesHandler::myTLLogicCont
private

The traffic lights container to add built tls to (when invalidating tls because of splits)

Definition at line 214 of file NIXMLEdgesHandler.h.

Referenced by addSplit(), and myEndElement().

◆ myToNode

NBNode * NIXMLEdgesHandler::myToNode
private

Definition at line 167 of file NIXMLEdgesHandler.h.

Referenced by addEdge(), setNodes(), and tryGetShape().

◆ myTypeCont

NBTypeCont& NIXMLEdgesHandler::myTypeCont
private

The types container (for retrieval of type defaults)

Definition at line 207 of file NIXMLEdgesHandler.h.

Referenced by addEdge().


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