SUMO - Simulation of Urban MObility
|
Parser for routes during their loading. More...
#include <SUMORouteHandler.h>
Public Member Functions | |
void | characters (const XMLCh *const chars, const XERCES3_SIZE_t length) |
The inherited method called when characters occured. | |
bool | checkStopPos (SUMOReal &startPos, SUMOReal &endPos, const SUMOReal laneLength, const SUMOReal minLength, const bool friendlyPos) |
check start and end position of a stop | |
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 | |
SUMOTime | getLastDepart () const |
Returns the last loaded depart time. | |
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 Attributes &attrs) |
The inherited method called when a new tag opens. | |
SUMORouteHandler (const std::string &file) | |
standard constructor | |
virtual | ~SUMORouteHandler () |
standard destructor | |
SAX ErrorHandler callbacks | |
void | warning (const SAXParseException &exception) |
Handler for XML-warnings. | |
void | error (const SAXParseException &exception) |
Handler for XML-errors. | |
void | fatalError (const SAXParseException &exception) |
Handler for XML-errors. |
Protected Member Functions | |
virtual void | addStop (const SUMOSAXAttributes &attrs)=0 |
Processing of a stop. | |
std::string | buildErrorMessage (const SAXParseException &exception) |
Builds an error message. | |
bool | checkLastDepart () |
Checks whether the route file is sorted by departure time if needed. | |
virtual void | closeFlow ()=0 |
Ends the processing of a flow. | |
virtual void | closePerson ()=0 |
Ends the processing of a person. | |
virtual void | closeRoute ()=0 |
virtual void | closeRouteDistribution ()=0 |
virtual void | closeVehicle ()=0 |
Ends the processing of a vehicle. | |
virtual void | closeVehicleTypeDistribution ()=0 |
virtual void | myCharacters (int element, const std::string &chars) |
Callback method for characters to implement by derived classes. | |
virtual void | openRoute (const SUMOSAXAttributes &attrs)=0 |
virtual void | openRouteDistribution (const SUMOSAXAttributes &attrs)=0 |
virtual void | openVehicleTypeDistribution (const SUMOSAXAttributes &attrs)=0 |
void | registerLastDepart () |
save last depart (only to be used if vehicle is not discarded) | |
inherited from GenericSAXHandler | |
virtual void | myStartElement (int element, const SUMOSAXAttributes &attrs) |
Called on the opening of a tag;. | |
virtual void | myEndElement (int element) |
Called when a closing tag occurs. |
Protected Attributes | |
RGBColor | myActiveRouteColor |
The currently parsed route's color. | |
std::string | myActiveRouteID |
The id of the current route. | |
SUMOReal | myActiveRouteProbability |
The id of the current route. | |
std::string | myActiveRouteRefID |
The id of the route the current route references to. | |
std::vector < SUMOVehicleParameter::Stop > | myActiveRouteStops |
List of the stops on the parsed route. | |
SUMOVTypeParameter * | myCurrentVType |
The currently parsed vehicle type. | |
SUMOTime | myLastDepart |
The insertion time of the vehicle read last. | |
SUMOVehicleParameter * | myVehicleParameter |
Parameter of the current vehicle, trip, person, or flow. |
Private Member Functions | |
SUMORouteHandler & | operator= (const SUMORouteHandler &s) |
Invalidated assignment operator. | |
SUMORouteHandler (const SUMORouteHandler &s) | |
Invalidated copy constructor. |
Parser for routes during their loading.
SUMORouteHandler is the abstract super class for routers and simulation loading routes.
Definition at line 50 of file SUMORouteHandler.h.
SUMORouteHandler::SUMORouteHandler | ( | const std::string & | file | ) |
standard constructor
Definition at line 54 of file SUMORouteHandler.cpp.
|
virtual |
standard destructor
Definition at line 62 of file SUMORouteHandler.cpp.
|
private |
Invalidated copy constructor.
|
protectedpure virtual |
|
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 GenericSAXHandler::myCharactersVector.
|
protected |
Checks whether the route file is sorted by departure time if needed.
Definition at line 73 of file SUMORouteHandler.cpp.
References SUMOVehicleParameter::depart, DEPART_GIVEN, SUMOVehicleParameter::departProcedure, SUMOVehicleParameter::id, myLastDepart, myVehicleParameter, and WRITE_WARNING.
Referenced by MSRouteHandler::closeFlow(), MSRouteHandler::closePerson(), and MSRouteHandler::closeVehicle().
bool SUMORouteHandler::checkStopPos | ( | SUMOReal & | startPos, |
SUMOReal & | endPos, | ||
const SUMOReal | laneLength, | ||
const SUMOReal | minLength, | ||
const bool | friendlyPos | ||
) |
check start and end position of a stop
Definition at line 178 of file SUMORouteHandler.cpp.
Referenced by MSRouteHandler::addStop().
|
protectedpure virtual |
|
protectedpure virtual |
|
protectedpure virtual |
closes (ends) the building of a route. Afterwards no edges may be added to it; this method may throw exceptions when a) the route is empty or b) another route with the same id already exists
Implemented in MSRouteHandler.
Referenced by myEndElement().
|
protectedpure virtual |
closes (ends) the building of a distribution
Implemented in MSRouteHandler.
Referenced by myEndElement().
|
protectedpure virtual |
|
protectedpure virtual |
closes (ends) the building of a distribution
Implemented in MSRouteHandler.
Referenced by myEndElement().
|
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 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().
Referenced by NLHandler::getLanesFromIndices().
|
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::addRouteProbeDetector(), NLHandler::addVTypeProbeDetector(), NLHandler::beginE3Detector(), GenericSAXHandler::buildErrorMessage(), MSRouteLoader::init(), PCNetProjectionLoader::loadIfSet(), NILoader::loadXMLType(), MSTriggeredXMLReader::myInit(), GUISettingsHandler::myStartElement(), RODFDetectorHandler::myStartElement(), NLHandler::myStartElement(), NIImporter_OpenDrive::myStartElement(), RORDGenerator_ODAmounts::RORDGenerator_ODAmounts(), ROTypedXMLRoutesLoader::ROTypedXMLRoutesLoader(), XMLSubSys::runParser(), and GenericSAXHandler::startElement().
SUMOTime SUMORouteHandler::getLastDepart | ( | ) | const |
Returns the last loaded depart time.
Definition at line 67 of file SUMORouteHandler.cpp.
References myLastDepart.
|
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_OpenDrive, NIImporter_SUMO, PCNetProjectionLoader, NIImporter_ITSUMO::Handler, PCLoaderXML, RORDLoader_SUMOBase, and ROJTRTurnDefLoader.
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.
Reimplemented in NLHandler, and MSRouteHandler.
Definition at line 137 of file SUMORouteHandler.cpp.
References closeFlow(), closePerson(), closeRoute(), closeRouteDistribution(), closeVehicle(), closeVehicleTypeDistribution(), SUMOVehicleParserHelper::closeVTypeParsing(), myCurrentVType, myVehicleParameter, SUMOVehicleParameter::repetitionNumber, SUMO_TAG_FLOW, SUMO_TAG_PERSON, SUMO_TAG_ROUTE, SUMO_TAG_ROUTE_DISTRIBUTION, SUMO_TAG_VEHICLE, SUMO_TAG_VTYPE, SUMO_TAG_VTYPE__DEPRECATED, SUMO_TAG_VTYPE_DISTRIBUTION, and SUMO_TAG_VTYPE_DISTRIBUTION__DEPRECATED.
|
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.
Reimplemented in NLHandler, and MSRouteHandler.
Definition at line 94 of file SUMORouteHandler.cpp.
References addStop(), SUMOVehicleParserHelper::beginVTypeParsing(), SUMOVehicleParameter::id, myActiveRouteID, myCurrentVType, myVehicleParameter, openRoute(), openRouteDistribution(), openVehicleTypeDistribution(), SUMOVehicleParserHelper::parseFlowAttributes(), SUMOVehicleParserHelper::parseVehicleAttributes(), SUMOVehicleParameter::setParameter, SUMO_TAG_FLOW, SUMO_TAG_PERSON, SUMO_TAG_ROUTE, SUMO_TAG_ROUTE_DISTRIBUTION, SUMO_TAG_STOP, SUMO_TAG_TRIP, SUMO_TAG_VEHICLE, SUMO_TAG_VTYPE, SUMO_TAG_VTYPE_DISTRIBUTION, and VEHPARS_FORCE_REROUTE.
|
protectedpure virtual |
|
protectedpure virtual |
opens a route distribution for reading
Implemented in MSRouteHandler.
Referenced by myStartElement().
|
protectedpure virtual |
opens a type distribution for reading
Implemented in MSRouteHandler.
Referenced by myStartElement().
|
private |
Invalidated assignment operator.
|
protected |
save last depart (only to be used if vehicle is not discarded)
Definition at line 85 of file SUMORouteHandler.cpp.
References SUMOVehicleParameter::depart, DEPART_GIVEN, SUMOVehicleParameter::departProcedure, myLastDepart, and myVehicleParameter.
Referenced by MSRouteHandler::closeFlow(), MSRouteHandler::closePerson(), and MSRouteHandler::closeVehicle().
|
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(), AGActivityGen::importInfoCity(), NIImporter_OpenStreetMap::load(), PCNetProjectionLoader::loadIfSet(), loadNet(), ROLoader::loadNet(), NIImporter_ITSUMO::loadNetwork(), NIImporter_MATSim::loadNetwork(), NIImporter_OpenDrive::loadNetwork(), NILoader::loadXMLType(), and XMLSubSys::runParser().
|
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 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.
|
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 |
The currently parsed route's color.
Definition at line 147 of file SUMORouteHandler.h.
Referenced by MSRouteHandler::closeRoute(), and MSRouteHandler::openRoute().
|
protected |
The id of the current route.
Definition at line 138 of file SUMORouteHandler.h.
Referenced by MSRouteHandler::addStop(), MSRouteHandler::closeFlow(), MSRouteHandler::closeRoute(), MSRouteHandler::closeVehicle(), myStartElement(), MSRouteHandler::myStartElement(), and MSRouteHandler::openRoute().
|
protected |
The id of the current route.
Definition at line 144 of file SUMORouteHandler.h.
Referenced by MSRouteHandler::closeRoute(), and MSRouteHandler::openRoute().
|
protected |
The id of the route the current route references to.
Definition at line 141 of file SUMORouteHandler.h.
Referenced by MSRouteHandler::closeRoute(), and MSRouteHandler::openRoute().
|
protected |
List of the stops on the parsed route.
Definition at line 150 of file SUMORouteHandler.h.
Referenced by MSRouteHandler::addStop(), and MSRouteHandler::closeRoute().
|
protected |
The currently parsed vehicle type.
Definition at line 153 of file SUMORouteHandler.h.
Referenced by myEndElement(), MSRouteHandler::myEndElement(), myStartElement(), and MSRouteHandler::myStartElement().
|
protected |
The insertion time of the vehicle read last.
Definition at line 135 of file SUMORouteHandler.h.
Referenced by checkLastDepart(), getLastDepart(), and registerLastDepart().
|
protected |
Parameter of the current vehicle, trip, person, or flow.
Definition at line 132 of file SUMORouteHandler.h.
Referenced by MSRouteHandler::addStop(), checkLastDepart(), MSRouteHandler::closeFlow(), MSRouteHandler::closePerson(), MSRouteHandler::closeRoute(), MSRouteHandler::closeVehicle(), myEndElement(), myStartElement(), MSRouteHandler::myStartElement(), MSRouteHandler::openRoute(), MSRouteHandler::openRouteDistribution(), and registerLastDepart().