SUMO - Simulation of Urban MObility
SUMOVTypeParameter.h
Go to the documentation of this file.
1 /****************************************************************************/
2 // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.org/sumo
3 // Copyright (C) 2001-2017 German Aerospace Center (DLR) and others.
4 /****************************************************************************/
5 //
6 // This program and the accompanying materials
7 // are made available under the terms of the Eclipse Public License v2.0
8 // which accompanies this distribution, and is available at
9 // http://www.eclipse.org/legal/epl-v20.html
10 //
11 /****************************************************************************/
19 // Structure representing possible vehicle parameter
20 /****************************************************************************/
21 #ifndef SUMOVTypeParameter_h
22 #define SUMOVTypeParameter_h
23 
24 
25 // ===========================================================================
26 // included modules
27 // ===========================================================================
28 #ifdef _MSC_VER
29 #include <windows_config.h>
30 #else
31 
32 #include <config.h>
33 
34 #endif
35 
36 #include <string>
37 #include <map>
39 #include <utils/common/RGBColor.h>
40 #include <utils/common/SUMOTime.h>
43 
44 // ===========================================================================
45 // class declarations
46 // ===========================================================================
47 class OutputDevice;
48 class OptionsCont;
49 
50 
51 // ===========================================================================
52 // value definitions
53 // ===========================================================================
54 const int VTYPEPARS_LENGTH_SET = 1;
55 const int VTYPEPARS_MINGAP_SET = 1 << 1;
56 const int VTYPEPARS_MAXSPEED_SET = 1 << 2;
57 const int VTYPEPARS_PROBABILITY_SET = 1 << 3;
58 const int VTYPEPARS_SPEEDFACTOR_SET = 1 << 4;
59 const int VTYPEPARS_EMISSIONCLASS_SET = 1 << 5;
60 const int VTYPEPARS_COLOR_SET = 1 << 6;
61 const int VTYPEPARS_VEHICLECLASS_SET = 1 << 7;
62 const int VTYPEPARS_WIDTH_SET = 1 << 8;
63 const int VTYPEPARS_HEIGHT_SET = 1 << 9;
64 const int VTYPEPARS_SHAPE_SET = 1 << 10;
65 const int VTYPEPARS_OSGFILE_SET = 1 << 11;
66 const int VTYPEPARS_IMGFILE_SET = 1 << 12;
67 const int VTYPEPARS_IMPATIENCE_SET = 1 << 13;
68 const int VTYPEPARS_LANE_CHANGE_MODEL_SET = 1 << 14;
69 const int VTYPEPARS_PERSON_CAPACITY = 1 << 15;
70 const int VTYPEPARS_BOARDING_DURATION = 1 << 16;
71 const int VTYPEPARS_CONTAINER_CAPACITY = 1 << 17;
72 const int VTYPEPARS_LOADING_DURATION = 1 << 18;
73 const int VTYPEPARS_CAR_FOLLOW_MODEL = 1 << 19;
74 const int VTYPEPARS_MAXSPEED_LAT_SET = 1 << 20;
75 const int VTYPEPARS_LATALIGNMENT_SET = 1 << 21;
76 const int VTYPEPARS_MINGAP_LAT_SET = 1 << 22;
77 const int VTYPEPARS_ACTIONSTEPLENGTH_SET = 1 << 23;
78 
79 
80 // ===========================================================================
81 // struct definitions
82 // ===========================================================================
88 public:
93  SUMOVTypeParameter(const std::string& vtid, const SUMOVehicleClass vc = SVC_IGNORING);
94 
95 
100  bool wasSet(int what) const {
101  return (parametersSet & what) != 0;
102  }
103 
104 
110  void write(OutputDevice& dev) const;
111 
114  void validateCFParameter() const;
115 
116 
122  double getCFParam(const SumoXMLAttr attr, const double defaultValue) const;
123 
129  std::string getCFParamString(const SumoXMLAttr attr, const std::string defaultValue) const;
130 
136  double getLCParam(const SumoXMLAttr attr, const double defaultValue) const;
137 
143  double getJMParam(const SumoXMLAttr attr, const double defaultValue) const;
144 
145 
147  std::string id;
148 
150  double length;
152  double minGap;
154  double maxSpeed;
169  double impatience;
178 
181 
183  double width;
184 
186  double height;
187 
190 
192  std::string osgFile;
193 
195  std::string imgFile;
197 
198 
201 
203  typedef std::map<SumoXMLAttr, std::string> SubParams;
205  SubParams cfParameter;
207  SubParams lcParameter;
209  SubParams jmParameter;
210 
213 
215  double maxSpeedLat;
219  double minGapLat;
220 
223 
224 
226  mutable bool saved;
227 
229  mutable bool onlyReferenced;
230 
236  static double getDefaultAccel(const SUMOVehicleClass vc = SVC_IGNORING);
237 
243  static double getDefaultDecel(const SUMOVehicleClass vc = SVC_IGNORING);
244 
250  static double getDefaultEmergencyDecel(const SUMOVehicleClass vc = SVC_IGNORING);
251 
257  static double getDefaultImperfection(const SUMOVehicleClass vc = SVC_IGNORING);
258 
260  static const SUMOVTypeParameter& getDefault();
261 
262 };
263 
264 #endif
265 
266 /****************************************************************************/
267 
const int VTYPEPARS_MAXSPEED_SET
const int VTYPEPARS_MINGAP_SET
SumoXMLTag
Numbers representing SUMO-XML - element names.
SumoXMLTag cfModel
The enum-representation of the car-following model to use.
const int VTYPEPARS_LATALIGNMENT_SET
double getJMParam(const SumoXMLAttr attr, const double defaultValue) const
Returns the named value from the map, or the default if it is not contained there.
double impatience
The vehicle&#39;s impatience (willingness to obstruct others)
std::map< SumoXMLAttr, std::string > SubParams
sub-model parameters
SUMOVehicleClass
Definition of vehicle classes to differ between different lane usage and authority types...
SUMOVehicleShape shape
This class&#39; shape.
Structure representing possible vehicle parameter.
const int VTYPEPARS_MINGAP_LAT_SET
bool saved
Information whether this type was already saved (needed by routers)
SUMOVTypeParameter(const std::string &vtid, const SUMOVehicleClass vc=SVC_IGNORING)
Constructor.
double defaultProbability
The probability when being added to a distribution without an explicit probability.
int containerCapacity
The container capacity of the vehicle.
const int VTYPEPARS_BOARDING_DURATION
SUMOVehicleClass vehicleClass
The vehicle&#39;s class.
SumoXMLAttr
Numbers representing SUMO-XML - attributes.
const int VTYPEPARS_CAR_FOLLOW_MODEL
const int VTYPEPARS_OSGFILE_SET
const int VTYPEPARS_MAXSPEED_LAT_SET
const int VTYPEPARS_PROBABILITY_SET
LateralAlignment
Numbers representing special SUMO-XML-attribute values Information how vehicles align themselves with...
static double getDefaultAccel(const SUMOVehicleClass vc=SVC_IGNORING)
Returns the default acceleration for the given vehicle class This needs to be a function because the ...
double height
This class&#39; height.
const int VTYPEPARS_LANE_CHANGE_MODEL_SET
static double getDefaultImperfection(const SUMOVehicleClass vc=SVC_IGNORING)
Returns the default driver&#39;s imperfection (sigma or epsilon in Krauss&#39; model) for the given vehicle c...
double getLCParam(const SumoXMLAttr attr, const double defaultValue) const
Returns the named value from the map, or the default if it is not contained there.
LaneChangeModel
bool wasSet(int what) const
Returns whether the given parameter was set.
double maxSpeed
The vehicle type&#39;s maximum speed [m/s].
double width
This class&#39; width.
SUMOTime boardingDuration
The time a person needs to board the vehicle.
const int VTYPEPARS_ACTIONSTEPLENGTH_SET
std::string osgFile
3D model file for this class
int SUMOEmissionClass
std::string imgFile
Image file for this class.
void validateCFParameter() const
Validates stored car-following parameter.
static double getDefaultDecel(const SUMOVehicleClass vc=SVC_IGNORING)
Returns the default deceleration for the given vehicle class This needs to be a function because the ...
const int VTYPEPARS_LOADING_DURATION
const int VTYPEPARS_CONTAINER_CAPACITY
An upper class for objects with additional parameters.
Definition: Parameterised.h:50
bool onlyReferenced
Information whether this is a type-stub, being only referenced but not defined (needed by routers) ...
static double getDefaultEmergencyDecel(const SUMOVehicleClass vc=SVC_IGNORING)
Returns the default emergency deceleration for the given vehicle class This needs to be a function be...
const int VTYPEPARS_SPEEDFACTOR_SET
double maxSpeedLat
The vehicle type&#39;s maximum lateral speed [m/s].
double getCFParam(const SumoXMLAttr attr, const double defaultValue) const
Returns the named value from the map, or the default if it is not contained there.
int parametersSet
Information for the router which parameter were set.
int personCapacity
The person capacity of the vehicle.
double minGapLat
The vehicle type&#39;s minimum lateral gap [m].
void write(OutputDevice &dev) const
Writes the vtype.
std::string getCFParamString(const SumoXMLAttr attr, const std::string defaultValue) const
Returns the named value from the map, or the default if it is not contained there.
SUMOVehicleShape
Definition of vehicle classes to differ between different appearences.
SubParams jmParameter
Junction-model parameter.
const int VTYPEPARS_IMGFILE_SET
SubParams cfParameter
Car-following parameter.
SUMOTime loadingDuration
The time a container needs to get loaded on the vehicle.
RGBColor color
The color.
A storage for options typed value containers)
Definition: OptionsCont.h:98
std::string id
The vehicle type&#39;s id.
const int VTYPEPARS_PERSON_CAPACITY
LateralAlignment latAlignment
The vehicles desired lateral alignment.
SUMOTime actionStepLength
The vehicle type&#39;s default actionStepLength [ms], i.e. the interval between two control actions...
double minGap
This class&#39; free space in front of the vehicle itself.
const int VTYPEPARS_HEIGHT_SET
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:70
long long int SUMOTime
Definition: TraCIDefs.h:51
const int VTYPEPARS_WIDTH_SET
LaneChangeModel lcModel
The lane-change model to use.
static const SUMOVTypeParameter & getDefault()
return the default parameters, this is a function due to the http://www.parashift.com/c++-faq/static-init-order.html
const int VTYPEPARS_LENGTH_SET
const int VTYPEPARS_VEHICLECLASS_SET
const int VTYPEPARS_EMISSIONCLASS_SET
const int VTYPEPARS_COLOR_SET
Distribution_Parameterized speedFactor
The factor by which the maximum speed may deviate from the allowed max speed on the street...
const int VTYPEPARS_SHAPE_SET
double length
The physical vehicle length.
SubParams lcParameter
Lane-changing parameter.
SUMOEmissionClass emissionClass
The emission class of this vehicle.
vehicles ignoring classes
const int VTYPEPARS_IMPATIENCE_SET