MSJunction.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2001-2024 German Aerospace Center (DLR) and others.
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0/
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License 2.0 are satisfied: GNU General Public License, version 2
// or later which is available at
// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
/****************************************************************************/
// The base class for an intersection
/****************************************************************************/
#pragma once
#include <config.h>
 
#include <string>
#include <vector>
#include <map>
#include <utils/geom/Position.h>
#include <utils/geom/PositionVector.h>
#include <utils/common/Named.h>
#include <utils/common/Parameterised.h>
#include <utils/common/SUMOTime.h>
#include <utils/common/UtilExceptions.h>
#include <utils/xml/SUMOXMLDefinitions.h>
 
 
// ===========================================================================
// class declarations
// ===========================================================================
class MSVehicle;
class MSLink;
class MSLane;
class MSEdge;
class MSJunctionLogic;
 
typedef std::vector<MSEdge*> MSEdgeVector;
typedef std::vector<const MSEdge*> ConstMSEdgeVector;
 
 
// ===========================================================================
// class definitions
// ===========================================================================
class MSJunction : public Named, public Parameterised {
public:
    MSJunction(const std::string& id,
               SumoXMLNodeType type,
               const Position& position,
               const PositionVector& shape,
               const std::string& name);
 
 
    virtual ~MSJunction();
 
 
    virtual void postloadInit();
 
    void addSecondaryPosition(const Position& pos) {
        myPosition2 = pos;
    }
 
    const Position& getPosition(bool secondaryShape = false) const;
 
    const PositionVector& getShape() const {
        return myShape;
    }
 
    const std::string& getName() const {
        return myName;
    }
 
    virtual const std::vector<MSLink*>& getFoeLinks(const MSLink* const /*srcLink*/) const {
        return myEmptyLinks;
    }
 
    virtual const std::vector<MSLane*>& getFoeInternalLanes(const MSLink* const /*srcLink*/) const {
        return myEmptyLanes;
    }
 
    inline const ConstMSEdgeVector& getIncoming() const {
        return myIncoming;
    }
 
    int getNrOfIncomingLanes() const;
 
    inline const ConstMSEdgeVector& getOutgoing() const {
        return myOutgoing;
    }
 
    virtual const std::vector<MSLane*> getInternalLanes() const {
        return myEmptyLanes;
    }
 
    void addIncoming(MSEdge* edge) {
        myIncoming.push_back(edge);
    }
 
    void addOutgoing(MSEdge* edge) {
        myOutgoing.push_back(edge);
    }
 
    SumoXMLNodeType getType() const {
        return myType;
    }
 
    void passedJunction(const MSVehicle* vehicle);
 
    // @brief return the underlying right-of-way and conflict matrix
    virtual const MSJunctionLogic* getLogic() const {
        return nullptr;
    }
 
protected:
    SumoXMLNodeType myType;
 
    Position myPosition;
 
    Position myPosition2;
 
    PositionVector myShape;
 
    std::string myName;
 
    std::vector<MSLink*> myEmptyLinks;
    std::vector<MSLane*> myEmptyLanes;
 
 
    ConstMSEdgeVector myIncoming;
    ConstMSEdgeVector myOutgoing;
 
private:
    MSJunction(const MSJunction&) = delete;
 
    MSJunction& operator=(const MSJunction&) = delete;
 
};