Parser and output filter for routes and vehicles state saving and loading. More...

#include <MSStateHandler.h>

Inheritance diagram for MSStateHandler:

Collaboration diagram for MSStateHandler:

Public Member Functions
void	characters (const XMLCh *const chars, const XERCES3_SIZE_t length)
	The inherited method called when characters occured. 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	getFirstDepart () const
	returns the first departure time that was ever read More...

SUMOTime	getLastDepart () const
	Returns the last loaded depart time. More...

SUMOTime	getTime () const

	MSStateHandler (const std::string &file, const SUMOTime offset)
	standard constructor More...

void	registerParent (const int tag, GenericSAXHandler *handler)
	Assigning a parent handler which is enabled when the specified tag is closed. 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...

virtual	~MSStateHandler ()
	standard 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...

Static Public Member Functions
static bool	checkStopPos (double &startPos, double &endPos, const double laneLength, const double minLength, const bool friendlyPos)
	check start and end position of a stop More...

static MTRand *	getParsingRNG ()

static void	saveState (const std::string &file, SUMOTime step)
	Saves the current state. More...

Protected Member Functions
void	addParam (const SUMOSAXAttributes &attrs)
	assign arbitrary vehicle parameters More...

void	addStop (const SUMOSAXAttributes &attrs)
	Processing of a stop. More...

std::string	buildErrorMessage (const XERCES_CPP_NAMESPACE::SAXParseException &exception)
	Builds an error message. More...

bool	checkLastDepart ()
	Checks whether the route file is sorted by departure time if needed. More...

void	closeContainer ()
	Ends the processing of a container. More...

void	closeFlow ()
	Ends the processing of a flow. More...

void	closePerson ()
	Ends the processing of a person. More...

void	closeRoute (const bool mayBeDisconnected=false)

void	closeRouteDistribution ()

void	closeVehicle ()
	Ends the processing of a vehicle. More...

void	closeVehicleTypeDistribution ()

virtual void	myCharacters (int element, const std::string &chars)
	Callback method for characters to implement by derived classes. More...

void	openRoute (const SUMOSAXAttributes &attrs)

void	openRouteDistribution (const SUMOSAXAttributes &attrs)

void	openVehicleTypeDistribution (const SUMOSAXAttributes &attrs)

void	parseFromViaTo (std::string element, const SUMOSAXAttributes &attrs)
	Called for parsing from and to and the corresponding taz attributes. More...

bool	parseStop (SUMOVehicleParameter::Stop &stop, const SUMOSAXAttributes &attrs, std::string errorSuffix, MsgHandler *const errorOutput)
	parses attributes common to all stops More...

double	parseWalkPos (SumoXMLAttr attr, const std::string &id, const MSEdge *edge, const std::string &val)

void	parseWalkPositions (const SUMOSAXAttributes &attrs, const std::string &personID, const MSEdge fromEdge, const MSEdge &toEdge, double &departPos, double &arrivalPos, MSStoppingPlace *&bs, bool &ok)
	@ brief parse depart- and arrival positions of a walk More...

void	registerLastDepart ()
	save last depart (only to be used if vehicle is not discarded) More...

inherited from GenericSAXHandler
void	myStartElement (int element, const SUMOSAXAttributes &attrs)
	Called on the opening of a tag;. More...

void	myEndElement (int element)
	Called when a closing tag occurs. More...

Protected Attributes
MSTransportable::MSTransportablePlan *	myActiveContainerPlan
	The plan of the current container. More...

MSTransportable::MSTransportablePlan *	myActivePlan
	The plan of the current person. More...

ConstMSEdgeVector	myActiveRoute
	The current route. More...

const RGBColor *	myActiveRouteColor
	The currently parsed route's color. More...

std::string	myActiveRouteID
	The id of the current route. More...

double	myActiveRouteProbability
	The probability of the current route. More...

std::string	myActiveRouteRefID
	The id of the route the current route references to. More...

std::vector< SUMOVehicleParameter::Stop >	myActiveRouteStops
	List of the stops on the parsed route. More...

bool	myAddVehiclesDirectly
	Information whether vehicles shall be directly added to the network or kept within the buffer. More...

bool	myAmLoadingState
	whether a state file is being loaded More...

SUMOTime	myBeginDefault
	The default value for flow begins. More...

double	myCurrentCosts
	The currently parsed route costs. More...

RandomDistributor< const MSRoute * > *	myCurrentRouteDistribution
	The currently parsed distribution of routes (probability->route) More...

std::string	myCurrentRouteDistributionID
	The id of the currently parsed route distribution. More...

SUMOVTypeParameter *	myCurrentVType
	The currently parsed vehicle type. More...

RandomDistributor< MSVehicleType * > *	myCurrentVTypeDistribution
	The currently parsed distribution of vehicle types (probability->vehicle type) More...

std::string	myCurrentVTypeDistributionID
	The id of the currently parsed vehicle type distribution. More...

SUMOTime	myEndDefault
	The default value for flow ends. More...

SUMOTime	myFirstDepart
	the first read departure time More...

IDSupplier	myIdSupplier
	generates numerical ids More...

int	myInsertStopEdgesAt
	where stop edges can be inserted into the current route (-1 means no insertion) More...

SUMOTime	myLastDepart
	The insertion time of the vehicle read last. More...

SUMOVehicleParameter *	myVehicleParameter
	Parameter of the current vehicle, trip, person, container or flow. More...

Static Protected Attributes
static MTRand	myParsingRNG
	A random number generator used to choose from vtype/route distributions and computing the speed factors. More...

Private Member Functions
	MSStateHandler (const MSStateHandler &s)
	Invalidated copy constructor. More...

MSStateHandler &	operator= (const MSStateHandler &s)
	Invalidated assignment operator. More...

Private Attributes
SUMOSAXAttributes *	myAttrs
	cached attrs (used when loading vehicles) More...

std::vector< SUMOSAXAttributes * >	myDeviceAttrs
	cached device attrs (used when loading vehicles) More...

std::pair< int, int >	myEdgeAndLane

Parameterised *	myLastParameterised
	the last object that potentially carries parameters More...

const SUMOTime	myOffset

int	myQueIndex

MESegment *	mySegment

SUMOTime	myTime

std::set< std::string >	myVehiclesToRemove
	vehicles that shall be removed when loading state More...

Detailed Description

Parser and output filter for routes and vehicles state saving and loading.

Definition at line 52 of file MSStateHandler.h.

Constructor & Destructor Documentation

MSStateHandler::MSStateHandler	(	const std::string &	file,
		const SUMOTime	offset
	)

standard constructor

Definition at line 60 of file MSStateHandler.cpp.

References OptionsCont::getOptions(), OptionsCont::getStringVector(), MSRouteHandler::myAmLoadingState, and myVehiclesToRemove.

MSStateHandler::~MSStateHandler ( )

virtual

standard destructor

Definition at line 73 of file MSStateHandler.cpp.

MSStateHandler::MSStateHandler ( const MSStateHandler & s )

private

Invalidated copy constructor.

Member Function Documentation

void SUMORouteHandler::addParam ( const SUMOSAXAttributes & attrs )

protectedinherited

assign arbitrary vehicle parameters

Definition at line 245 of file SUMORouteHandler.cpp.

References Parameterised::addParameter(), SUMOSAXAttributes::get(), SUMOSAXAttributes::getString(), SUMOSAXAttributes::hasAttribute(), SUMORouteHandler::myCurrentVType, SUMORouteHandler::myVehicleParameter, SUMO_ATTR_KEY, and SUMO_ATTR_VALUE.

Referenced by SUMORouteHandler::getFirstDepart(), and SUMORouteHandler::myStartElement().

void MSRouteHandler::addStop ( const SUMOSAXAttributes & attrs )

protectedvirtualinherited

Processing of a stop.

Implements SUMORouteHandler.

Definition at line 905 of file MSRouteHandler.cpp.

Referenced by MSRouteHandler::getParsingRNG().

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 188 of file GenericSAXHandler.cpp.

References GenericSAXHandler::getFileName().

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

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

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.

Todo:

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

describe characters processing in the class' head

Definition at line 171 of file GenericSAXHandler.cpp.

References TplConvert::_2str(), and GenericSAXHandler::myCharactersVector.

bool SUMORouteHandler::checkLastDepart ( )

protectedinherited

Checks whether the route file is sorted by departure time if needed.

Definition at line 74 of file SUMORouteHandler.cpp.

References SUMOVehicleParameter::depart, DEPART_GIVEN, SUMOVehicleParameter::departProcedure, SUMOVehicleParameter::id, SUMORouteHandler::myLastDepart, SUMORouteHandler::myVehicleParameter, and WRITE_WARNING.

Referenced by MSRouteHandler::closeContainer(), MSRouteHandler::closeFlow(), MSRouteHandler::closePerson(), MSRouteHandler::closeVehicle(), and SUMORouteHandler::getFirstDepart().

bool SUMORouteHandler::checkStopPos	(	double &	startPos,
		double &	endPos,
		const double	laneLength,
		const double	minLength,
		const bool	friendlyPos
	)

staticinherited

check start and end position of a stop

Definition at line 207 of file SUMORouteHandler.cpp.

Referenced by NLTriggerBuilder::addAccess(), MSRouteHandler::addStop(), RORouteHandler::addStop(), NLTriggerBuilder::parseAndBeginParkingArea(), NLTriggerBuilder::parseAndBuildChargingStation(), NLTriggerBuilder::parseAndBuildStoppingPlace(), and RONetHandler::parseStoppingPlace().

void MSRouteHandler::closeContainer ( )

protectedvirtualinherited

Ends the processing of a container.

Implements SUMORouteHandler.

Definition at line 832 of file MSRouteHandler.cpp.

References MSTransportableControl::buildContainer(), SUMORouteHandler::checkLastDepart(), GenericSAXHandler::error(), MSNet::getContainerControl(), MSNet::getInstance(), MSNet::getVehicleControl(), MSVehicleControl::getVType(), SUMOVehicleParameter::id, MSRouteHandler::myActiveContainerPlan, MSRouteHandler::myAddVehiclesDirectly, SUMORouteHandler::myVehicleParameter, SUMORouteHandler::registerLastDepart(), and SUMOVehicleParameter::vtypeid.

Referenced by MSRouteHandler::getParsingRNG().

void MSRouteHandler::closeFlow ( )

protectedvirtualinherited

Ends the processing of a flow.

Implements SUMORouteHandler.

Definition at line 859 of file MSRouteHandler.cpp.

Referenced by MSRouteHandler::getParsingRNG().

void MSRouteHandler::closePerson ( )

protectedvirtualinherited

Ends the processing of a person.

Implements SUMORouteHandler.

Definition at line 798 of file MSRouteHandler.cpp.

References MSTransportableControl::buildPerson(), SUMORouteHandler::checkLastDepart(), MSRouteHandler::deleteActivePlans(), GenericSAXHandler::error(), MSNet::getInstance(), MSNet::getPersonControl(), MSNet::getVehicleControl(), MSVehicleControl::getVType(), SUMOVehicleParameter::id, MSRouteHandler::myActivePlan, MSRouteHandler::myAddVehiclesDirectly, MSRouteHandler::myParsingRNG, SUMORouteHandler::myVehicleParameter, SUMORouteHandler::registerLastDepart(), and SUMOVehicleParameter::vtypeid.

Referenced by MSRouteHandler::getParsingRNG().

void MSRouteHandler::closeRoute ( const bool mayBeDisconnected = false )

protectedvirtualinherited

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

Implements SUMORouteHandler.

Definition at line 531 of file MSRouteHandler.cpp.

References RandomDistributor< T >::add(), MSRoute::addReference(), MSRoute::dictionary(), MSEdge::EDGEFUNCTION_DISTRICT, MSNet::getInstance(), MSGlobals::gStateLoaded, SUMOVehicleParameter::id, MSRouteHandler::myActiveRoute, SUMORouteHandler::myActiveRouteColor, SUMORouteHandler::myActiveRouteID, SUMORouteHandler::myActiveRouteProbability, SUMORouteHandler::myActiveRouteRefID, SUMORouteHandler::myActiveRouteStops, SUMORouteHandler::myCurrentCosts, MSRouteHandler::myCurrentRouteDistribution, MSRouteHandler::myParsingRNG, SUMORouteHandler::myVehicleParameter, SUMOVehicleParameter::repetitionNumber, and MSRoute::setCosts().

Referenced by MSRouteHandler::closeFlow(), MSRouteHandler::getParsingRNG(), and MSRouteHandler::myEndElement().

void MSRouteHandler::closeRouteDistribution ( )

protectedvirtualinherited

closes (ends) the building of a distribution

Implements SUMORouteHandler.

Definition at line 648 of file MSRouteHandler.cpp.

References MSRoute::dictionary(), RandomDistributor< T >::getOverallProb(), MSGlobals::gStateLoaded, MSRouteHandler::myCurrentRouteDistribution, MSRouteHandler::myCurrentRouteDistributionID, MSRouteHandler::myParsingRNG, and SUMORouteHandler::myVehicleParameter.

Referenced by MSRouteHandler::getParsingRNG().

void MSStateHandler::closeVehicle ( )

protectedvirtual

Ends the processing of a vehicle.

Reimplemented from MSRouteHandler.

Definition at line 199 of file MSStateHandler.cpp.

References MSInsertionControl::alreadyDeparted(), MSRouteHandler::closeVehicle(), SUMOVehicleParameter::depart, MSVehicleControl::discountStateLoaded(), SUMOVehicle::getDevice(), SUMOVehicle::getDevices(), MSNet::getInsertionControl(), MSNet::getInstance(), MSVehicleControl::getVehicle(), MSNet::getVehicleControl(), SUMOVehicle::hasDeparted(), SUMOVehicleParameter::id, SUMOVehicle::loadState(), myAttrs, myDeviceAttrs, myOffset, SUMORouteHandler::myVehicleParameter, myVehiclesToRemove, MSMoveReminder::NOTIFICATION_DEPARTED, MSDevice_Routing::notifyEnter(), and SUMO_ATTR_ID.

Referenced by getTime().

void MSRouteHandler::closeVehicleTypeDistribution ( )

protectedvirtualinherited

closes (ends) the building of a distribution

Implements SUMORouteHandler.

Definition at line 432 of file MSRouteHandler.cpp.

References MSNet::getInstance(), RandomDistributor< T >::getOverallProb(), MSGlobals::gStateLoaded, MSRouteHandler::myCurrentVTypeDistribution, and MSRouteHandler::myCurrentVTypeDistributionID.

Referenced by MSRouteHandler::getParsingRNG().

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 122 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.

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 occured exception to process

Exceptions

ProcessError On any call

Definition at line 207 of file GenericSAXHandler.cpp.

References GenericSAXHandler::buildErrorMessage().

Referenced by MSRouteHandler::closeContainer(), MSRouteHandler::closePerson(), NIImporter_OpenDrive::geomFromSpiral(), MSRouteHandler::myStartElement(), and MSRouteHandler::parseWalkPos().

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 occured exception to process

Definition at line 213 of file GenericSAXHandler.cpp.

References GenericSAXHandler::buildErrorMessage().

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

inherited

returns the current file name

Returns: The name of the currently processed file

Definition at line 82 of file GenericSAXHandler.cpp.

References GenericSAXHandler::myFileName.

Referenced by NLHandler::addE1Detector(), NLHandler::addE2Detector(), NLHandler::addEdgeLaneMeanData(), NLHandler::addInstantE1Detector(), ShapeHandler::addPOI(), ShapeHandler::addPoly(), NLHandler::addRouteProbeDetector(), NLHandler::addVTypeProbeDetector(), NLHandler::beginE3Detector(), GenericSAXHandler::buildErrorMessage(), PCNetProjectionLoader::load(), NILoader::loadXMLType(), NLHandler::myEndElement(), RODFDetectorHandler::myStartElement(), GUISettingsHandler::myStartElement(), SUMORouteHandler::myStartElement(), NLHandler::myStartElement(), NIImporter_OpenDrive::myStartElement(), XMLSubSys::runParser(), GenericSAXHandler::startElement(), and SUMORouteLoader::SUMORouteLoader().

SUMOTime SUMORouteHandler::getFirstDepart ( ) const

inlineinherited

SUMOTime SUMORouteHandler::getLastDepart ( ) const

inherited

Returns the last loaded depart time.

Definition at line 68 of file SUMORouteHandler.cpp.

References SUMORouteHandler::myLastDepart.

Referenced by SUMORouteLoader::loadUntil().

static MTRand* MSRouteHandler::getParsingRNG ( )

inlinestaticinherited

Definition at line 70 of file MSRouteHandler.h.

Referenced by MEVehicleControl::buildVehicle(), GUIMEVehicleControl::buildVehicle(), GUIVehicleControl::buildVehicle(), MSVehicleControl::buildVehicle(), MSVehicleControl::computeRandomDepartOffset(), MSInsertionControl::determineCandidates(), NLBuilder::loadAndRun(), and GUILoadThread::run().

SUMOTime MSStateHandler::getTime ( ) const

inline

Definition at line 66 of file MSStateHandler.h.

References closeVehicle(), myEndElement(), myStartElement(), and myTime.

Referenced by NLBuilder::build().

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 ProcessError These method may throw a ProcessError if something fails

Reimplemented in NIImporter_ITSUMO::Handler.

Definition at line 223 of file GenericSAXHandler.cpp.

Referenced by GenericSAXHandler::endElement().

void MSStateHandler::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 MSRouteHandler.

Definition at line 190 of file MSStateHandler.cpp.

References SUMORouteHandler::myCurrentVType, MSRouteHandler::myEndElement(), myLastParameterised, SUMORouteHandler::myVehicleParameter, and SUMO_TAG_PARAM.

Referenced by getTime().

void MSStateHandler::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 MSRouteHandler.

Definition at line 105 of file MSStateHandler.cpp.

References TplConvert::_2long(), Parameterised::addParameter(), SUMOSAXAttributes::clone(), SUMOSAXAttributes::get(), MSEdge::getAllEdges(), MESegment::getEdge(), SUMOSAXAttributes::getFloat(), MSNet::getInstance(), MSVehicleTransfer::getInstance(), SUMOSAXAttributes::getInt(), MESegment::getNextSegment(), MSEdge::getNumericalID(), MELoop::getSegmentForEdge(), SUMOSAXAttributes::getString(), MSNet::getVehicleControl(), MSGlobals::gMesoNet, MSGlobals::gUseMesoSim, SUMOSAXAttributes::hasAttribute(), MSVehicleTransfer::loadState(), MESegment::loadState(), myAttrs, SUMORouteHandler::myCurrentVType, myDeviceAttrs, myEdgeAndLane, myLastParameterised, myOffset, myQueIndex, mySegment, MSRouteHandler::myStartElement(), myTime, SUMORouteHandler::myVehicleParameter, SUMOSAXAttributes::parseStringVector(), MSVehicleControl::setState(), string2time(), SUMO_ATTR_BEGIN, SUMO_ATTR_DEPART, SUMO_ATTR_END, SUMO_ATTR_KEY, SUMO_ATTR_NUMBER, SUMO_ATTR_TIME, SUMO_ATTR_VALUE, SUMO_ATTR_VERSION, SUMO_TAG_DELAY, SUMO_TAG_DEVICE, SUMO_TAG_LANE, SUMO_TAG_PARAM, SUMO_TAG_SEGMENT, SUMO_TAG_SNAPSHOT, SUMO_TAG_VEHICLE, SUMO_TAG_VEHICLETRANSFER, SUMO_TAG_VIEWSETTINGS_VEHICLES, SUMO_TAG_VTYPE, VERSION_STRING, and WRITE_WARNING.

Referenced by getTime().

void MSRouteHandler::openRoute ( const SUMOSAXAttributes & attrs )

protectedvirtualinherited

opens a route for reading

Implements SUMORouteHandler.

Definition at line 452 of file MSRouteHandler.cpp.

References DEFAULT_VEH_PROB, MSRoute::dictionary(), SUMOSAXAttributes::get(), SUMOSAXAttributes::getOpt(), RandomDistributor< T >::getProbs(), SUMOSAXAttributes::hasAttribute(), SUMOVehicleParameter::id, MSRouteHandler::myActiveRoute, SUMORouteHandler::myActiveRouteColor, SUMORouteHandler::myActiveRouteID, SUMORouteHandler::myActiveRouteProbability, SUMORouteHandler::myActiveRouteRefID, SUMORouteHandler::myCurrentCosts, MSRouteHandler::myCurrentRouteDistribution, MSRouteHandler::myCurrentRouteDistributionID, SUMORouteHandler::myInsertStopEdgesAt, MSRouteHandler::myParsingRNG, SUMORouteHandler::myVehicleParameter, MSEdge::parseEdgesList(), SUMO_ATTR_COLOR, SUMO_ATTR_COST, SUMO_ATTR_EDGES, SUMO_ATTR_ID, SUMO_ATTR_PROB, SUMO_ATTR_REFID, toString(), WRITE_ERROR, and WRITE_WARNING.

Referenced by MSRouteHandler::getParsingRNG().

void MSRouteHandler::openRouteDistribution ( const SUMOSAXAttributes & attrs )

protectedvirtualinherited

opens a route distribution for reading

Implements SUMORouteHandler.

Definition at line 601 of file MSRouteHandler.cpp.

References TplConvert::_2doubleSec(), RandomDistributor< T >::add(), MSRoute::addReference(), MSRoute::dictionary(), SUMOSAXAttributes::get(), SUMOSAXAttributes::hasAttribute(), StringTokenizer::hasNext(), SUMOVehicleParameter::id, MSRouteHandler::myCurrentRouteDistribution, MSRouteHandler::myCurrentRouteDistributionID, MSRouteHandler::myParsingRNG, SUMORouteHandler::myVehicleParameter, StringTokenizer::next(), SUMO_ATTR_ID, SUMO_ATTR_PROBS, SUMO_ATTR_ROUTES, toString(), and WRITE_WARNING.

Referenced by MSRouteHandler::getParsingRNG().

void MSRouteHandler::openVehicleTypeDistribution ( const SUMOSAXAttributes & attrs )

protectedvirtualinherited

opens a type distribution for reading

Implements SUMORouteHandler.

Definition at line 410 of file MSRouteHandler.cpp.

References RandomDistributor< T >::add(), SUMOSAXAttributes::get(), MSVehicleType::getDefaultProbability(), MSNet::getInstance(), MSNet::getVehicleControl(), MSVehicleControl::getVType(), SUMOSAXAttributes::hasAttribute(), MSRouteHandler::myCurrentVTypeDistribution, MSRouteHandler::myCurrentVTypeDistributionID, MSRouteHandler::myParsingRNG, SUMO_ATTR_ID, and SUMO_ATTR_VTYPES.

Referenced by MSRouteHandler::getParsingRNG().

MSStateHandler& MSStateHandler::operator= ( const MSStateHandler & s )

private

Invalidated assignment operator.

void MSRouteHandler::parseFromViaTo	(	std::string	element,
		const SUMOSAXAttributes &	attrs
	)

protectedinherited

Called for parsing from and to and the corresponding taz attributes.

Parameters

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

Exceptions

ProcessError If something fails

Definition at line 107 of file MSRouteHandler.cpp.

References MSEdge::dictionary(), SUMOVehicleParameter::fromTaz, OptionsCont::getBool(), MSEdge::getNumPredecessors(), MSEdge::getNumSuccessors(), SUMOSAXAttributes::getOpt(), OptionsCont::getOptions(), StringTokenizer::getVector(), SUMOSAXAttributes::hasAttribute(), SUMOVehicleParameter::id, MSRouteHandler::myActiveRoute, SUMORouteHandler::myActiveRouteID, SUMORouteHandler::myInsertStopEdgesAt, SUMORouteHandler::myVehicleParameter, MSEdge::parseEdgesList(), SUMOVehicleParameter::routeid, SUMO_ATTR_FROM, SUMO_ATTR_ROUTE, SUMO_ATTR_TO, SUMO_ATTR_VIA, SUMOVehicleParameter::toTaz, VEHPARS_FROM_TAZ_SET, VEHPARS_TO_TAZ_SET, SUMOVehicleParameter::via, SUMOVehicleParameter::wasSet(), and WRITE_WARNING.

Referenced by MSRouteHandler::getParsingRNG(), and MSRouteHandler::myStartElement().

bool SUMORouteHandler::parseStop	(	SUMOVehicleParameter::Stop &	stop,
		const SUMOSAXAttributes &	attrs,
		std::string	errorSuffix,
		MsgHandler *const	errorOutput
	)

protectedinherited

parses attributes common to all stops

Definition at line 259 of file SUMORouteHandler.cpp.

Referenced by MSRouteHandler::addStop(), RORouteHandler::addStop(), and SUMORouteHandler::getFirstDepart().

double MSRouteHandler::parseWalkPos	(	SumoXMLAttr	attr,
		const std::string &	id,
		const MSEdge *	edge,
		const std::string &	val
	)

protectedinherited

Definition at line 1103 of file MSRouteHandler.cpp.

References ARRIVAL_POS_MAX, ARRIVAL_POS_RANDOM, GenericSAXHandler::error(), MSEdge::getLength(), SUMOVehicleParameter::interpretEdgePos(), MSRouteHandler::myParsingRNG, SUMOVehicleParameter::parseArrivalPos(), MTRand::rand(), SUMO_TAG_WALK, and toString().

Referenced by MSRouteHandler::getParsingRNG(), and MSRouteHandler::parseWalkPositions().

void MSRouteHandler::parseWalkPositions	(	const SUMOSAXAttributes &	attrs,
		const std::string &	personID,
		const MSEdge *	fromEdge,
		const MSEdge *&	toEdge,
		double &	departPos,
		double &	arrivalPos,
		MSStoppingPlace *&	bs,
		bool &	ok
	)

protectedinherited

@ brief parse depart- and arrival positions of a walk

Definition at line 1057 of file MSRouteHandler.cpp.

References SUMOSAXAttributes::get(), MSStoppingPlace::getBeginLanePosition(), MSNet::getBusStop(), MSLane::getEdge(), MSStoppingPlace::getEndLanePosition(), Named::getID(), MSNet::getInstance(), MSStoppingPlace::getLane(), SUMOSAXAttributes::getOpt(), MSStoppingPlace::hasAccess(), SUMOSAXAttributes::hasAttribute(), NUMERICAL_EPS, MSRouteHandler::parseWalkPos(), SUMO_ATTR_ARRIVALPOS, SUMO_ATTR_BUS_STOP, SUMO_ATTR_DEPARTPOS, toString(), and WRITE_WARNING.

Referenced by MSRouteHandler::getParsingRNG(), and MSRouteHandler::myStartElement().

void SUMORouteHandler::registerLastDepart ( )

protectedinherited

save last depart (only to be used if vehicle is not discarded)

Definition at line 86 of file SUMORouteHandler.cpp.

References SUMOVehicleParameter::depart, DEPART_GIVEN, SUMOVehicleParameter::departProcedure, SUMOVehicleParameter::line, SUMORouteHandler::myFirstDepart, SUMORouteHandler::myLastDepart, and SUMORouteHandler::myVehicleParameter.

Referenced by MSRouteHandler::closeContainer(), RORouteHandler::closeContainer(), MSRouteHandler::closeFlow(), RORouteHandler::closeFlow(), MSRouteHandler::closePerson(), RORouteHandler::closePerson(), MSRouteHandler::closeVehicle(), RORouteHandler::closeVehicle(), and SUMORouteHandler::getFirstDepart().

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 163 of file GenericSAXHandler.cpp.

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

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

void MSStateHandler::saveState	(	const std::string &	file,
		SUMOTime	step
	)

static

Saves the current state.

Parameters

[in] file The file to write the state into

Definition at line 78 of file MSStateHandler.cpp.

References OutputDevice::close(), MSRoute::dict_saveState(), MSEdge::dictSize(), MSEdge::getAllEdges(), OutputDevice::getDevice(), MSNet::getInstance(), MSVehicleTransfer::getInstance(), MSNet::getVehicleControl(), MSGlobals::gMesoNet, MSGlobals::gUseMesoSim, MSVehicleTransfer::saveState(), MSVehicleControl::saveState(), SUMO_ATTR_TIME, SUMO_ATTR_VERSION, SUMO_TAG_SNAPSHOT, time2string(), VERSION_STRING, OutputDevice::writeAttr(), and OutputDevice::writeHeader().

Referenced by TraCIServerAPI_Simulation::processSet(), and MSNet::simulationStep().

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 76 of file GenericSAXHandler.cpp.

References GenericSAXHandler::myFileName.

Referenced by NIImporter_SUMO::_loadNetwork(), GUISettingsHandler::GUISettingsHandler(), PCNetProjectionLoader::load(), NIImporter_OpenStreetMap::load(), loadNet(), ROLoader::loadNet(), NIImporter_ITSUMO::loadNetwork(), NIImporter_MATSim::loadNetwork(), NIImporter_Vissim::loadXML(), NILoader::loadXMLType(), main(), and XMLSubSys::runParser().

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 101 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.

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 occured exception to process

Definition at line 201 of file GenericSAXHandler.cpp.

References GenericSAXHandler::buildErrorMessage(), and WRITE_WARNING.

Field Documentation

MSTransportable::MSTransportablePlan* MSRouteHandler::myActiveContainerPlan

protectedinherited

The plan of the current container.

Definition at line 160 of file MSRouteHandler.h.

Referenced by MSRouteHandler::addStop(), MSRouteHandler::closeContainer(), MSRouteHandler::deleteActivePlans(), and MSRouteHandler::myStartElement().

MSTransportable::MSTransportablePlan* MSRouteHandler::myActivePlan

protectedinherited

The plan of the current person.

Definition at line 157 of file MSRouteHandler.h.

Referenced by MSRouteHandler::addStop(), MSRouteHandler::closePerson(), MSRouteHandler::deleteActivePlans(), and MSRouteHandler::myStartElement().

ConstMSEdgeVector MSRouteHandler::myActiveRoute

protectedinherited

The current route.

Definition at line 154 of file MSRouteHandler.h.

Referenced by MSRouteHandler::addStop(), MSRouteHandler::closeRoute(), MSRouteHandler::MSRouteHandler(), MSRouteHandler::myStartElement(), MSRouteHandler::openRoute(), and MSRouteHandler::parseFromViaTo().

const RGBColor* SUMORouteHandler::myActiveRouteColor

protectedinherited

The currently parsed route's color.

Definition at line 169 of file SUMORouteHandler.h.

Referenced by MSRouteHandler::closeRoute(), RORouteHandler::closeRoute(), MSRouteHandler::openRoute(), and RORouteHandler::openRoute().

std::string SUMORouteHandler::myActiveRouteID

protectedinherited

The id of the current route.

Definition at line 160 of file SUMORouteHandler.h.

Referenced by MSRouteHandler::addStop(), RORouteHandler::addStop(), MSRouteHandler::closeFlow(), RORouteHandler::closeFlow(), MSRouteHandler::closeRoute(), RORouteHandler::closeRoute(), MSRouteHandler::closeVehicle(), MSRouteHandler::myStartElement(), SUMORouteHandler::myStartElement(), MSRouteHandler::openRoute(), RORouteHandler::openRoute(), MSRouteHandler::parseFromViaTo(), and RORouteHandler::parseFromViaTo().

double SUMORouteHandler::myActiveRouteProbability

protectedinherited

The probability of the current route.

Definition at line 166 of file SUMORouteHandler.h.

Referenced by MSRouteHandler::closeRoute(), RORouteHandler::closeRoute(), RORouteHandler::myStartElement(), MSRouteHandler::openRoute(), and RORouteHandler::openRoute().

std::string SUMORouteHandler::myActiveRouteRefID

protectedinherited

The id of the route the current route references to.

Definition at line 163 of file SUMORouteHandler.h.

Referenced by MSRouteHandler::closeRoute(), RORouteHandler::closeRoute(), MSRouteHandler::openRoute(), and RORouteHandler::openRoute().

std::vector<SUMOVehicleParameter::Stop> SUMORouteHandler::myActiveRouteStops

protectedinherited

List of the stops on the parsed route.

Definition at line 175 of file SUMORouteHandler.h.

Referenced by MSRouteHandler::addStop(), RORouteHandler::addStop(), MSRouteHandler::closeRoute(), and RORouteHandler::closeRoute().

bool MSRouteHandler::myAddVehiclesDirectly

protectedinherited

Information whether vehicles shall be directly added to the network or kept within the buffer.

Definition at line 163 of file MSRouteHandler.h.

Referenced by MSRouteHandler::closeContainer(), MSRouteHandler::closeFlow(), MSRouteHandler::closePerson(), and MSRouteHandler::closeVehicle().

bool MSRouteHandler::myAmLoadingState

protectedinherited

whether a state file is being loaded

Definition at line 178 of file MSRouteHandler.h.

Referenced by MSRouteHandler::closeVehicle(), and MSStateHandler().

SUMOSAXAttributes* MSStateHandler::myAttrs

private

cached attrs (used when loading vehicles)

Definition at line 105 of file MSStateHandler.h.

Referenced by closeVehicle(), and myStartElement().

SUMOTime SUMORouteHandler::myBeginDefault

protectedinherited

The default value for flow begins.

Definition at line 184 of file SUMORouteHandler.h.

Referenced by SUMORouteHandler::myEndElement(), and SUMORouteHandler::myStartElement().

double SUMORouteHandler::myCurrentCosts

protectedinherited

The currently parsed route costs.

Definition at line 172 of file SUMORouteHandler.h.

Referenced by MSRouteHandler::closeRoute(), RORouteHandler::closeRoute(), MSRouteHandler::openRoute(), and RORouteHandler::openRoute().

RandomDistributor<const MSRoute*>* MSRouteHandler::myCurrentRouteDistribution

protectedinherited

The currently parsed distribution of routes (probability->route)

Definition at line 172 of file MSRouteHandler.h.

Referenced by MSRouteHandler::closeRoute(), MSRouteHandler::closeRouteDistribution(), MSRouteHandler::openRoute(), and MSRouteHandler::openRouteDistribution().

std::string MSRouteHandler::myCurrentRouteDistributionID

protectedinherited

The id of the currently parsed route distribution.

Definition at line 175 of file MSRouteHandler.h.

Referenced by MSRouteHandler::closeRouteDistribution(), MSRouteHandler::openRoute(), and MSRouteHandler::openRouteDistribution().

SUMOVTypeParameter* SUMORouteHandler::myCurrentVType

protectedinherited

The currently parsed vehicle type.

Definition at line 178 of file SUMORouteHandler.h.

Referenced by SUMORouteHandler::addParam(), myEndElement(), MSRouteHandler::myEndElement(), RORouteHandler::myEndElement(), SUMORouteHandler::myEndElement(), myStartElement(), MSRouteHandler::myStartElement(), RORouteHandler::myStartElement(), SUMORouteHandler::myStartElement(), and SUMORouteHandler::~SUMORouteHandler().

RandomDistributor<MSVehicleType*>* MSRouteHandler::myCurrentVTypeDistribution

protectedinherited

The currently parsed distribution of vehicle types (probability->vehicle type)

Definition at line 166 of file MSRouteHandler.h.

Referenced by MSRouteHandler::closeVehicleTypeDistribution(), MSRouteHandler::myEndElement(), and MSRouteHandler::openVehicleTypeDistribution().

std::string MSRouteHandler::myCurrentVTypeDistributionID

protectedinherited

The id of the currently parsed vehicle type distribution.

Definition at line 169 of file MSRouteHandler.h.

Referenced by MSRouteHandler::closeVehicleTypeDistribution(), and MSRouteHandler::openVehicleTypeDistribution().

std::vector<SUMOSAXAttributes*> MSStateHandler::myDeviceAttrs

private

cached device attrs (used when loading vehicles)

Definition at line 108 of file MSStateHandler.h.

Referenced by closeVehicle(), and myStartElement().

std::pair<int, int> MSStateHandler::myEdgeAndLane

private

Definition at line 101 of file MSStateHandler.h.

Referenced by myStartElement().

SUMOTime SUMORouteHandler::myEndDefault

protectedinherited

The default value for flow ends.

Definition at line 187 of file SUMORouteHandler.h.

Referenced by SUMORouteHandler::myEndElement(), and SUMORouteHandler::myStartElement().

SUMOTime SUMORouteHandler::myFirstDepart

protectedinherited

the first read departure time

Definition at line 190 of file SUMORouteHandler.h.

Referenced by SUMORouteHandler::getFirstDepart(), and SUMORouteHandler::registerLastDepart().

IDSupplier SUMORouteHandler::myIdSupplier

protectedinherited

generates numerical ids

Definition at line 181 of file SUMORouteHandler.h.

Referenced by SUMORouteHandler::myStartElement().

int SUMORouteHandler::myInsertStopEdgesAt

protectedinherited

where stop edges can be inserted into the current route (-1 means no insertion)

Definition at line 193 of file SUMORouteHandler.h.

Referenced by MSRouteHandler::addStop(), RORouteHandler::addStop(), MSRouteHandler::closeFlow(), RORouteHandler::closeFlow(), MSRouteHandler::myEndElement(), RORouteHandler::myEndElement(), MSRouteHandler::openRoute(), RORouteHandler::openRoute(), MSRouteHandler::parseFromViaTo(), and RORouteHandler::parseFromViaTo().

SUMOTime SUMORouteHandler::myLastDepart

protectedinherited

The insertion time of the vehicle read last.

Definition at line 157 of file SUMORouteHandler.h.

Referenced by SUMORouteHandler::checkLastDepart(), SUMORouteHandler::getLastDepart(), and SUMORouteHandler::registerLastDepart().

Parameterised* MSStateHandler::myLastParameterised

private

the last object that potentially carries parameters

Definition at line 111 of file MSStateHandler.h.

Referenced by myEndElement(), and myStartElement().

const SUMOTime MSStateHandler::myOffset

private

Definition at line 98 of file MSStateHandler.h.

Referenced by closeVehicle(), and myStartElement().

MTRand MSRouteHandler::myParsingRNG

staticprotectedinherited

A random number generator used to choose from vtype/route distributions and computing the speed factors.

Definition at line 181 of file MSRouteHandler.h.

Referenced by MSRouteHandler::closeFlow(), MSRouteHandler::closePerson(), MSRouteHandler::closeRoute(), MSRouteHandler::closeRouteDistribution(), MSRouteHandler::closeVehicle(), MSRouteHandler::getParsingRNG(), MSRouteHandler::myStartElement(), MSRouteHandler::openRoute(), MSRouteHandler::openRouteDistribution(), MSRouteHandler::openVehicleTypeDistribution(), and MSRouteHandler::parseWalkPos().

int MSStateHandler::myQueIndex

private

Definition at line 102 of file MSStateHandler.h.

Referenced by myStartElement().

MESegment* MSStateHandler::mySegment

private

Definition at line 100 of file MSStateHandler.h.

Referenced by myStartElement().

SUMOTime MSStateHandler::myTime

private

Definition at line 99 of file MSStateHandler.h.

Referenced by getTime(), and myStartElement().

SUMOVehicleParameter* SUMORouteHandler::myVehicleParameter

protectedinherited

Parameter of the current vehicle, trip, person, container or flow.

Definition at line 154 of file SUMORouteHandler.h.

std::set<std::string> MSStateHandler::myVehiclesToRemove

private

vehicles that shall be removed when loading state

Definition at line 114 of file MSStateHandler.h.

Referenced by closeVehicle(), and MSStateHandler().

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Field Documentation