NBNodeCont.h

Go to the documentation of this file.

/****************************************************************************/
// Container for nodes during the netbuilding process
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright 2001-2010 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 NBNodeCont_h
#define NBNodeCont_h


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

#include <string>
#include <map>
#include <vector>
#include <set>
#include <utils/geom/Position2D.h>
#include "NBEdgeCont.h"
#include "NBJunctionLogicCont.h"
#include "NBNode.h"
#include <utils/common/UtilExceptions.h>


// ===========================================================================
// class declarations
// ===========================================================================
class NBDistrict;
class OptionsCont;
class OutputDevice;


// ===========================================================================
// class definitions
// ===========================================================================
class NBNodeCont {
public:
    NBNodeCont() throw();


    ~NBNodeCont() throw();




    bool insert(const std::string &id, const Position2D &position,
                NBDistrict *district) throw();


    bool insert(const std::string &id, const Position2D &position) throw();


    Position2D insert(const std::string &id) throw();


    bool insert(NBNode *node) throw();


    bool erase(NBNode *node) throw();


    NBNode *retrieve(const std::string &id) const throw();


    NBNode *retrieve(const Position2D &position, SUMOReal offset=0.) const throw();




    void guessTLs(OptionsCont &oc, NBTrafficLightLogicCont &tlc);


    void joinTLS(NBTrafficLightLogicCont &tlc);


    void setAsTLControlled(NBNode *node, NBTrafficLightLogicCont &tlc, std::string id="");

    void reshiftNodePositions(const SUMOReal xoff, const SUMOReal yoff);

    void computeLanes2Lanes();

    void computeLogics(const NBEdgeCont &ec, NBJunctionLogicCont &jc,
                       OptionsCont &oc);

    void sortNodesEdges(bool leftHand, const NBTypeCont &tc);

    void writeXMLInternalLinks(OutputDevice &into);
    void writeXMLInternalSuccInfos(OutputDevice &into);
    void writeXMLInternalNodes(OutputDevice &into);

    void writeXML(OutputDevice &into);

    unsigned int size() const throw() {
        return (unsigned int) myNodes.size();
    }

    void clear();

    void recheckEdges(NBDistrictCont &dc, NBTrafficLightLogicCont &tlc,
                      NBEdgeCont &ec);

    void removeIsolatedRoads(NBDistrictCont &dc, NBEdgeCont &ec, NBTrafficLightLogicCont &tc);

    void removeDummyEdges(NBDistrictCont &dc, NBEdgeCont &ec,
                          NBTrafficLightLogicCont &tc);

    std::string getFreeID();

    void computeNodeShapes(bool leftHand);

    void removeUnwishedNodes(NBDistrictCont &dc, NBEdgeCont &ec,
                             NBTrafficLightLogicCont &tlc,
                             bool removeGeometryNodes) throw();

    void guessRamps(OptionsCont &oc, NBEdgeCont &ec, NBDistrictCont &dc);

    bool savePlain(const std::string &file);


    void printBuiltNodesStatistics() const throw();


private:
    bool mayNeedOnRamp(OptionsCont &oc, NBNode *cur) const;
    bool mayNeedOffRamp(OptionsCont &oc, NBNode *cur) const;
    bool buildOnRamp(OptionsCont &oc, NBNode *cur,
                     NBEdgeCont &ec, NBDistrictCont &dc, std::vector<NBEdge*> &incremented);

    void buildOffRamp(OptionsCont &oc, NBNode *cur,
                      NBEdgeCont &ec, NBDistrictCont &dc, std::vector<NBEdge*> &incremented);

    void checkHighwayRampOrder(NBEdge *&pot_highway, NBEdge *&pot_ramp);



    void generateNodeClusters(SUMOReal maxDist, std::vector<std::set<NBNode*> >&into) const throw();


    bool shouldBeTLSControlled(const std::set<NBNode*> &c) const throw();

    int myInternalID;

    typedef std::map<std::string, NBNode*> NodeCont;

    NodeCont myNodes;

    NBNodeCont(const NBNodeCont &s);

    NBNodeCont &operator=(const NBNodeCont &s);
};


#endif

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