SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
MSDevice.h
Go to the documentation of this file.
1 /****************************************************************************/
8 // Abstract in-vehicle device
9 /****************************************************************************/
10 // SUMO, Simulation of Urban MObility; see http://sumo-sim.org/
11 // Copyright (C) 2001-2013 DLR (http://www.dlr.de/) and contributors
12 /****************************************************************************/
13 //
14 // This file is part of SUMO.
15 // SUMO is free software: you can redistribute it and/or modify
16 // it under the terms of the GNU General Public License as published by
17 // the Free Software Foundation, either version 3 of the License, or
18 // (at your option) any later version.
19 //
20 /****************************************************************************/
21 #ifndef MSDevice_h
22 #define MSDevice_h
23 
24 
25 // ===========================================================================
26 // included modules
27 // ===========================================================================
28 #ifdef _MSC_VER
29 #include <windows_config.h>
30 #else
31 #include <config.h>
32 #endif
33 
34 #include <string>
35 #include <vector>
36 #include <map>
37 #include <set>
39 #include <utils/common/Named.h>
41 
42 
43 // ===========================================================================
44 // class declarations
45 // ===========================================================================
46 class OutputDevice;
47 class SUMOVehicle;
48 class OptionsCont;
49 
50 
51 // ===========================================================================
52 // class definitions
53 // ===========================================================================
68 class MSDevice : public MSMoveReminder, public Named {
69 public:
73  static void insertOptions(OptionsCont& oc);
74 
75 
81  static void buildVehicleDevices(SUMOVehicle& v, std::vector<MSDevice*>& into);
82 
83 
84 public:
90  MSDevice(SUMOVehicle& holder, const std::string& id) :
91  MSMoveReminder(id), Named(id), myHolder(holder) {
92  }
93 
94 
96  virtual ~MSDevice() { }
97 
98 
104  return myHolder;
105  }
106 
107 
120  virtual void generateOutput() const {
121  }
122 
123 
124 
125 protected:
128 
135  static void insertDefaultAssignmentOptions(const std::string& deviceName, const std::string& optionsTopic, OptionsCont& oc);
136 
137 
144  static bool equippedByDefaultAssignmentOptions(const OptionsCont& oc, const std::string& deviceName, SUMOVehicle& v);
146 
147 
148 
149 protected:
152 
153 
154 
155 private:
157  static std::map<std::string, std::set<std::string> > myExplicitIDs;
158 
159 
160 private:
162  MSDevice(const MSDevice&);
163 
165  MSDevice& operator=(const MSDevice&);
166 
167 };
168 
169 
170 #endif
171 
172 /****************************************************************************/
173 
virtual ~MSDevice()
Destructor.
Definition: MSDevice.h:96
SUMOVehicle & myHolder
The vehicle that stores the device.
Definition: MSDevice.h:151
static std::map< std::string, std::set< std::string > > myExplicitIDs
vehicles which explicitly carry a device, sorted by device, first
Definition: MSDevice.h:157
SUMOVehicle & getHolder() const
Returns the vehicle that holds this device.
Definition: MSDevice.h:103
static void buildVehicleDevices(SUMOVehicle &v, std::vector< MSDevice * > &into)
Build devices for the given vehicle, if needed.
Definition: MSDevice.cpp:66
Representation of a vehicle.
Definition: SUMOVehicle.h:63
static void insertDefaultAssignmentOptions(const std::string &deviceName, const std::string &optionsTopic, OptionsCont &oc)
Adds common command options that allow to assign devices to vehicles.
Definition: MSDevice.cpp:76
Something on a lane to be noticed about vehicle movement.
Base class for objects which have an id.
Definition: Named.h:45
Abstract in-vehicle device.
Definition: MSDevice.h:68
static bool equippedByDefaultAssignmentOptions(const OptionsCont &oc, const std::string &deviceName, SUMOVehicle &v)
Determines whether a vehicle should get a certain device.
Definition: MSDevice.cpp:90
A storage for options typed value containers)
Definition: OptionsCont.h:108
static void insertOptions(OptionsCont &oc)
Inserts options for building devices.
Definition: MSDevice.cpp:58
Static storage of an output device and its base (abstract) implementation.
Definition: OutputDevice.h:70
MSDevice & operator=(const MSDevice &)
Invalidated assignment operator.
MSDevice(SUMOVehicle &holder, const std::string &id)
Constructor.
Definition: MSDevice.h:90
virtual void generateOutput() const
Called on writing tripinfo output.
Definition: MSDevice.h:120