A Discrete-Event Network Simulator
API
data-calculator.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2008 Drexel University
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Joe Kopena (tjkopena@cs.drexel.edu)
19  */
20 
21 #ifndef DATA_CALCULATOR_H
22 #define DATA_CALCULATOR_H
23 
24 #include "ns3/object.h"
25 #include "ns3/nstime.h"
26 #include "ns3/simulator.h"
27 
28 namespace ns3 {
29 extern const double NaN;
30 
36 inline bool isNaN (double x) { return x != x; }
37 
38 class DataOutputCallback;
39 
47 public:
52  {
53  }
58  virtual long getCount () const = 0;
59 
64  virtual double getSum () const = 0;
65 
70  virtual double getSqrSum () const = 0;
71 
76  virtual double getMin () const = 0;
77 
82  virtual double getMax () const = 0;
83 
88  virtual double getMean () const = 0;
89 
94  virtual double getStddev () const = 0;
95 
100  virtual double getVariance () const = 0;
101 };
102 
103 //------------------------------------------------------------
104 //--------------------------------------------
111 class DataCalculator : public Object {
112 public:
113  DataCalculator();
114  virtual ~DataCalculator();
115 
120  static TypeId GetTypeId (void);
121 
126  bool GetEnabled () const;
130  void Enable ();
134  void Disable ();
139  void SetKey (const std::string key);
144  std::string GetKey () const;
145 
150  void SetContext (const std::string context);
155  std::string GetContext () const;
156 
161  virtual void Start (const Time& startTime);
166  virtual void Stop (const Time& stopTime);
167 
172  virtual void Output (DataOutputCallback &callback) const = 0;
173 
174 protected:
175  bool m_enabled;
176 
177  std::string m_key;
178  std::string m_context;
179 
180  virtual void DoDispose (void);
181 
182 private:
185 
186  // end class DataCalculator
187 };
188 
189 
190 // end namespace ns3
191 };
192 
193 
194 #endif /* DATA_CALCULATOR_H */
ns3::TypeId
a unique identifier for an interface.
Definition: type-id.h:59
ns3::StatisticalSummary
Abstract class for calculating statistical data.
Definition: data-calculator.h:46
ns3::DataOutputCallback
Callback class for the DataOutput classes.
Definition: data-output-interface.h:81
ns3::DataCalculator
Calculates data during a simulation.
Definition: data-calculator.h:111
stopTime
Time stopTime
Definition: tcp-linux-reno.cc:52
ns3::StatisticalSummary::getVariance
virtual double getVariance() const =0
Returns the variance of the (weighted) observations.
ns3::EventId
An identifier for simulation events.
Definition: event-id.h:54
ns3::DataCalculator::DoDispose
virtual void DoDispose(void)
Destructor implementation.
Definition: data-calculator.cc:59
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
ns3::DataCalculator::m_context
std::string m_context
Context value.
Definition: data-calculator.h:178
ns3::DataCalculator::~DataCalculator
virtual ~DataCalculator()
Definition: data-calculator.cc:41
ns3::DataCalculator::Disable
void Disable()
Disables DataCalculator when simulation stops.
Definition: data-calculator.cc:118
ns3::DataCalculator::SetContext
void SetContext(const std::string context)
Sets the DataCalculator context to the provided context.
Definition: data-calculator.cc:91
ns3::StatisticalSummary::getSqrSum
virtual double getSqrSum() const =0
ns3::DataCalculator::m_key
std::string m_key
Key value.
Definition: data-calculator.h:177
ns3::StatisticalSummary::getMax
virtual double getMax() const =0
Returns the maximum of the values.
ns3::DataCalculator::GetTypeId
static TypeId GetTypeId(void)
Register this type.
Definition: data-calculator.cc:48
ns3::DataCalculator::GetContext
std::string GetContext() const
Gets the DataCalculator context.
Definition: data-calculator.cc:100
startTime
double startTime
Definition: tcp-nsc-comparison.cc:45
ns3::StatisticalSummary::getCount
virtual long getCount() const =0
Returns the number of observations.
ns3::DataCalculator::GetEnabled
bool GetEnabled() const
Returns whether the DataCalculator is enabled.
Definition: data-calculator.cc:127
ns3::DataCalculator::m_enabled
bool m_enabled
Descendant classes must check & respect m_enabled!
Definition: data-calculator.h:175
ns3::Object
A base class which provides memory management and object aggregation.
Definition: object.h:88
ns3::StatisticalSummary::getStddev
virtual double getStddev() const =0
Returns the standard deviation of the (weighted) observations.
ns3::DataCalculator::Stop
virtual void Stop(const Time &stopTime)
Stops DataCalculator at a given time in the simulation.
Definition: data-calculator.cc:148
ns3::DataCalculator::Start
virtual void Start(const Time &startTime)
Starts DataCalculator at a given time in the simulation.
Definition: data-calculator.cc:137
ns3::DataCalculator::m_startEvent
EventId m_startEvent
Start event.
Definition: data-calculator.h:183
ns3::Time
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:104
ns3::DataCalculator::SetKey
void SetKey(const std::string key)
Sets the DataCalculator key to the provided key.
Definition: data-calculator.cc:72
ns3::DataCalculator::Output
virtual void Output(DataOutputCallback &callback) const =0
Outputs data based on the provided callback.
ns3::StatisticalSummary::getMean
virtual double getMean() const =0
Returns the mean of the (weighted) observations.
ns3::StatisticalSummary::~StatisticalSummary
virtual ~StatisticalSummary()
Destructor.
Definition: data-calculator.h:51
ns3::DataCalculator::m_stopEvent
EventId m_stopEvent
Stop event.
Definition: data-calculator.h:184
ns3::StatisticalSummary::getSum
virtual double getSum() const =0
ns3::StatisticalSummary::getMin
virtual double getMin() const =0
Returns the minimum of the values.
ns3::DataCalculator::Enable
void Enable()
Enables DataCalculator when simulation starts.
Definition: data-calculator.cc:109
ns3::NaN
const double NaN
Stored representation of NaN.
Definition: data-calculator.cc:31
sample-rng-plot.x
list x
Definition: sample-rng-plot.py:34
ns3::DataCalculator::DataCalculator
DataCalculator()
Definition: data-calculator.cc:35
ns3::DataCalculator::GetKey
std::string GetKey() const
Gets the DataCalculator key.
Definition: data-calculator.cc:81
ns3::isNaN
bool isNaN(double x)
true if x is NaN
Definition: data-calculator.h:36