NLHandler.h

Go to the documentation of this file.

/****************************************************************************/
// The XML-Handler for network loading
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright (C) 2001-2011 DLR (http://www.dlr.de/) and contributors
/****************************************************************************/
//
//   This program is free software; you can redistribute it and/or modify
//   it under the terms of the GNU General Public License as published by
//   the Free Software Foundation; either version 2 of the License, or
//   (at your option) any later version.
//
/****************************************************************************/
#ifndef NLHandler_h
#define NLHandler_h


// ===========================================================================
// included modules
// ===========================================================================
#ifdef _MSC_VER
#include <windows_config.h>
#else
#include <config.h>
#endif

#include <xercesc/sax/HandlerBase.hpp>
#include <xercesc/sax/SAXException.hpp>
#include <xercesc/sax/AttributeList.hpp>
#include <utils/common/SUMOTime.h>
#include <utils/xml/SUMOXMLDefinitions.h>
#include <microsim/MSLink.h>
#include <microsim/MSRouteHandler.h>
#include <microsim/traffic_lights/MSSimpleTrafficLightLogic.h>
#include <microsim/traffic_lights/MSActuatedTrafficLightLogic.h>
#include <microsim/MSBitSetLogic.h>
#include "NLBuilder.h"
#include "NLDiscreteEventBuilder.h"
#include "NLSucceedingLaneBuilder.h"


// ===========================================================================
// class declarations
// ===========================================================================
class NLContainer;
class NLDetectorBuilder;
class NLTriggerBuilder;
class MSTrafficLightLogic;


// ===========================================================================
// class definitions
// ===========================================================================
class NLHandler : public MSRouteHandler {
public:
    typedef std::vector<MSLane*> LaneVector;

public:
    NLHandler(const std::string& file, MSNet& net,
              NLDetectorBuilder& detBuilder, NLTriggerBuilder& triggerBuilder,
              NLEdgeControlBuilder& edgeBuilder,
              NLJunctionControlBuilder& junctionBuilder) throw();


    virtual ~NLHandler() throw();


protected:


    virtual void myStartElement(int element,
                                const SUMOSAXAttributes& attrs) throw(ProcessError);


    virtual void myEndElement(int element) throw(ProcessError);


protected:
    void addParam(const SUMOSAXAttributes& attrs);

    virtual void addE1Detector(const SUMOSAXAttributes& attrs);

    virtual void addInstantE1Detector(const SUMOSAXAttributes& attrs);

    virtual void addE2Detector(const SUMOSAXAttributes& attrs);

    void beginE3Detector(const SUMOSAXAttributes& attrs);

    void addE3Entry(const SUMOSAXAttributes& attrs);

    void addE3Exit(const SUMOSAXAttributes& attrs);

    virtual void endE3Detector();

    virtual void addVTypeProbeDetector(const SUMOSAXAttributes& attrs);

    virtual void addRouteProbeDetector(const SUMOSAXAttributes& attrs);

    virtual void addEdgeLaneMeanData(const SUMOSAXAttributes& attrs, int objecttype);

    virtual void closeEdge();


protected:
    MSNet& myNet;


private:
    void beginEdgeParsing(const SUMOSAXAttributes& attrs);

    void addLane(const SUMOSAXAttributes& attrs);

    void addPOI(const SUMOSAXAttributes& attrs);

    void addPoly(const SUMOSAXAttributes& attrs);

    void addLogicItem(const SUMOSAXAttributes& attrs);

    void addRequest(const SUMOSAXAttributes& attrs);

    void initJunctionLogic(const SUMOSAXAttributes& attrs);

    void initTrafficLightLogic(const SUMOSAXAttributes& attrs);

    void addPhase(const SUMOSAXAttributes& attrs);


    virtual void openJunction(const SUMOSAXAttributes& attrs);

    void parseLanes(const std::string& junctionID, const std::string& def, std::vector<MSLane*> &into, bool& ok);

#ifdef _MESSAGES

    void addMsgEmitter(const SUMOSAXAttributes& attrs);
#endif

    void openSucc(const SUMOSAXAttributes& attrs);

    void addSuccLane(const SUMOSAXAttributes& attrs);

    void addConnection(const SUMOSAXAttributes& attrs);

    virtual void openWAUT(const SUMOSAXAttributes& attrs);
    void addWAUTSwitch(const SUMOSAXAttributes& attrs);
    void addWAUTJunction(const SUMOSAXAttributes& attrs);

    void setLocation(const SUMOSAXAttributes& attrs);

    void addDistrict(const SUMOSAXAttributes& attrs) throw(ProcessError);


    void addDistrictEdge(const SUMOSAXAttributes& attrs, bool isSource);


    void closeWAUT();

    void closeSuccLane();

    LinkDirection parseLinkDir(const std::string& dir);

    LinkState parseLinkState(const std::string& state);

    std::pair<MSLane*, MSLane*> getLanesFromIndices(MSEdge* from, MSEdge* to, const std::string& laneIndices, bool& ok);


protected:
    NLDiscreteEventBuilder myActionBuilder;

    bool myCurrentIsInternalToSkip;


    NLDetectorBuilder& myDetectorBuilder;

    NLTriggerBuilder& myTriggerBuilder;

    NLEdgeControlBuilder& myEdgeControlBuilder;

    NLJunctionControlBuilder& myJunctionControlBuilder;

    NLSucceedingLaneBuilder mySucceedingLaneBuilder;



    std::string myCurrentDistrictID;

    bool myAmInTLLogicMode;

    std::string myCurrentWAUTID;

    Position myNetworkOffset;

    Boundary myOrigBoundary, myConvBoundary;

    bool myCurrentIsBroken;

    bool myHaveWarnedAboutDeprecatedE1, myHaveWarnedAboutDeprecatedE2,
         myHaveWarnedAboutDeprecatedE3, myHaveWarnedAboutDeprecatedDetEntry,
         myHaveWarnedAboutDeprecatedDetExit, myHaveWarnedAboutDeprecatedTimedEvent;
    bool myHaveWarnedAboutDeprecatedRowLogic, myHaveWarnedAboutDeprecatedTLLogic;
    bool myHaveWarnedAboutDeprecatedTLSTiming;
    bool myHaveWarnedAboutDeprecatedTimeThreshold,
         myHaveWarnedAboutDeprecatedSpeedThreshold,
         myHaveWarnedAboutDeprecatedJamDistThreshold;
    bool myHaveWarnedAboutDeprecatedVTypeProbe, myHaveWarnedAboutDeprecatedRouteProbe,
         myHaveWarnedAboutDeprecatedEdgeMean, myHaveWarnedAboutDeprecatedLaneMean;
    bool myHaveWarnedAboutDeprecatedVTypes, myHaveWarnedAboutDeprecatedLanes;
    bool myHaveWarnedAboutDeprecatedDistrict, myHaveWarnedAboutDeprecatedDSource, myHaveWarnedAboutDeprecatedDSink;


private:
    NLHandler(const NLHandler& s);

    NLHandler& operator=(const NLHandler& s);

};


#endif

/****************************************************************************/