Eclipse SUMO - Simulation of Urban MObility
GNETractionSubstation.h
Go to the documentation of this file.
1 /****************************************************************************/
2 // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3 // Copyright (C) 2021-2024 German Aerospace Center (DLR) and others.
4 // This program and the accompanying materials are made available under the
5 // terms of the Eclipse Public License 2.0 which is available at
6 // https://www.eclipse.org/legal/epl-2.0/
7 // This Source Code may also be made available under the following Secondary
8 // Licenses when the conditions for such availability set forth in the Eclipse
9 // Public License 2.0 are satisfied: GNU General Public License, version 2
10 // or later which is available at
11 // https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
12 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
13 /****************************************************************************/
18 //
19 /****************************************************************************/
20 #pragma once
21 #include <config.h>
22 
23 #include "GNEAdditional.h"
24 
25 // ===========================================================================
26 // class definitions
27 // ===========================================================================
28 
30 
31 public:
34 
43  GNETractionSubstation(const std::string& id, GNENet* net, const Position& pos, const double voltage,
44  const double currentLimit, const Parameterised::Map& parameters);
45 
48 
53 
56 
60  void writeAdditional(OutputDevice& device) const;
61 
63  bool isAdditionalValid() const;
64 
66  std::string getAdditionalProblem() const;
67 
69  void fixAdditionalProblem();
70 
72 
75 
77  bool checkDrawMoveContour() const;
78 
80 
83 
85  void updateGeometry();
86 
89 
91  void updateCenteringBoundary(const bool updateGrid);
92 
94  void splitEdgeGeometry(const double splitPosition, const GNENetworkElement* originalElement, const GNENetworkElement* newElement, GNEUndoList* undoList);
95 
97 
100 
103  std::string getParentName() const;
104 
109  void drawGL(const GUIVisualizationSettings& s) const;
110 
112 
115 
116  /* @brief method for getting the Attribute of an XML key
117  * @param[in] key The attribute key
118  * @return string with the value associated to key
119  */
120  std::string getAttribute(SumoXMLAttr key) const;
121 
122  /* @brief method for getting the Attribute of an XML key in double format (to avoid unnecessary parse<double>(...) for certain attributes)
123  * @param[in] key The attribute key
124  * @return double with the value associated to key
125  */
126  double getAttributeDouble(SumoXMLAttr key) const;
127 
129  const Parameterised::Map& getACParametersMap() const;
130 
131  /* @brief method for setting the attribute and letting the object perform additional changes
132  * @param[in] key The attribute key
133  * @param[in] value The new value
134  * @param[in] undoList The undoList on which to register changes
135  */
136  void setAttribute(SumoXMLAttr key, const std::string& value, GNEUndoList* undoList);
137 
138  /* @brief method for checking if the key and their correspond attribute are valids
139  * @param[in] key The attribute key
140  * @param[in] value The value associated to key key
141  * @return true if the value is valid, false in other case
142  */
143  bool isValid(SumoXMLAttr key, const std::string& value);
144 
146  std::string getPopUpID() const;
147 
149  std::string getHierarchyName() const;
150 
152 
153 protected:
156 
158  double myVoltage;
159 
162 
163 private:
165  void setAttribute(SumoXMLAttr key, const std::string& value);
166 
168  void setMoveShape(const GNEMoveResult& moveResult);
169 
171  void commitMoveShape(const GNEMoveResult& moveResult, GNEUndoList* undoList);
172 
175 
178 };
SumoXMLAttr
Numbers representing SUMO-XML - attributes.
An Element which don't belong to GNENet but has influence in the simulation.
Definition: GNEAdditional.h:49
move operation
move result
A NBNetBuilder extended by visualisation and editing capabilities.
Definition: GNENet.h:42
std::string getAttribute(SumoXMLAttr key) const
Position getPositionInView() const
Returns position of additional in view.
Position myPosition
position of tractionSubstation in view
GNETractionSubstation & operator=(const GNETractionSubstation &)=delete
Invalidated assignment operator.
void splitEdgeGeometry(const double splitPosition, const GNENetworkElement *originalElement, const GNENetworkElement *newElement, GNEUndoList *undoList)
split geometry
void writeAdditional(OutputDevice &device) const
write additional element into a xml file
void updateGeometry()
update pre-computed geometry information
bool isAdditionalValid() const
check if current additional is valid to be written into XML (must be reimplemented in all detector ch...
std::string getParentName() const
Returns the name of the parent object.
void drawGL(const GUIVisualizationSettings &s) const
Draws the object.
double getAttributeDouble(SumoXMLAttr key) const
double myCurrentLimit
current limit
void commitMoveShape(const GNEMoveResult &moveResult, GNEUndoList *undoList)
commit move shape
void setMoveShape(const GNEMoveResult &moveResult)
set move shape
std::string getHierarchyName() const
get Hierarchy Name (Used in AC Hierarchy)
std::string getAdditionalProblem() const
return a string with the current additional problem (must be reimplemented in all detector children)
GNETractionSubstation(const GNETractionSubstation &)=delete
Invalidated copy constructor.
std::string getPopUpID() const
get PopPup ID (Used in AC Hierarchy)
bool checkDrawMoveContour() const
check if draw move contour (red)
const Parameterised::Map & getACParametersMap() const
get parameters map
void setAttribute(SumoXMLAttr key, const std::string &value, GNEUndoList *undoList)
method for setting the attribute and letting the object perform additional changes
void fixAdditionalProblem()
fix additional problem (must be reimplemented in all detector children)
void updateCenteringBoundary(const bool updateGrid)
update centering boundary (implies change in RTREE)
GNETractionSubstation(GNENet *net)
default Constructor
GNEMoveOperation * getMoveOperation()
get move operation
bool isValid(SumoXMLAttr key, const std::string &value)
method for checking if the key and their correspondent attribute are valids
Stores the information about how to visualize structures.
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:61
An upper class for objects with additional parameters.
Definition: Parameterised.h:41
std::map< std::string, std::string > Map
parameters map
Definition: Parameterised.h:45
A point in 2D or 3D with translation and scaling methods.
Definition: Position.h:37