![]() |
Eclipse SUMO - Simulation of Urban MObility
|
The main interface for loading a microsim. More...
#include <NLBuilder.h>
Data Structures | |
class | EdgeFloatTimeLineRetriever_EdgeEffort |
class | EdgeFloatTimeLineRetriever_EdgeTravelTime |
Obtains edge efforts from a weights handler and stores them within the edges. More... | |
Public Member Functions | |
virtual bool | build () |
Builds and initialises the simulation. More... | |
NLBuilder (OptionsCont &oc, MSNet &net, NLEdgeControlBuilder &eb, NLJunctionControlBuilder &jb, NLDetectorBuilder &db, NLHandler &xmlHandler) | |
Constructor. More... | |
virtual | ~NLBuilder () |
Destructor. More... | |
Static Public Member Functions | |
static MSNet * | init () |
static void | initRandomness () |
initializes all RNGs More... | |
Protected Member Functions | |
void | buildNet () |
Closes the net building process. More... | |
SUMORouteLoaderControl * | buildRouteLoaderControl (const OptionsCont &oc) |
Builds the route loader control. More... | |
bool | load (const std::string &mmlWhat, const bool isNet=false) |
Loads a described subpart form the given list of files. More... | |
Protected Attributes | |
NLDetectorBuilder & | myDetectorBuilder |
The detector control builder to use. More... | |
NLEdgeControlBuilder & | myEdgeBuilder |
The edge control builder to use. More... | |
NLJunctionControlBuilder & | myJunctionBuilder |
The junction control builder to use. More... | |
MSNet & | myNet |
The net to fill. More... | |
OptionsCont & | myOptions |
The options to get the names of the files to load and further information from. More... | |
NLHandler & | myXMLHandler |
The handler used to parse the net. More... | |
Private Member Functions | |
NLBuilder (const NLBuilder &s) | |
invalidated copy operator More... | |
NLBuilder & | operator= (const NLBuilder &s) |
invalidated assignment operator More... | |
The main interface for loading a microsim.
It is a black-box where only the options and factories must be supplied on the constructor call. An (empty) instance of the network must be supplied, too, and is filled during loading.
Definition at line 60 of file NLBuilder.h.
NLBuilder::NLBuilder | ( | OptionsCont & | oc, |
MSNet & | net, | ||
NLEdgeControlBuilder & | eb, | ||
NLJunctionControlBuilder & | jb, | ||
NLDetectorBuilder & | db, | ||
NLHandler & | xmlHandler | ||
) |
Constructor.
[in] | oc | The options to use |
[in,out] | net | The network to fill |
[in] | eb | The builder of edges to use |
[in] | jb | The builder of junctions to use |
[in] | db | The detector builder to use |
[in] | tb | The trigger builder to use |
[in] | xmlHandler | The xml handler to use |
Definition at line 105 of file NLBuilder.cpp.
|
virtual |
Destructor.
Definition at line 116 of file NLBuilder.cpp.
|
private |
invalidated copy operator
|
virtual |
Builds and initialises the simulation.
At first, the network is loaded and the built using "buildNet". If this could be done, additional information is loaded (state dump, weight files, route files, and additional files). If everything could be done, true is returned, otherwise false.
ProcessError | If something fails on network building |
Definition at line 120 of file NLBuilder.cpp.
References buildNet(), OptionsCont::getBool(), MSNet::getEdgeControl(), MsgHandler::getErrorInstance(), TraCIServer::getInstance(), MSNet::getShapeContainer(), OptionsCont::getString(), OptionsCont::getStringVector(), MSStateHandler::getTime(), MSNet::getTLSControl(), NLHandler::haveSeenAdditionalSpeedRestrictions(), NLHandler::haveSeenInternalEdge(), OptionsCont::isDefault(), OptionsCont::isSet(), OptionsCont::isUsableFileList(), load(), ShapeHandler::loadFiles(), myNet, myOptions, myXMLHandler, NLHandler::networkVersion(), PROGRESS_BEGIN_TIME_MESSAGE, PROGRESS_TIME_MESSAGE, XMLSubSys::runParser(), OptionsCont::set(), MSEdgeControl::setAdditionalRestrictions(), TraCIServer::setTargetTime(), string2time(), MSTLLogicControl::switchOffAll(), time2string(), WRITE_MESSAGE, and WRITE_WARNING.
Referenced by init(), and GUILoadThread::run().
|
protected |
Closes the net building process.
Builds the microsim-structures which belong to a MSNet using the factories filled while loading. Initialises the network using these structures by calling MSNet::closeBuilding. If an error occurs, all built structures are deleted and a ProcessError is thrown.
ProcessError | If the loaded structures could not be built |
Definition at line 280 of file NLBuilder.cpp.
References NLJunctionControlBuilder::build(), NLEdgeControlBuilder::build(), buildRouteLoaderControl(), MSFrame::buildStreams(), NLJunctionControlBuilder::buildTLLogics(), MSNet::closeBuilding(), OptionsCont::getIntVector(), OptionsCont::getString(), OptionsCont::getStringVector(), NLHandler::haveSeenInternalEdge(), NLHandler::haveSeenNeighs(), OptionsCont::isSet(), NLHandler::lefthand(), myEdgeBuilder, myJunctionBuilder, myNet, myOptions, myXMLHandler, NLHandler::networkVersion(), MSJunctionControl::postloadInitContainer(), TIME2STEPS, time2string(), and WRITE_ERROR.
Referenced by build().
|
protected |
Builds the route loader control.
Goes through the list of route files to open defined in the option "route-files" and builds loaders reading these files
[in] | oc | The options to read the list of route files to open from |
ProcessError | If an error occurred |
Definition at line 351 of file NLBuilder.cpp.
References SUMORouteLoaderControl::add(), OptionsCont::getString(), OptionsCont::getStringVector(), FileHelpers::isReadable(), OptionsCont::isSet(), and string2time().
Referenced by buildNet().
|
static |
loads the net, additional routes and the detectors
Definition at line 219 of file NLBuilder.cpp.
References build(), MSFrame::checkOptions(), MsgHandler::clear(), OptionsCont::clear(), SystemFrame::close(), MsgHandlerSynchronized::create(), MSFrame::fillOptions(), OptionsIO::getArgC(), MsgHandler::getErrorInstance(), OptionsCont::getInt(), MsgHandler::getMessageInstance(), OptionsCont::getOptions(), OptionsIO::getOptions(), OptionsCont::getString(), MsgHandler::getWarningInstance(), MSGlobals::gUseMesoSim, MsgHandler::initOutputOptions(), initRandomness(), MSNet::loadRoutes(), TraCIServer::openSocket(), OptionsCont::processMetaOptions(), MsgHandler::setFactory(), NLTriggerBuilder::setHandler(), MSFrame::setMSGlobals(), and XMLSubSys::setValidation().
Referenced by libsumo::Simulation::load(), and main().
|
static |
initializes all RNGs
Definition at line 271 of file NLBuilder.cpp.
References MSDevice::getEquipmentRNG(), OptionsCont::getOptions(), MSRouteHandler::getParsingRNG(), OUProcess::getRNG(), RandHelper::initRandGlobal(), and MSLane::initRNGs().
Referenced by init(), and GUILoadThread::run().
|
protected |
Loads a described subpart form the given list of files.
Assuming the given string to be an option name behind which a list of files is stored, this method invokes an XML reader on all the files set for this option.
[in] | mmlWhat | The option to get the file list from |
[in] | isNet | whether a network gets loaded |
Definition at line 333 of file NLBuilder.cpp.
References OptionsCont::getStringVector(), OptionsCont::isUsableFileList(), myOptions, myXMLHandler, PROGRESS_BEGIN_TIME_MESSAGE, PROGRESS_TIME_MESSAGE, XMLSubSys::runParser(), and WRITE_MESSAGE.
Referenced by build().
|
protected |
The detector control builder to use.
Definition at line 213 of file NLBuilder.h.
|
protected |
The edge control builder to use.
Definition at line 207 of file NLBuilder.h.
Referenced by buildNet().
|
protected |
The junction control builder to use.
Definition at line 210 of file NLBuilder.h.
Referenced by buildNet().
|
protected |
The net to fill.
Definition at line 216 of file NLBuilder.h.
Referenced by NLBuilder::EdgeFloatTimeLineRetriever_EdgeTravelTime::addEdgeWeight(), build(), and buildNet().
|
protected |
The options to get the names of the files to load and further information from.
Definition at line 204 of file NLBuilder.h.
Referenced by build(), buildNet(), and load().
|
protected |
The handler used to parse the net.
Definition at line 219 of file NLBuilder.h.
Referenced by build(), buildNet(), and load().