SUMO - Simulation of Urban MObility
|
The base class for SUMO-native route handlers. More...
#include <RORDLoader_SUMOBase.h>
Public Member Functions | |
void | characters (const XMLCh *const chars, const XERCES3_SIZE_t length) |
The inherited method called when characters occured. More... | |
void | endDocument () |
Called when the document has ended. More... | |
bool | ended () const |
Returns the information whether no routes are available from this loader anymore. More... | |
void | endElement (const XMLCh *const uri, const XMLCh *const localname, const XMLCh *const qname) |
The inherited method called when a tag is being closed. More... | |
const std::string & | getFileName () const |
returns the current file name More... | |
SUMOTime | getLastReadTimeStep () const |
Returns the time the current (last read) route starts at. More... | |
virtual bool | readRoutesAtLeastUntil (SUMOTime time) |
Adds routes from the file until the given time is reached. More... | |
void | registerParent (const int tag, GenericSAXHandler *handler) |
Assigning a parent handler which is enabled when the specified tag is closed. More... | |
RORDLoader_SUMOBase (RONet &net, SUMOTime begin, SUMOTime end, const bool tryRepair, const bool withTaz, const std::string &file="") | |
Constructor. More... | |
void | setFileName (const std::string &name) |
Sets the current file name. More... | |
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. More... | |
~RORDLoader_SUMOBase () | |
Destructor. More... | |
SAX ErrorHandler callbacks | |
void | warning (const XERCES_CPP_NAMESPACE::SAXParseException &exception) |
Handler for XML-warnings. More... | |
void | error (const XERCES_CPP_NAMESPACE::SAXParseException &exception) |
Handler for XML-errors. More... | |
void | fatalError (const XERCES_CPP_NAMESPACE::SAXParseException &exception) |
Handler for XML-errors. More... | |
Protected Member Functions | |
std::string | buildErrorMessage (const XERCES_CPP_NAMESPACE::SAXParseException &exception) |
Builds an error message. More... | |
bool | closeVehicle () |
virtual void | myCharacters (int element, const std::string &chars) |
Callback method for characters to implement by derived classes. More... | |
void | parseRoute (const std::string &chars) |
Parses a route edge list. More... | |
void | startAlternative (const SUMOSAXAttributes &attrs) |
Begins the parsing of the next route alternative in the file. More... | |
void | startRoute (const SUMOSAXAttributes &attrs) |
Begins the parsing of a route alternative of the opened route. More... | |
inherited from GenericSAXHandler | |
virtual void | myStartElement (int element, const SUMOSAXAttributes &attrs) |
Called on the opening of a tag;. More... | |
virtual void | myEndElement (int element) |
Called when a closing tag occurs. More... | |
Protected Attributes | |
bool | myAltIsValid |
Information whether the currently parsed alternatives set is valid. More... | |
SUMOTime | myBegin |
The time for which the first route shall be loaded. More... | |
RGBColor * | myColor |
The color of the current route/vehicle. More... | |
SUMOReal | myCost |
The costs of the current alternative. More... | |
RORouteDef * | myCurrentAlternatives |
The currently parsed route alternatives. More... | |
SUMOTime | myCurrentDepart |
The currently read vehicle's depart. More... | |
bool | myCurrentIsOk |
Information whether the currently parsed item is valid. More... | |
RORouteDef * | myCurrentRoute |
The currently parsed route. More... | |
std::string | myCurrentRouteName |
The name of the currently parsed route. More... | |
SUMOVTypeParameter * | myCurrentVType |
The currently parsed vehicle type. More... | |
SUMOTime | myEnd |
The time for which the first route shall be loaded. More... | |
bool | myEnded |
Information whether the whole file has been parsed. More... | |
RONet & | myNet |
The network to add routes to. More... | |
bool | myNextRouteRead |
The information whether the next route was read. More... | |
SUMOSAXReader * | myParser |
The parser used. More... | |
SUMOReal | myProbability |
The probability of the current alternative's usage. More... | |
bool | myTryRepair |
Information whether a read route shall be tried to be repaired. More... | |
SUMOVehicleParameter * | myVehicleParameter |
The parsed vehicle parameter. More... | |
const bool | myWithTaz |
Information whether zones (districts) are used as origins / destinations. More... | |
Private Member Functions | |
RORDLoader_SUMOBase & | operator= (const RORDLoader_SUMOBase &src) |
Invalidated assignment operator. More... | |
RORDLoader_SUMOBase (const RORDLoader_SUMOBase &src) | |
Invalidated copy constructor. More... | |
The base class for SUMO-native route handlers.
As both the SUMO-routes and the SUMO-route alternatives handlers share a set of processing functions, we've joined these functions within a single class (this one).
Definition at line 64 of file RORDLoader_SUMOBase.h.
RORDLoader_SUMOBase::RORDLoader_SUMOBase | ( | RONet & | net, |
SUMOTime | begin, | ||
SUMOTime | end, | ||
const bool | tryRepair, | ||
const bool | withTaz, | ||
const std::string & | file = "" |
||
) |
Constructor.
Definition at line 55 of file RORDLoader_SUMOBase.cpp.
RORDLoader_SUMOBase::~RORDLoader_SUMOBase | ( | ) |
Destructor.
Definition at line 65 of file RORDLoader_SUMOBase.cpp.
References myColor, myCurrentAlternatives, myCurrentRoute, and myVehicleParameter.
|
private |
Invalidated copy constructor.
|
protectedinherited |
Builds an error message.
The error message includes the file name and the line/column information as supported by the given SAXParseException
[in] | exception | The name of the currently processed file |
Definition at line 193 of file GenericSAXHandler.cpp.
References GenericSAXHandler::getFileName().
Referenced by GenericSAXHandler::error(), GenericSAXHandler::fatalError(), and GenericSAXHandler::warning().
|
inherited |
The inherited method called when characters occured.
The retrieved characters are converted into a string and appended into a private buffer. They are reported as soon as the element ends.
recheck/describe what happens with characters when a new element is opened
describe characters processing in the class' head
Definition at line 176 of file GenericSAXHandler.cpp.
References TplConvert::_2str(), and GenericSAXHandler::myCharactersVector.
|
protected |
Definition at line 308 of file RORDLoader_SUMOBase.cpp.
References RONet::addVehicle(), RORouteDef::copy(), SUMOVehicleParameter::depart, MsgHandler::getErrorInstance(), RONet::getRouteDef(), RONet::getVehicleTypeSecure(), SUMOVehicleParameter::id, ROTypedXMLRoutesLoader::myBegin, myCurrentIsOk, ROTypedXMLRoutesLoader::myEnd, ROTypedXMLRoutesLoader::myNet, myVehicleParameter, SUMOVehicleParameter::routeid, SUMOVehicleParameter::vtypeid, and WRITE_ERROR.
Referenced by myEndElement().
|
inherited |
Called when the document has ended.
Definition at line 83 of file ROTypedXMLRoutesLoader.cpp.
References ROTypedXMLRoutesLoader::myEnded.
|
inlineinherited |
Returns the information whether no routes are available from this loader anymore.
Definition at line 101 of file ROTypedXMLRoutesLoader.h.
References ROTypedXMLRoutesLoader::myEnded.
Referenced by ROTypedXMLRoutesLoader::readRoutesAtLeastUntil().
|
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.
recheck/describe encoding of the string-representation
do not generate and report the string-representation
Definition at line 126 of file GenericSAXHandler.cpp.
References TplConvert::_2str(), GenericSAXHandler::convertTag(), GenericSAXHandler::myCharacters(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myEndElement(), GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, XMLSubSys::setHandler(), SUMO_TAG_INCLUDE, and SUMO_TAG_NOTHING.
|
inherited |
Handler for XML-errors.
The message is built using buildErrorMessage and thrown within a ProcessError.
[in] | exception | The occured exception to process |
ProcessError | On any call |
Definition at line 212 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage().
|
inherited |
Handler for XML-errors.
The message is built using buildErrorMessage and thrown within a ProcessError.
ProcessError | On any call |
[in] | exception | The occured exception to process |
Definition at line 218 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage().
|
inherited |
returns the current file name
Definition at line 86 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myFileName.
Referenced by NLHandler::addE1Detector(), NLHandler::addE2Detector(), NLHandler::addEdgeLaneMeanData(), NLHandler::addInstantE1Detector(), NLHandler::addPOI(), NLHandler::addPoly(), NLHandler::addRouteProbeDetector(), NLHandler::addVTypeProbeDetector(), NLHandler::beginE3Detector(), GenericSAXHandler::buildErrorMessage(), MSRouteLoader::init(), PCNetProjectionLoader::loadIfSet(), NILoader::loadXMLType(), MSTriggeredXMLReader::myInit(), GUISettingsHandler::myStartElement(), RODFDetectorHandler::myStartElement(), RORDLoader_TripDefs::myStartElement(), SUMORouteHandler::myStartElement(), myStartElement(), PCLoaderXML::myStartElement(), NLHandler::myStartElement(), NIImporter_OpenDrive::myStartElement(), RORDGenerator_ODAmounts::RORDGenerator_ODAmounts(), ROTypedXMLRoutesLoader::ROTypedXMLRoutesLoader(), XMLSubSys::runParser(), and GenericSAXHandler::startElement().
|
inlineinherited |
Returns the time the current (last read) route starts at.
Definition at line 92 of file ROTypedXMLRoutesLoader.h.
References ROTypedXMLRoutesLoader::myCurrentDepart.
Referenced by ROTypedXMLRoutesLoader::readRoutesAtLeastUntil().
|
protectedvirtualinherited |
Callback method for characters to implement by derived classes.
Called by "endElement" (see there).
[in] | element | The opened element, given as a int |
[in] | chars | The complete embedded character string ProcessError These method may throw a ProcessError if something fails |
Reimplemented in NIImporter_ITSUMO::Handler.
Definition at line 228 of file GenericSAXHandler.cpp.
Referenced by GenericSAXHandler::endElement().
|
protectedvirtual |
Called when a closing tag occurs.
[in] | element | ID of the currently opened element |
ProcessError | If something fails |
Reimplemented from GenericSAXHandler.
Definition at line 259 of file RORDLoader_SUMOBase.cpp.
References RONet::addRouteDef(), RONet::addVehicleType(), closeVehicle(), SUMOVehicleParserHelper::closeVTypeParsing(), myAltIsValid, myCurrentAlternatives, myCurrentIsOk, myCurrentRoute, myCurrentVType, ROTypedXMLRoutesLoader::myNet, ROTypedXMLRoutesLoader::myNextRouteRead, myVehicleParameter, SUMO_TAG_ROUTE, SUMO_TAG_ROUTE_DISTRIBUTION, SUMO_TAG_VEHICLE, and SUMO_TAG_VTYPE.
|
protectedvirtual |
Called on the opening of a tag;.
[in] | element | ID of the currently opened element |
[in] | attrs | Attributes within the currently opened element |
ProcessError | If something fails |
Reimplemented from GenericSAXHandler.
Definition at line 75 of file RORDLoader_SUMOBase.cpp.
References SUMOVehicleParserHelper::beginVTypeParsing(), SUMOVehicleParameter::depart, GenericSAXHandler::getFileName(), myAltIsValid, ROTypedXMLRoutesLoader::myCurrentDepart, myCurrentIsOk, myCurrentVType, myVehicleParameter, SUMOVehicleParserHelper::parseVehicleAttributes(), SUMOVehicleParserHelper::parseVTypeEmbedded(), startAlternative(), startRoute(), SUMO_TAG_ROUTE, SUMO_TAG_ROUTE_DISTRIBUTION, SUMO_TAG_VEHICLE, and SUMO_TAG_VTYPE.
|
private |
Invalidated assignment operator.
|
protected |
Parses a route edge list.
[in] | chars | The read route |
ProcessError | If something fails |
Definition at line 191 of file RORDLoader_SUMOBase.cpp.
References RORouteDef::addLoadedAlternative(), BinaryFormatter::BF_ROUTE, SUMOVehicleParameter::fromTaz, RONet::getEdge(), Named::getID(), StringTokenizer::hasNext(), SUMOVehicleParameter::id, myAltIsValid, myColor, myCost, myCurrentAlternatives, myCurrentIsOk, myCurrentRoute, myCurrentRouteName, ROTypedXMLRoutesLoader::myNet, myProbability, myTryRepair, myVehicleParameter, myWithTaz, StringTokenizer::next(), FileHelpers::readEdgeVector(), SUMOVehicleParameter::toTaz, VEHPARS_TAZ_SET, SUMOVehicleParameter::wasSet(), and WRITE_ERROR.
Referenced by startRoute().
Adds routes from the file until the given time is reached.
[in] | time | The time until which route definitions shall be loaded |
ProcessError | If a major error occured |
Reimplemented in RORDGenerator_ODAmounts.
Definition at line 71 of file ROTypedXMLRoutesLoader.cpp.
References ROTypedXMLRoutesLoader::ended(), ROTypedXMLRoutesLoader::getLastReadTimeStep(), ROTypedXMLRoutesLoader::myEnded, ROTypedXMLRoutesLoader::myNextRouteRead, ROTypedXMLRoutesLoader::myParser, and SUMOSAXReader::parseNext().
|
inherited |
Assigning a parent handler which is enabled when the specified tag is closed.
Definition at line 168 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, and XMLSubSys::setHandler().
Referenced by NLTriggerBuilder::parseAndBuildLaneSpeedTrigger(), and NLTriggerBuilder::parseAndBuildRerouter().
|
inherited |
Sets the current file name.
[in] | name | The name of the currently processed file |
Definition at line 80 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myFileName.
Referenced by NIImporter_SUMO::_loadNetwork(), GUISettingsHandler::GUISettingsHandler(), NIImporter_OpenStreetMap::load(), PCNetProjectionLoader::loadIfSet(), loadNet(), ROLoader::loadNet(), NIImporter_ITSUMO::loadNetwork(), NIImporter_MATSim::loadNetwork(), NIImporter_OpenDrive::loadNetwork(), and XMLSubSys::runParser().
|
protected |
Begins the parsing of the next route alternative in the file.
Definition at line 160 of file RORDLoader_SUMOBase.cpp.
References SUMOSAXAttributes::getIntReporting(), SUMOSAXAttributes::getStringReporting(), SUMOVehicleParameter::id, myCurrentAlternatives, myCurrentIsOk, myVehicleParameter, SUMO_ATTR_ID, SUMO_ATTR_LAST, and WRITE_ERROR.
Referenced by myStartElement().
|
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.
recheck/describe encoding of the string-representation
do not generate and report the string-representation
Definition at line 105 of file GenericSAXHandler.cpp.
References TplConvert::_2str(), GenericSAXHandler::convertTag(), FileHelpers::getConfigurationRelative(), GenericSAXHandler::getFileName(), SUMOSAXAttributesImpl_Xerces::getString(), FileHelpers::isAbsolute(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myPredefinedTags, GenericSAXHandler::myPredefinedTagsMML, GenericSAXHandler::myStartElement(), XMLSubSys::runParser(), SUMO_ATTR_HREF, and SUMO_TAG_INCLUDE.
|
protected |
Begins the parsing of a route alternative of the opened route.
Definition at line 116 of file RORDLoader_SUMOBase.cpp.
References SUMOSAXAttributes::getColorReporting(), Named::getID(), SUMOSAXAttributes::getOptSUMORealReporting(), SUMOSAXAttributes::getStringReporting(), SUMOSAXAttributes::getSUMORealReporting(), SUMOSAXAttributes::hasAttribute(), SUMOVehicleParameter::id, myAltIsValid, myColor, myCost, myCurrentAlternatives, myCurrentIsOk, myCurrentRouteName, myProbability, myVehicleParameter, parseRoute(), SUMO_ATTR_COLOR, SUMO_ATTR_COST, SUMO_ATTR_EDGES, SUMO_ATTR_ID, SUMO_ATTR_PROB, and WRITE_ERROR.
Referenced by myStartElement().
|
inherited |
Handler for XML-warnings.
The message is built using buildErrorMessage and reported to the warning-instance of the MsgHandler.
[in] | exception | The occured exception to process |
Definition at line 206 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage(), and WRITE_WARNING.
|
protected |
Information whether the currently parsed alternatives set is valid.
Definition at line 128 of file RORDLoader_SUMOBase.h.
Referenced by myEndElement(), myStartElement(), parseRoute(), and startRoute().
|
protectedinherited |
The time for which the first route shall be loaded.
Definition at line 118 of file ROTypedXMLRoutesLoader.h.
Referenced by closeVehicle(), RORDGenerator_ODAmounts::myEndFlowAmountDef(), and RORDGenerator_ODAmounts::readRoutesAtLeastUntil().
|
protected |
The color of the current route/vehicle.
Definition at line 122 of file RORDLoader_SUMOBase.h.
Referenced by parseRoute(), startRoute(), and ~RORDLoader_SUMOBase().
|
protected |
The costs of the current alternative.
Definition at line 134 of file RORDLoader_SUMOBase.h.
Referenced by parseRoute(), and startRoute().
|
protected |
The currently parsed route alternatives.
Definition at line 131 of file RORDLoader_SUMOBase.h.
Referenced by myEndElement(), parseRoute(), startAlternative(), startRoute(), and ~RORDLoader_SUMOBase().
|
protectedinherited |
The currently read vehicle's depart.
Definition at line 127 of file ROTypedXMLRoutesLoader.h.
Referenced by ROTypedXMLRoutesLoader::getLastReadTimeStep(), RORDLoader_TripDefs::myStartElement(), myStartElement(), RORDGenerator_ODAmounts::readRoutesAtLeastUntil(), and RORDGenerator_ODAmounts::RORDGenerator_ODAmounts().
|
protected |
Information whether the currently parsed item is valid.
Definition at line 125 of file RORDLoader_SUMOBase.h.
Referenced by closeVehicle(), myEndElement(), myStartElement(), parseRoute(), startAlternative(), and startRoute().
|
protected |
The currently parsed route.
Definition at line 146 of file RORDLoader_SUMOBase.h.
Referenced by myEndElement(), parseRoute(), and ~RORDLoader_SUMOBase().
|
protected |
The name of the currently parsed route.
Definition at line 149 of file RORDLoader_SUMOBase.h.
Referenced by parseRoute(), and startRoute().
|
protected |
The currently parsed vehicle type.
Definition at line 152 of file RORDLoader_SUMOBase.h.
Referenced by myEndElement(), and myStartElement().
|
protectedinherited |
The time for which the first route shall be loaded.
Definition at line 121 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDGenerator_ODAmounts::buildForTimeStep(), closeVehicle(), and RORDLoader_TripDefs::myEndElement().
|
protectedinherited |
Information whether the whole file has been parsed.
Definition at line 133 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDGenerator_ODAmounts::buildForTimeStep(), ROTypedXMLRoutesLoader::endDocument(), ROTypedXMLRoutesLoader::ended(), and ROTypedXMLRoutesLoader::readRoutesAtLeastUntil().
|
protectedinherited |
The network to add routes to.
Definition at line 115 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDGenerator_ODAmounts::buildForTimeStep(), closeVehicle(), RORDLoader_TripDefs::getEdge(), RORDLoader_TripDefs::myEndElement(), myEndElement(), RORDGenerator_ODAmounts::myEndFlowAmountDef(), and parseRoute().
|
protectedinherited |
The information whether the next route was read.
Definition at line 130 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDLoader_TripDefs::myEndElement(), myEndElement(), RORDGenerator_ODAmounts::myEndFlowAmountDef(), and ROTypedXMLRoutesLoader::readRoutesAtLeastUntil().
|
protectedinherited |
The parser used.
Definition at line 124 of file ROTypedXMLRoutesLoader.h.
Referenced by ROTypedXMLRoutesLoader::readRoutesAtLeastUntil(), ROTypedXMLRoutesLoader::ROTypedXMLRoutesLoader(), and ROTypedXMLRoutesLoader::~ROTypedXMLRoutesLoader().
|
protected |
The probability of the current alternative's usage.
Definition at line 137 of file RORDLoader_SUMOBase.h.
Referenced by parseRoute(), and startRoute().
|
protected |
Information whether a read route shall be tried to be repaired.
Definition at line 140 of file RORDLoader_SUMOBase.h.
Referenced by parseRoute().
|
protected |
The parsed vehicle parameter.
Definition at line 119 of file RORDLoader_SUMOBase.h.
Referenced by closeVehicle(), myEndElement(), myStartElement(), parseRoute(), startAlternative(), startRoute(), and ~RORDLoader_SUMOBase().
|
protected |
Information whether zones (districts) are used as origins / destinations.
Definition at line 143 of file RORDLoader_SUMOBase.h.
Referenced by parseRoute().