A Discrete-Event Network Simulator
API
gnuplot-helper-example.cc
Go to the documentation of this file.
1/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2/*
3 * Copyright (c) 2013 University of Washington
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 * This is based on double-probe-example.cc.
19 *
20 * Author: Mitch Watrous (watrous@u.washington.edu)
21 */
22
23/*
24 * This example is designed to show the main features of an
25 * ns3::GnuplotHelper.
26 */
27
28#include <string>
29
30#include "ns3/core-module.h"
31#include "ns3/stats-module.h"
32
33using namespace ns3;
34
35NS_LOG_COMPONENT_DEFINE ("GnuplotHelperExample");
36
42class Emitter : public Object
43{
44public:
49 static TypeId GetTypeId (void);
51private:
52 void DoInitialize (void);
54 void Count (void);
55
58};
59
61
64{
65 static TypeId tid = TypeId ("ns3::Emitter")
66 .SetParent<Object> ()
67 .SetGroupName ("Stats")
68 .AddConstructor<Emitter> ()
69 .AddTraceSource ("Counter",
70 "sample counter",
72 "ns3::TracedValueCallback::Double")
73 ;
74 return tid;
75}
76
78{
79 NS_LOG_FUNCTION (this);
80 m_counter = 0;
81 m_var = CreateObject<ExponentialRandomVariable> ();
82}
83
84void
86{
87 NS_LOG_FUNCTION (this);
88 Simulator::Schedule (Seconds (m_var->GetValue ()), &Emitter::Count, this);
89}
90
91void
92Emitter::Count (void)
93{
94 NS_LOG_FUNCTION (this);
95 NS_LOG_DEBUG ("Counting at " << Simulator::Now ().As (Time::S));
96 m_counter += 1.0;
97 Simulator::Schedule (Seconds (m_var->GetValue ()), &Emitter::Count, this);
98}
99
100int main (int argc, char *argv[])
101{
102 CommandLine cmd (__FILE__);
103 cmd.Parse (argc, argv);
104
105 //
106 // This Emitter has a trace source object that will emit values at
107 // random times.
108 //
109
110 Ptr<Emitter> emitter = CreateObject<Emitter> ();
111 Names::Add ("/Names/Emitter", emitter);
112
113 //
114 // This gnuplot helper will be used to produce output used to make
115 // gnuplot plots.
116 //
117
118 // Create the gnuplot helper.
119 GnuplotHelper plotHelper;
120
121 // Configure the plot. Arguments include file prefix, plot title,
122 // x-label, y-label, and output file type
123 plotHelper.ConfigurePlot ("gnuplot-helper-example",
124 "Emitter Count vs. Time",
125 "Time (Seconds)",
126 "Emitter Count",
127 "png");
128
129 // Create a probe. Because the trace source we are interested in is
130 // of type uint32_t, we specify the type of probe to use by the first
131 // argument specifying its ns3 TypeId.
132 plotHelper.PlotProbe ("ns3::Uinteger32Probe",
133 "/Names/Emitter/Counter",
134 "Output",
135 "Emitter Count",
136 GnuplotAggregator::KEY_INSIDE);
137
138 // The Emitter object is not associated with an ns-3 node, so
139 // it won't get started automatically, so we need to do this ourselves
140 Simulator::Schedule (Seconds (0.0), &Emitter::Initialize, emitter);
141
142 Simulator::Stop (Seconds (100.0));
143 Simulator::Run ();
144 Simulator::Destroy ();
145
146 return 0;
147}
This is our test object, an object that increments counters at various times and emits one of them as...
static TypeId GetTypeId(void)
Register this type.
TracedValue< double > m_counter
Sample counter, normally this would be integer type.
void Count(void)
Counts how many time this function is called.
void DoInitialize(void)
Initialize() implementation.
Ptr< ExponentialRandomVariable > m_var
Random number generator.
static TypeId GetTypeId(void)
Register this type.
Parse command-line arguments.
Definition: command-line.h:229
double GetValue(double mean, double bound)
Get the next random value, as a double from the exponential distribution with the specified mean and ...
Helper class used to make gnuplot plots.
void ConfigurePlot(const std::string &outputFileNameWithoutExtension, const std::string &title, const std::string &xLegend, const std::string &yLegend, const std::string &terminalType="png")
void PlotProbe(const std::string &typeId, const std::string &path, const std::string &probeTraceSource, const std::string &title, enum GnuplotAggregator::KeyLocation keyLocation=GnuplotAggregator::KEY_INSIDE)
A base class which provides memory management and object aggregation.
Definition: object.h:88
void Initialize(void)
Invoke DoInitialize on all Objects aggregated to this one.
Definition: object.cc:183
a unique identifier for an interface.
Definition: type-id.h:59
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:922
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:205
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Definition: log.h:273
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:45
Time Now(void)
create an ns3::Time instance which contains the current simulation time.
Definition: simulator.cc:287
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1244
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
cmd
Definition: second.py:35