GNEDemandElement.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2001-2025 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
/****************************************************************************/
// A abstract class for demand elements
/****************************************************************************/
#pragma once
#include <config.h>
 
#include <netedit/elements/GNEAttributeCarrier.h>
#include <netedit/elements/GNEHierarchicalElement.h>
#include <netedit/elements/GNEPathElement.h>
#include <utils/gui/div/GUIGeometry.h>
#include <utils/gui/globjects/GUIGlObject.h>
 
// ===========================================================================
// class declarations
// ===========================================================================
 
class SUMOVehicleParameter;
 
// ===========================================================================
// class definitions
// ===========================================================================
 
class GNEDemandElement : public GNEAttributeCarrier, public GNEHierarchicalElement, public GUIGlObject, public GNEPathElement {
 
public:
    friend class GNERouteHandler;
    friend class GNEDemandElementFlow;
    friend class GNEDemandElementPlan;
 
    enum class Problem {
        OK,                         // There is no problem
        INVALID_ELEMENT,            // Element is invalid (for example, a route without edges)
        INVALID_PATH,               // Path (route, trip... ) is not valid (i.e is empty)
        DISCONNECTED_PLAN,          // Plan element (person, containers) is not connected with the previous or next plan
        INVALID_STOPPOSITION,       // StopPosition is invalid (only used in stops over edges or lanes
        STOP_DOWNSTREAM,            // Stops don't follow their route parent
        REPEATEDROUTE_DISCONNECTED, // Repeated route is disconnected
        NO_PLANS                    // Person or container doesn't have a plan
    };
 
    GNEDemandElement(const std::string& id, GNENet* net, const std::string& filename,
                     SumoXMLTag tag, const GNEPathElement::Options pathOptions);
 
    GNEDemandElement(GNEDemandElement* demandElementParent, SumoXMLTag tag, const GNEPathElement::Options pathOptions);
 
    virtual ~GNEDemandElement();
 
 
    GNEHierarchicalElement* getHierarchicalElement() override;
 
    GUIGlObject* getGUIGlObject() override;
 
    const GUIGlObject* getGUIGlObject() const override;
 
 
    const GUIGeometry& getDemandElementGeometry();
 
    GNEDemandElement* getPreviousChildDemandElement(const GNEDemandElement* demandElement) const;
 
    GNEDemandElement* getNextChildDemandElement(const GNEDemandElement* demandElement) const;
 
    void updateDemandElementGeometry(const GNELane* lane, const double posOverLane);
 
    void updateDemandElementStackLabel(const int stack);
 
    void updateDemandElementSpreadGeometry(const GNELane* lane, const double posOverLane);
 
 
    virtual SUMOVehicleClass getVClass() const = 0;
 
    virtual const RGBColor& getColor() const = 0;
 
 
 
    virtual void writeDemandElement(OutputDevice& device) const = 0;
 
    virtual Problem isDemandElementValid() const = 0;
 
    virtual std::string getDemandElementProblem() const = 0;
 
    virtual void fixDemandElementProblem() = 0;
 
 
    virtual void openDemandElementDialog();
 
 
    virtual Position getPositionInView() const = 0;
 
    virtual void splitEdgeGeometry(const double splitPosition, const GNENetworkElement* originalElement, const GNENetworkElement* newElement, GNEUndoList* undoList) = 0;
 
    const GUIGeometry& getDemandElementGeometry() const;
 
 
 
    bool checkDrawFromContour() const override;
 
    bool checkDrawToContour() const override;
 
    bool checkDrawRelatedContour() const override;
 
    bool checkDrawOverContour() const override;
 
    bool checkDrawDeleteContour() const override;
 
    bool checkDrawDeleteContourSmall() const override;
 
    bool checkDrawSelectContour() const override;
 
    bool checkDrawMoveContour() const override;
 
 
 
    virtual GUIGLObjectPopupMenu* getPopUpMenu(GUIMainWindow& app, GUISUMOAbstractView& parent) override;
 
    GUIParameterTableWindow* getParameterWindow(GUIMainWindow& app, GUISUMOAbstractView& parent) override;
 
    bool isGLObjectLocked() const override;
 
    void markAsFrontElement() override;
 
    void deleteGLObject() override;
 
    void selectGLObject() override;
 
    void updateGLObject() override;
 
 
 
    /* @brief method for getting the Attribute of an XML key in position format
     * @param[in] key The attribute key
     * @return position with the value associated to key
     */
    Position getAttributePosition(SumoXMLAttr key) const override;
 
    /* @brief method for getting the Attribute of an XML key in positionVector format
     * @param[in] key The attribute key
     * @return positionVector with the value associated to key
     */
    PositionVector getAttributePositionVector(SumoXMLAttr key) const override;
 
 
 
    bool isPathElementSelected() const override;
 
 
    std::vector<GNEDemandElement*> getInvalidStops() const;
 
protected:
    GUIGeometry myDemandElementGeometry;
 
    GUIGeometry mySpreadGeometry;
 
    int myStackedLabelNumber;
 
    bool isValidDemandElementID(const std::string& value) const;
 
    bool isValidDemandElementID(const std::vector<SumoXMLTag>& tags, const std::string& value) const;
 
    void setDemandElementID(const std::string& newID);
 
    GNEDemandElement* getTypeParent() const;
 
    GNEDemandElement* getRouteParent() const;
 
    void drawJunctionLine(const GNEDemandElement* element) const;
 
    void drawStackLabel(const int number, const std::string& element, const Position& position, const double rotation,
                        const double width, const double length, const double exaggeration) const;
 
 
    void replaceParentEdges(const std::string& value);
 
    void replaceFirstParentLane(const std::string& value);
 
    void replaceFirstParentJunction(const std::string& value);
 
    void replaceLastParentJunction(const std::string& value);
 
    void replaceFirstParentEdge(const std::string& value);
 
    void replaceLastParentEdge(const std::string& value);
 
    void replaceFirstParentAdditional(SumoXMLTag tag, const std::string& value);
 
    void replaceLastParentAdditional(SumoXMLTag tag, const std::string& value);
 
    void replaceDemandElementParent(SumoXMLTag tag, const std::string& value, const int parentIndex);
 
 
    struct EdgeStopIndex {
 
        EdgeStopIndex(GNEEdge* edge_, GNEDemandElement* stop) :
            edge(edge_),
            stops({stop}) {}
 
        const GNEEdge* edge = nullptr;
 
        std::vector<GNEDemandElement*> stops;
 
        int stopIndex = -1;
 
    private:
        EdgeStopIndex() {}
    };
 
    std::vector<EdgeStopIndex> getEdgeStopIndex() const;
 
    RGBColor getColorByScheme(const GUIColorer& c, const SUMOVehicleParameter* parameters) const;
 
    void buildMenuCommandRouteLength(GUIGLObjectPopupMenu* ret) const;
 
    void buildMenuAddReverse(GUIGLObjectPopupMenu* ret) const;
 
private:
    virtual bool checkChildDemandElementRestriction() const;
 
    GNEDemandElement(const GNEDemandElement&) = delete;
 
    GNEDemandElement& operator=(const GNEDemandElement&) = delete;
};