The data loader. More...

#include <ROLoader.h>

Data Structures
class	EdgeFloatTimeLineRetriever_EdgeTravelTime
	Obtains edge travel times from a weights handler and stores them within the edges. More...
class	EdgeFloatTimeLineRetriever_EdgeWeight
	Obtains edge weights from a weights handler and stores them within the edges. More...
Public Member Functions
virtual void	loadNet (RONet &toFill, ROAbstractEdgeBuilder &eb)
	Loads the network.
bool	loadWeights (RONet &net, const std::string &optionName, const std::string &measure, bool useLanes)
	Loads the net weights.
bool	makeSingleStep (SUMOTime end, RONet &net, SUMOAbstractRouter< ROEdge, ROVehicle > &router)
unsigned int	openRoutes (RONet &net)
	Builds and opens all route loaders Route loaders are derived from ROAbstractRouteDefLoader.
virtual void	processAllRoutes (SUMOTime start, SUMOTime end, RONet &net, SUMOAbstractRouter< ROEdge, ROVehicle > &router)
	Loads all routes at once This is done for all previously build route loaders.
virtual void	processRoutesStepWise (SUMOTime start, SUMOTime end, RONet &net, SUMOAbstractRouter< ROEdge, ROVehicle > &router)
	Loads routes stepwise This is done for all previously build route loaders.
	ROLoader (OptionsCont &oc, bool emptyDestinationsAllowed) throw ()
	Constructor.
virtual	~ROLoader ()
	Destructor.
Protected Types
typedef std::vector < ROAbstractRouteDefLoader * >	RouteLoaderCont
	Definition of route loader list.
Protected Member Functions
ROAbstractRouteDefLoader *	buildNamedHandler (const std::string &optionName, const std::string &file, RONet &net) throw (ProcessError)
void	destroyHandlers () throw ()
	Deletes all handlers and clears their container ("myHandler")
SUMOTime	getMinTimeStep () const throw ()
	Returns the first time step known by the built handlers.
bool	openTypedRoutes (const std::string &optionName, RONet &net) throw ()
	Opens route handler of the given type.
void	writeStats (SUMOTime time, SUMOTime start, int absNo) throw ()
Protected Attributes
bool	myEmptyDestinationsAllowed
	Information whether empty destinations are allowed.
RouteLoaderCont	myHandler
	List of route loaders.
OptionsCont &	myOptions
	Options to use.
Private Member Functions
ROLoader &	operator= (const ROLoader &src)
	Invalidated assignment operator.
	ROLoader (const ROLoader &src)
	Invalidated copy constructor.

Detailed Description

The data loader.

Loads the network and route descriptions using further classes.

Is capable to either load all routes in one step or go through them step wise.

Definition at line 62 of file ROLoader.h.

Member Typedef Documentation

typedef std::vector<ROAbstractRouteDefLoader*> ROLoader::RouteLoaderCont [protected]

Definition of route loader list.

Definition at line 217 of file ROLoader.h.

Constructor & Destructor Documentation

ROLoader::ROLoader	(	OptionsCont &	oc,
		bool	emptyDestinationsAllowed
	)		throw ()

Constructor.

Parameters:

[in]	oc	The options to use
[in]	emptyDestinationsAllowed	Whether tripdefs may be given without destinations

Todo:: Recheck usage of emptyDestinationsAllowed

Definition at line 99 of file ROLoader.cpp.

ROLoader::~ROLoader ( ) [virtual]

Destructor.

Definition at line 103 of file ROLoader.cpp.

References destroyHandlers().

ROLoader::ROLoader ( const ROLoader & src ) [private]

Invalidated copy constructor.

Member Function Documentation

ROAbstractRouteDefLoader * ROLoader::buildNamedHandler	(	const std::string &	optionName,
		const std::string &	file,
		RONet &	net
	)		throw (ProcessError) `[protected]`

Definition at line 296 of file ROLoader.cpp.

References string2time(), and SUMOReal.

void ROLoader::destroyHandlers ( ) throw () [protected]

Deletes all handlers and clears their container ("myHandler")

Definition at line 383 of file ROLoader.cpp.

References myHandler.

Referenced by openRoutes(), and ~ROLoader().

SUMOTime ROLoader::getMinTimeStep ( ) const throw () [protected]

Returns the first time step known by the built handlers.

The handlers are responsible for not adding route definitions prior to "begin"-Option's value. These priori departures must also not be reported by them whaen asking via "getLastReadTimeStep".

Returns:: The first time step of loaded routes

See also:: ROAbstractRouteDefLoader::getLastReadTimeStep

Definition at line 225 of file ROLoader.cpp.

References myHandler.

Referenced by openRoutes(), and processRoutesStepWise().

void ROLoader::loadNet	(	RONet &	toFill,
		ROAbstractEdgeBuilder &	eb
	)		`[virtual]`

Loads the network.

Definition at line 109 of file ROLoader.cpp.

References FileHelpers::exists(), OptionsCont::getString(), OptionsCont::isSet(), myOptions, PROGRESS_BEGIN_MESSAGE, PROGRESS_DONE_MESSAGE, PROGRESS_FAILED_MESSAGE, XMLSubSys::runParser(), and GenericSAXHandler::setFileName().

Referenced by initNet(), and main().

bool ROLoader::loadWeights	(	RONet &	net,
		const std::string &	optionName,
		const std::string &	measure,
		bool	useLanes
	)

Loads the net weights.

Definition at line 328 of file ROLoader.cpp.

References RONet::getEdgeMap(), OptionsCont::getStringVector(), OptionsCont::isUsableFileList(), myOptions, PROGRESS_BEGIN_MESSAGE, PROGRESS_DONE_MESSAGE, XMLSubSys::runParser(), and WRITE_MESSAGE.

Referenced by initNet().

bool ROLoader::makeSingleStep	(	SUMOTime	end,
		RONet &	net,
		SUMOAbstractRouter< ROEdge, ROVehicle > &	router
	)

Definition at line 204 of file ROLoader.cpp.

References MsgHandler::getErrorInstance(), myHandler, myOptions, RONet::saveAndRemoveRoutesUntil(), and MsgHandler::wasInformed().

Referenced by processRoutesStepWise().

unsigned int ROLoader::openRoutes ( RONet & net )

Builds and opens all route loaders Route loaders are derived from ROAbstractRouteDefLoader.

Definition at line 144 of file ROLoader.cpp.

References destroyHandlers(), OptionsCont::getBool(), getMinTimeStep(), OptionsCont::getString(), myHandler, myOptions, openTypedRoutes(), string2time(), time2string(), and WRITE_MESSAGE.

Referenced by computeRoutes().

bool ROLoader::openTypedRoutes	(	const std::string &	optionName,
		RONet &	net
	)		throw () `[protected]`

Opens route handler of the given type.

Checks whether the given option name is known, returns true if not (this means that everything's ok, though the according handler is not built).

Checks then whether the given option name is set and his value is one or a set of valid (existing) files. This is done via a call to "OptionsCont::isUsableFileList" (which generates a proper error message).

If the given files are valid, the proper instance(s) is built using "buildNamedHandler" and if this could be done, it is added to the list of route handlers to use ("myHandler")

Returns whether the wished handler(s) could be built.

Parameters: