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

#include <NIXMLEdgesHandler.h>

Inheritance diagram for NIXMLEdgesHandler:

Collaboration diagram for NIXMLEdgesHandler:

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
NIXMLEdgesHandler &	operator= (const NIXMLEdgesHandler &s)
	invalid assignment operator

Private Attributes
NBEdge *	myCurrentEdge
	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
GeoConvHelper *	myLocation = nullptr
	The coordinate transformation which was used compute the node coordinates.
std::vector< NBEdgeCont::Split >	mySplits
	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.
NBNode *	myFromNode
	The nodes the edge starts and ends at.
NBNode *	myToNode
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.)
NBNodeCont &	myNodeCont
	The nodes container (for retrieval of referenced nodes).
NBEdgeCont &	myEdgeCont
	The edges container (for insertion of build edges).
NBTypeCont &	myTypeCont
	The types container (for retrieval of type defaults).
NBDistrictCont &	myDistrictCont
	The districts container (needed if an edge must be split).
NBTrafficLightLogicCont &	myTLLogicCont
	The traffic lights container to add built tls to (when invalidating tls because of splits).

inherited from GenericSAXHandler
OptionsCont &	myOptions
	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.
GenericSAXHandler *	myParentHandler
	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]	nc	The nodes container (for retrieval of referenced nodes)
[in]	ec	The edges container (for insertion of build edges)
[in]	tc	The types container (for retrieval of type defaults)
[in]	dc	The districts container (needed if an edge must be split)
[in]	options	The options to use while building edges

Definition at line 51 of file NIXMLEdgesHandler.cpp.

References myCurrentEdge, myCurrentLaneIndex, myDistrictCont, myEdgeCont, myHaveReportedAboutOverwriting, myHaveReportedAboutTypeOverride, myHaveWarnedAboutDeprecatedLaneId, myKeepEdgeShape, myNodeCont, myOptions, myTLLogicCont, myTypeCont, and SUMOSAXHandler::SUMOSAXHandler().

Referenced by NIXMLEdgesHandler(), and operator=().

Here is the caller graph for this function:

◆ ~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

References NIXMLEdgesHandler().

Member Function Documentation

◆ addEdge()

void NIXMLEdgesHandler::addEdge ( const SUMOSAXAttributes & attrs )

private

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

Parameters

[in] attrs The attributes to get the edge's values from

Definition at line 159 of file NIXMLEdgesHandler.cpp.

References NBTypeCont::LaneTypeDefinition::attrs, NBTypeCont::LaneTypeDefinition::friction, SUMOSAXAttributes::get(), SUMOSAXAttributes::getOpt(), SUMOSAXAttributes::getStringSecure(), SUMOSAXAttributes::hasAttribute(), 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(), NBTypeCont::LaneTypeDefinition::permissions, setNodes(), NBTypeCont::LaneTypeDefinition::speed, 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_ROUTINGTYPE, 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, NBTypeCont::LaneTypeDefinition::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

Parses a lane and modifies myCurrentEdge according to the given attribures.

Parameters

[in] attrs The attributes to get the lanes's values from

Definition at line 381 of file NIXMLEdgesHandler.cpp.

References SUMOSAXAttributes::get(), SUMOSAXAttributes::getOpt(), OptionsCont::getOptions(), SUMOSAXAttributes::hasAttribute(), myCurrentEdge, myCurrentID, myCurrentLaneIndex, myHaveWarnedAboutDeprecatedLaneId, myLastParameterised, myLocation, parseVehicleClasses(), PositionVector::push_front(), PositionVector::removeDoublePoints(), SUMO_ATTR_ACCELERATION, SUMO_ATTR_ALLOW, SUMO_ATTR_CHANGE_LEFT, SUMO_ATTR_CHANGE_RIGHT, SUMO_ATTR_DISALLOW, SUMO_ATTR_ENDOFFSET, SUMO_ATTR_FRICTION, SUMO_ATTR_ID, SUMO_ATTR_INDEX, SUMO_ATTR_PREFER, SUMO_ATTR_SHAPE, SUMO_ATTR_SPEED, SUMO_ATTR_TYPE, SUMO_ATTR_WIDTH, TL, toString(), NBNetBuilder::transformCoordinates(), WRITE_ERRORF, and WRITE_WARNINGF.

Referenced by myStartElement().

Here is the caller graph for this function:

◆ addRoundabout()

void NIXMLEdgesHandler::addRoundabout ( const SUMOSAXAttributes & attrs )

private

Parses a roundabout and stores it in myEdgeCont.

Parameters

[in] attrs The attributes to get the roundabouts values from

Definition at line 698 of file NIXMLEdgesHandler.cpp.

References SUMOSAXAttributes::get(), myEdgeCont, SUMO_ATTR_EDGES, TL, and WRITE_ERRORF.

Referenced by myStartElement().

Here is the caller graph for this function:

◆ addSplit()

void NIXMLEdgesHandler::addSplit ( const SUMOSAXAttributes & attrs )

private

Parses a split and stores it in mySplits. Splits are executed Upon reading the end tag of an edge.

Parameters

[in] attrs The attributes to get the splits's values from

Definition at line 470 of file NIXMLEdgesHandler.cpp.

Referenced by myStartElement().

Here is the caller graph for this function:

◆ 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] exception The name of the currently processed file

Returns: A string describing the given exception

Definition at line 205 of file GenericSAXHandler.cpp.

References getFileName(), and TL.

Referenced by error(), fatalError(), and 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 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 myCharactersVector, 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] name The string to convert

Returns: The string converted into a XMLCh-string

Definition at line 86 of file GenericSAXHandler.cpp.

Referenced by 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] tag The 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 myTagMap, and SUMO_TAG_NOTHING.

Referenced by endElement(), and 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] attrs The attributes to get the edge id and the optional lane index from

Definition at line 625 of file NIXMLEdgesHandler.cpp.

References NBEdge::deleteLane(), SUMOSAXAttributes::get(), SUMOSAXAttributes::getOpt(), myCurrentID, myDistrictCont, myEdgeCont, 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 convertTag(), myCharacters(), myCharactersVector, myEndElement(), myParentHandler, myParentIndicator, mySection, 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] exception The occurred exception to process

Exceptions

ProcessError On any call

Definition at line 224 of file GenericSAXHandler.cpp.

References 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

ProcessError On any call

Parameters

[in] exception The occurred exception to process

Definition at line 230 of file GenericSAXHandler.cpp.

References buildErrorMessage().

◆ getFileName()

const std::string & GenericSAXHandler::getFileName ( ) const

inherited

returns the current file name

Returns: The name of the currently processed file

Definition at line 80 of file GenericSAXHandler.cpp.

References myFileName.

Referenced by NLHandler::addE1Detector(), NLHandler::addE2Detector(), NLHandler::addEdgeLaneMeanData(), NLHandler::addInstantE1Detector(), SUMORouteHandler::addParam(), ShapeHandler::addPOI(), ShapeHandler::addPoly(), NLHandler::addRouteProbeDetector(), NLHandler::addVTypeProbeDetector(), NLHandler::beginE3Detector(), buildErrorMessage(), MSRouteHandler::closeVType(), PCNetProjectionLoader::load(), NLHandler::myEndElement(), GUISettingsHandler::myStartElement(), NIImporter_OpenDrive::myStartElement(), NIXMLConnectionsHandler::myStartElement(), NIXMLEdgesHandler::myStartElement(), NIXMLNodesHandler::myStartElement(), NLHandler::myStartElement(), RODFDetectorHandler::myStartElement(), SUMORouteHandler::myStartElement(), DataHandler::parse(), GeneralHandler::parse(), XMLSubSys::runParser(), and startElement().

Here is the caller graph for this function:

◆ 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]	element	The opened element, given as a int
[in]	chars	The 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 endElement().

Here is the caller graph for this function:

◆ myEndElement()

void NIXMLEdgesHandler::myEndElement ( int element )

protectedvirtual

Called when a closing tag occurs.

Parameters

[in] element ID of the currently opened element

Exceptions

ProcessError If something fails

See also: GenericSAXHandler::myEndElement

Reimplemented from GenericSAXHandler.

Definition at line 647 of file NIXMLEdgesHandler.cpp.

References StopOffset::isDefined(), myBikeLaneWidth, myCurrentEdge, myCurrentID, myCurrentLaneIndex, myDistrictCont, myEdgeCont, myIsUpdate, myLastParameterised, myLocation, myNodeCont, mySidewalkWidth, mySplits, myTLLogicCont, SUMO_TAG_EDGE, SUMO_TAG_LANE, SUMO_TAG_VIEWSETTINGS_EDGES, TL, NBEdge::UNSPECIFIED_WIDTH, WRITE_ERROR, and WRITE_ERRORF.

◆ myStartElement()

void NIXMLEdgesHandler::myStartElement	(	int	element,
		const SUMOSAXAttributes &	attrs )

protectedvirtual

Called on the opening of a tag;.

Parameters

[in]	element	ID of the currently opened element
[in]	attrs	Attributes within the currently opened element

Exceptions

ProcessError If something fails

See also: GenericSAXHandler::myStartElement

Reimplemented from GenericSAXHandler.

Definition at line 79 of file NIXMLEdgesHandler.cpp.

References addEdge(), addLane(), addRoundabout(), addSplit(), deleteEdge(), SUMOSAXAttributes::get(), GenericSAXHandler::getFileName(), GeoConvHelper::getLoadedPlain(), StopOffset::getOffset(), SUMOSAXAttributes::getString(), SUMOSAXAttributes::hasAttribute(), NIImporter_SUMO::loadLocation(), myCurrentEdge, myCurrentID, myCurrentLaneIndex, myLastParameterised, myLocation, SUMO_ATTR_KEY, SUMO_ATTR_LANE, SUMO_ATTR_VALUE, SUMO_TAG_DEL, SUMO_TAG_EDGE, SUMO_TAG_LANE, SUMO_TAG_LOCATION, SUMO_TAG_NEIGH, SUMO_TAG_PARAM, SUMO_TAG_ROUNDABOUT, SUMO_TAG_SPLIT, SUMO_TAG_STOPOFFSET, SUMO_TAG_VIEWSETTINGS_EDGES, WRITE_ERROR, and WRITE_WARNING.

◆ needsCharacterData()

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

inlineinherited

Definition at line 220 of file GenericSAXHandler.h.

References invalid_return< std::string >::value, and 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

References NIXMLEdgesHandler().

◆ 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, 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 myNextSectionStart.

◆ sectionFinished()

bool GenericSAXHandler::sectionFinished ( ) const

inlineinherited

Definition at line 209 of file GenericSAXHandler.h.

References mySectionEnded.

◆ setFileName()

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

inherited

Sets the current file name.

Parameters

[in] name The 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 myFileName.

Referenced by NIImporter_SUMO::_loadNetwork(), MSStateHandler::MSStateTimeHandler::getTime(), GUISettingsHandler::GUISettingsHandler(), NIImporter_OpenStreetMap::load(), NIImporter_Vissim::load(), NITypeLoader::load(), PCNetProjectionLoader::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] attrs The SAX-attributes to parse the nodes from

Returns: Whether valid nodes exist

Definition at line 543 of file NIXMLEdgesHandler.cpp.

References SUMOSAXAttributes::get(), SUMOSAXAttributes::hasAttribute(), myCurrentEdge, myCurrentID, myFromNode, myIsUpdate, myNodeCont, myToNode, 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 mySection, mySectionEnded, mySectionOpen, and mySectionSeen.

◆ 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 convertTag(), FileHelpers::getConfigurationRelative(), getFileName(), SUMOSAXAttributesImpl_Xerces::getString(), FileHelpers::isAbsolute(), myCharactersVector, myExpectedRoot, myNextSectionStart, myPredefinedTags, myPredefinedTagsMML, myRootSeen, mySection, mySectionEnded, mySectionOpen, mySectionSeen, 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 610 of file NIXMLEdgesHandler.cpp.

References 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] attrs The attributes to read the shape from

Returns: The edge's shape

Definition at line 580 of file NIXMLEdgesHandler.cpp.

References NBNetBuilder::addGeometrySegments(), OptionsCont::getFloat(), SUMOSAXAttributes::getOpt(), OptionsCont::getOptions(), 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] exception The occurred exception to process

Definition at line 218 of file GenericSAXHandler.cpp.

References 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 characters(), endElement(), and startElement().

◆ myCollectCharacterData

bool GenericSAXHandler::myCollectCharacterData = false

privateinherited

whether the reader should collect character data

Definition at line 339 of file GenericSAXHandler.h.

Referenced by characters(), and 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(), NIXMLEdgesHandler(), 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(), myStartElement(), and NIXMLEdgesHandler().

◆ 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(), myEndElement(), and NIXMLEdgesHandler().

◆ 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(), myEndElement(), and NIXMLEdgesHandler().

◆ 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(), and 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 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(), and NIXMLEdgesHandler().

◆ 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(), and NIXMLEdgesHandler().

◆ myHaveWarnedAboutDeprecatedLaneId

bool NIXMLEdgesHandler::myHaveWarnedAboutDeprecatedLaneId

private

Definition at line 254 of file NIXMLEdgesHandler.h.

Referenced by addLane(), and NIXMLEdgesHandler().

◆ 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(), NIXMLEdgesHandler(), 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

Definition at line 356 of file GenericSAXHandler.h.

Referenced by GenericSAXHandler(), retrieveNextSectionStart(), startElement(), and ~GenericSAXHandler().

◆ 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(), NIXMLEdgesHandler(), 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(), addSplit(), and NIXMLEdgesHandler().

◆ myParentHandler

GenericSAXHandler* GenericSAXHandler::myParentHandler

privateinherited

The handler to give control back to.

Definition at line 327 of file GenericSAXHandler.h.

Referenced by callParentEnd(), endElement(), GenericSAXHandler(), and 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 endElement(), GenericSAXHandler(), and 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

Definition at line 306 of file GenericSAXHandler.h.

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

◆ 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(), and 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 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 endElement(), setSection(), and 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 sectionFinished(), setSection(), and 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 endElement(), setSection(), and 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 setSection(), and 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

Definition at line 320 of file GenericSAXHandler.h.

Referenced by convertTag(), and GenericSAXHandler().

◆ 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(), myEndElement(), and NIXMLEdgesHandler().

◆ 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(), and NIXMLEdgesHandler().

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

Data Structures

Public Member Functions

Private Member Functions

Private Attributes

inherited from GenericSAXHandler

attributes parsing

elements parsing

SAX ErrorHandler callbacks

Detailed Description

Member Typedef Documentation

◆ AttrMap

◆ TagMap

Constructor & Destructor Documentation

◆ NIXMLEdgesHandler() [1/2]

◆ ~NIXMLEdgesHandler()

◆ NIXMLEdgesHandler() [2/2]

Member Function Documentation

◆ addEdge()

◆ addLane()

◆ addRoundabout()

◆ addSplit()

◆ buildErrorMessage()

◆ callParentEnd()

◆ characters()

◆ convert()

◆ convertTag()

◆ deleteEdge()

◆ endElement()

◆ error()

◆ fatalError()

◆ getFileName()

◆ myCharacters()

◆ myEndElement()

◆ myStartElement()

◆ needsCharacterData()

◆ operator=()

◆ registerParent()

◆ retrieveNextSectionStart()

◆ sectionFinished()

◆ setFileName()

◆ setNodes()

◆ setSection()

◆ startElement()

◆ tryGetLaneSpread()

◆ tryGetShape()

◆ warning()

Field Documentation

◆ myBikeLaneWidth

◆ myCharactersVector

◆ myCollectCharacterData

◆ myCurrentEdge

◆ myCurrentEndOffset

◆ myCurrentFriction

◆ myCurrentID

◆ myCurrentLaneIndex

◆ myCurrentLaneNo

◆ myCurrentPriority

◆ myCurrentSpeed

◆ myCurrentStreetName

◆ myCurrentType

◆ myCurrentWidth

◆ myDistrictCont

◆ myEdgeCont

◆ myExpectedRoot

◆ myFileName

◆ myFromNode

◆ myHaveReportedAboutOverwriting

◆ myHaveReportedAboutTypeOverride

◆ myHaveWarnedAboutDeprecatedLaneId

◆ myIsUpdate

◆ myKeepEdgeShape

◆ myLanesSpread

◆ myLastParameterised

◆ myLength

◆ myLocation

◆ myNextSectionStart

◆ myNodeCont

◆ myOptions

◆ myParentHandler

◆ myParentIndicator