A Discrete-Event Network Simulator
API
lte-test-pf-ff-mac-scheduler.cc
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2011, 2012 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
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: Marco Miozzo <marco.miozzo@cttc.es>
19  * Nicola Baldo <nbaldo@cttc.es>
20  */
21 
22 #include <iostream>
23 #include <sstream>
24 #include <string>
25 
26 #include <ns3/object.h>
27 #include <ns3/spectrum-interference.h>
28 #include <ns3/spectrum-error-model.h>
29 #include <ns3/log.h>
30 #include <ns3/test.h>
31 #include <ns3/simulator.h>
32 #include <ns3/packet.h>
33 #include <ns3/ptr.h>
34 #include "ns3/radio-bearer-stats-calculator.h"
35 #include <ns3/constant-position-mobility-model.h>
36 #include <ns3/eps-bearer.h>
37 #include <ns3/node-container.h>
38 #include <ns3/mobility-helper.h>
39 #include <ns3/net-device-container.h>
40 #include <ns3/lte-ue-net-device.h>
41 #include <ns3/lte-enb-net-device.h>
42 #include <ns3/lte-ue-rrc.h>
43 #include <ns3/lte-helper.h>
44 #include "ns3/string.h"
45 #include "ns3/double.h"
46 #include <ns3/lte-enb-phy.h>
47 #include <ns3/lte-ue-phy.h>
48 #include <ns3/boolean.h>
49 #include <ns3/enum.h>
50 
51 #include "lte-test-pf-ff-mac-scheduler.h"
52 
53 using namespace ns3;
54 
55 NS_LOG_COMPONENT_DEFINE ("LenaTestPfFfMacScheduler");
56 
57 LenaTestPfFfMacSchedulerSuite::LenaTestPfFfMacSchedulerSuite ()
58  : TestSuite ("lte-pf-ff-mac-scheduler", SYSTEM)
59 {
60  NS_LOG_INFO ("creating LenaTestPfFfMacSchedulerSuite");
61 
62  bool errorModel = false;
63 
64 
65  //Test Case 1: AMC works in PF
66 
67  // DOWNLINK - DISTANCE 0 -> MCS 28 -> Itbs 26 (from table 7.1.7.2.1-1 of 36.213)
68  // 1 user -> 24 PRB at Itbs 26 -> 2196 -> 2196000 bytes/sec
69  // 3 users -> 2196000 among 3 users -> 732000 bytes/sec
70  // 6 users -> 2196000 among 6 users -> 366000 bytes/sec
71  // 12 users -> 2196000 among 12 users -> 183000 bytes/sec
72  // 15 users -> 2196000 among 15 users -> 146400 bytes/sec
73  // UPLINK- DISTANCE 0 -> MCS 28 -> Itbs 26 (from table 7.1.7.2.1-1 of 36.213)
74  // 1 user -> 25 PRB at Itbs 26 -> 2292 -> 2292000 bytes/sec
75  // 3 users -> 8 PRB at Itbs 26 -> 749 -> 749000 bytes/sec
76  // 6 users -> 4 PRB at Itbs 26 -> 373 -> 373000 bytes/sec
77  // after the patch enforcing min 3 PRBs per UE:
78  // 12 users -> 3 PRB at Itbs 26 -> 277 bytes * 8/12 UE/TTI -> 184670 bytes/sec
79  // 15 users -> 3 PRB at Itbs 26 -> 277 bytes * 8/15 UE/TTI -> 147730 bytes/sec
80  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (1,0,2196000,2292000,errorModel), TestCase::EXTENSIVE);
81  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (3,0,732000,749000,errorModel), TestCase::EXTENSIVE);
82  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (6,0,366000,373000,errorModel), TestCase::EXTENSIVE);
83  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (12,0,183000,184670,errorModel), TestCase::EXTENSIVE);
84  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (15,0,146400,147730,errorModel), TestCase::EXTENSIVE);
85 
86 
87  // DOWNLINK - DISTANCE 4800 -> MCS 22 -> Itbs 20 (from table 7.1.7.2.1-1 of 36.213)
88  // 1 user -> 24 PRB at Itbs 15 -> 1383 -> 1383000 bytes/sec
89  // 3 users -> 1383000 among 3 users -> 461000 bytes/sec
90  // 6 users -> 1383000 among 6 users -> 230500 bytes/sec
91  // 12 users -> 1383000 among 12 users -> 115250 bytes/sec
92  // 15 users -> 1383000 among 15 users -> 92200 bytes/sec
93  // UPLINK - DISTANCE 4800 -> MCS 14 -> Itbs 13 (from table 7.1.7.2.1-1 of 36.213)
94  // 1 user -> 25 PRB at Itbs 13 -> 807 -> 807000 bytes/sec
95  // 3 users -> 8 PRB at Itbs 13 -> 253 -> 253000 bytes/sec
96  // 6 users -> 4 PRB at Itbs 13 -> 125 -> 125000 bytes/sec
97  // after the patch enforcing min 3 PRBs per UE:
98  // 12 users -> 3 PRB at Itbs 13 -> 93 bytes * 8/12 UE/TTI -> 62000 bytes/sec
99  // 15 users -> 3 PRB at Itbs 13 -> 93 bytes * 8/15 UE/TTI -> 49600 bytes/sec
100  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (1,4800,1383000,807000,errorModel), TestCase::EXTENSIVE);
101  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (3,4800,461000,253000,errorModel), TestCase::EXTENSIVE);
102  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (6,4800,230500,125000,errorModel), TestCase::EXTENSIVE);
103  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (12,4800,115250,62000,errorModel), TestCase::EXTENSIVE);
104  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (15,4800,92200,49600,errorModel), TestCase::EXTENSIVE);
105 
106  // DOWNLINK - DISTANCE 6000 -> MCS 20 -> Itbs 18 (from table 7.1.7.2.1-1 of 36.213)
107  // 1 user -> 24 PRB at Itbs 20 -> 1191 -> 1191000 bytes/sec
108  // 3 users -> 1191000 among 3 users -> 397000 bytes/sec
109  // 6 users -> 1191000 among 6 users -> 198500 bytes/sec
110  // 12 users -> 1191000 among 12 users -> 99250 bytes/sec
111  // 15 users -> 1191000 among 15 users -> 79400 bytes/sec
112  // UPLINK - DISTANCE 6000 -> MCS 12 -> Itbs 11 (from table 7.1.7.2.1-1 of 36.213)
113  // 1 user -> 25 PRB at Itbs 11 -> 621 -> 621000 bytes/sec
114  // 3 users -> 8 PRB at Itbs 11 -> 201 -> 201000 bytes/sec
115  // 6 users -> 4 PRB at Itbs 11 -> 97 -> 97000 bytes/sec
116  // after the patch enforcing min 3 PRBs per UE:
117  // 12 users -> 3 PRB at Itbs 11 -> 73 bytes * 8/12 UE/TTI -> 48667 bytes/sec
118  // 15 users -> 3 PRB at Itbs 11 -> 73 bytes * 8/15 UE/TTI -> 38993 bytes/sec
119  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (1,6000,1191000,621000,errorModel), TestCase::EXTENSIVE);
120  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (3,6000,397000,201000,errorModel), TestCase::EXTENSIVE);
121  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (6,6000,198500,97000,errorModel), TestCase::EXTENSIVE);
122  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (12,6000,99250,48667,errorModel), TestCase::EXTENSIVE);
123  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (15,6000,79400,38993,errorModel), TestCase::EXTENSIVE);
124 
125  // DOWNLINK - DISTANCE 10000 -> MCS 14 -> Itbs 13 (from table 7.1.7.2.1-1 of 36.213)
126  // 1 user -> 24 PRB at Itbs 13 -> 871 -> 775000 bytes/sec
127  // 3 users -> 775000 among 3 users -> 258333 bytes/sec
128  // 6 users -> 775000 among 6 users -> 129167 bytes/sec
129  // 12 users -> 775000 among 12 users -> 64583 bytes/sec
130  // 15 users -> 775000 among 15 users -> 51667 bytes/sec
131  // UPLINK - DISTANCE 10000 -> MCS 8 -> Itbs 8 (from table 7.1.7.2.1-1 of 36.213)
132  // 1 user -> 24 PRB at Itbs 8 -> 437 -> 437000 bytes/sec
133  // 3 users -> 8 PRB at Itbs 8 -> 137 -> 137000 bytes/sec
134  // 6 users -> 4 PRB at Itbs 8 -> 67 -> 67000 bytes/sec
135  // after the patch enforcing min 3 PRBs per UE:
136  // 12 users -> 3 PRB at Itbs 8 -> 49 bytes * 8/12 UE/TTI -> 32667 bytes/sec
137  // 15 users -> 3 PRB at Itbs 8 -> 49 bytes * 8/15 UE/TTI -> 26133 bytes/sec
138  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (1,10000,775000,437000,errorModel), TestCase::EXTENSIVE);
139  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (3,10000,258333,137000,errorModel), TestCase::EXTENSIVE);
140  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (6,10000,129167,67000,errorModel), TestCase::EXTENSIVE);
141  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (12,10000,64583,32667,errorModel), TestCase::EXTENSIVE);
142  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (15,10000,51667,26133,errorModel), TestCase::EXTENSIVE);
143 
144  // DONWLINK - DISTANCE 20000 -> MCS 8 -> Itbs 8 (from table 7.1.7.2.1-1 of 36.213)
145  // 1 user -> 24 PRB at Itbs 8 -> 421 -> 421000 bytes/sec
146  // 3 users -> 421000 among 3 users -> 140333 bytes/sec
147  // 6 users -> 421000 among 6 users -> 70167 bytes/sec
148  // 12 users -> 421000 among 12 users -> 35083 bytes/sec
149  // 15 users -> 421000 among 15 users -> 28067 bytes/sec
150  // UPLINK - DISTANCE 20000 -> MCS 2 -> Itbs 2 (from table 7.1.7.2.1-1 of 36.213)
151  // 1 user -> 25 PRB at Itbs 2 -> 233 -> 137000 bytes/sec
152  // 3 users -> 8 PRB at Itbs 2 -> 69 -> 41000 bytes/sec
153  // 6 users -> 4 PRB at Itbs 2 -> 32 -> 22000 bytes/sec
154  // after the patch enforcing min 3 PRBs per UE:
155  // 12 users -> 3 PRB at Itbs 2 -> 26 bytes * 8/12 UE/TTI -> 12000 bytes/sec
156  // 15 users -> 3 PRB at Itbs 2 -> 26 bytes * 8/15 UE/TTI -> 9600 bytes/sec
157  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (1,20000,421000,137000,errorModel), TestCase::EXTENSIVE);
158  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (3,20000,140333,41000,errorModel), TestCase::EXTENSIVE);
159  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (6,20000,70167,22000,errorModel), TestCase::EXTENSIVE);
160  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (12,20000,35083,12000,errorModel), TestCase::EXTENSIVE);
161  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (15,20000,28067,9600,errorModel), TestCase::EXTENSIVE);
162 
163  // DOWNLINK - DISTANCE 100000 -> CQI == 0 -> out of range -> 0 bytes/sec
164  // UPLINK - DISTANCE 100000 -> CQI == 0 -> out of range -> 0 bytes/sec
165  AddTestCase (new LenaPfFfMacSchedulerTestCase1 (1,100000,0,0,errorModel), TestCase::QUICK);
166 
167 
168  // Test Case 2: fairness check
169 
170  std::vector<double> dist;
171  dist.push_back (0); // User 0 distance --> MCS 28
172  dist.push_back (4800); // User 1 distance --> MCS 22
173  dist.push_back (6000); // User 2 distance --> MCS 16
174  dist.push_back (10000); // User 3 distance --> MCS 8
175  dist.push_back (20000); // User 4 distance --> MCS 8
176  std::vector<uint32_t> estThrPfDl;
177  estThrPfDl.push_back (90000); // User 0 estimated TTI throughput from PF
178  estThrPfDl.push_back (37000); // User 1 estimated TTI throughput from PF
179  estThrPfDl.push_back (37000); // User 2 estimated TTI throughput from PF
180  estThrPfDl.push_back (17400); // User 3 estimated TTI throughput from PF
181  estThrPfDl.push_back (17400); // User 4 estimated TTI throughput from PF
182  std::vector<uint32_t> estThrPfUl;
183  estThrPfUl.push_back (469000); // User 0 estimated TTI throughput from PF
184  estThrPfUl.push_back (157000); // User 1 estimated TTI throughput from PF
185  estThrPfUl.push_back (125000); // User 2 estimated TTI throughput from PF
186  estThrPfUl.push_back (85000); // User 3 estimated TTI throughput from PF
187  estThrPfUl.push_back (26000); // User 4 estimated TTI throughput from PF
188  AddTestCase (new LenaPfFfMacSchedulerTestCase2 (dist, estThrPfDl, estThrPfUl,errorModel), TestCase::QUICK);
189 
190 
191 }
192 
193 static LenaTestPfFfMacSchedulerSuite lenaTestPfFfMacSchedulerSuite;
194 
195 
196 // --------------- T E S T - C A S E # 1 ------------------------------
197 
198 
199 std::string
200 LenaPfFfMacSchedulerTestCase1::BuildNameString (uint16_t nUser, double dist)
201 {
202  std::ostringstream oss;
203  oss << nUser << " UEs, distance " << dist << " m";
204  return oss.str ();
205 }
206 
207 LenaPfFfMacSchedulerTestCase1::LenaPfFfMacSchedulerTestCase1 (uint16_t nUser, double dist, double thrRefDl, double thrRefUl, bool errorModelEnabled)
208  : TestCase (BuildNameString (nUser, dist)),
209  m_nUser (nUser),
210  m_dist (dist),
211  m_thrRefDl (thrRefDl),
212  m_thrRefUl (thrRefUl),
213  m_errorModelEnabled (errorModelEnabled)
214 {
215 }
216 
217 LenaPfFfMacSchedulerTestCase1::~LenaPfFfMacSchedulerTestCase1 ()
218 {
219 }
220 
221 void
222 LenaPfFfMacSchedulerTestCase1::DoRun (void)
223 {
224  NS_LOG_FUNCTION (this << m_nUser << m_dist);
225 
226  if (!m_errorModelEnabled)
227  {
228  Config::SetDefault ("ns3::LteSpectrumPhy::CtrlErrorModelEnabled", BooleanValue (false));
229  Config::SetDefault ("ns3::LteSpectrumPhy::DataErrorModelEnabled", BooleanValue (false));
230  }
231  Config::SetDefault ("ns3::LteHelper::UseIdealRrc", BooleanValue (true));
232 
238  Ptr<LteHelper> lteHelper = CreateObject<LteHelper> ();
239  lteHelper->SetAttribute ("PathlossModel", StringValue ("ns3::FriisSpectrumPropagationLossModel"));
240 
241  // Create Nodes: eNodeB and UE
242  NodeContainer enbNodes;
243  NodeContainer ueNodes;
244  enbNodes.Create (1);
245  ueNodes.Create (m_nUser);
246 
247  // Install Mobility Model
248  MobilityHelper mobility;
249  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
250  mobility.Install (enbNodes);
251  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
252  mobility.Install (ueNodes);
253 
254  // Create Devices and install them in the Nodes (eNB and UE)
255  NetDeviceContainer enbDevs;
256  NetDeviceContainer ueDevs;
257  lteHelper->SetSchedulerType ("ns3::PfFfMacScheduler");
258  enbDevs = lteHelper->InstallEnbDevice (enbNodes);
259  ueDevs = lteHelper->InstallUeDevice (ueNodes);
260 
261  // Attach a UE to a eNB
262  lteHelper->Attach (ueDevs, enbDevs.Get (0));
263 
264  // Activate an EPS bearer
265  enum EpsBearer::Qci q = EpsBearer::GBR_CONV_VOICE;
266  EpsBearer bearer (q);
267  lteHelper->ActivateDataRadioBearer (ueDevs, bearer);
268 
269 
270  Ptr<LteEnbNetDevice> lteEnbDev = enbDevs.Get (0)->GetObject<LteEnbNetDevice> ();
271  Ptr<LteEnbPhy> enbPhy = lteEnbDev->GetPhy ();
272  enbPhy->SetAttribute ("TxPower", DoubleValue (30.0));
273  enbPhy->SetAttribute ("NoiseFigure", DoubleValue (5.0));
274 
275  // Set UEs' position and power
276  for (int i = 0; i < m_nUser; i++)
277  {
278  Ptr<ConstantPositionMobilityModel> mm = ueNodes.Get (i)->GetObject<ConstantPositionMobilityModel> ();
279  mm->SetPosition (Vector (m_dist, 0.0, 0.0));
280  Ptr<LteUeNetDevice> lteUeDev = ueDevs.Get (i)->GetObject<LteUeNetDevice> ();
281  Ptr<LteUePhy> uePhy = lteUeDev->GetPhy ();
282  uePhy->SetAttribute ("TxPower", DoubleValue (23.0));
283  uePhy->SetAttribute ("NoiseFigure", DoubleValue (9.0));
284  }
285 
286 
287  double statsStartTime = 0.300; // need to allow for RRC connection establishment + SRS
288  double statsDuration = 0.6;
289  double tolerance = 0.1;
290  Simulator::Stop (Seconds (statsStartTime + statsDuration - 0.000001));
291 
292  lteHelper->EnableMacTraces ();
293  lteHelper->EnableRlcTraces ();
294  Ptr<RadioBearerStatsCalculator> rlcStats = lteHelper->GetRlcStats ();
295  rlcStats->SetAttribute ("StartTime", TimeValue (Seconds (statsStartTime)));
296  rlcStats->SetAttribute ("EpochDuration", TimeValue (Seconds (statsDuration)));
297 
298 
299  Simulator::Run ();
300 
304  NS_LOG_INFO ("DL - Test with " << m_nUser << " user(s) at distance " << m_dist);
305  std::vector <uint64_t> dlDataRxed;
306  for (int i = 0; i < m_nUser; i++)
307  {
308  // get the imsi
309  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
310  uint8_t lcId = 3;
311  dlDataRxed.push_back (rlcStats->GetDlRxData (imsi, lcId));
312  NS_LOG_INFO ("\tUser " << i << " imsi " << imsi << " bytes rxed " << (double)dlDataRxed.at (i) << " thr " << (double)dlDataRxed.at (i) / statsDuration << " ref " << m_thrRefDl);
313  }
320  for (int i = 0; i < m_nUser; i++)
321  {
322  NS_TEST_ASSERT_MSG_EQ_TOL ((double)dlDataRxed.at (i) / statsDuration, m_thrRefDl, m_thrRefDl * tolerance, " Unfair Throughput!");
323  }
324 
328  NS_LOG_INFO ("UL - Test with " << m_nUser << " user(s) at distance " << m_dist);
329  std::vector <uint64_t> ulDataRxed;
330  for (int i = 0; i < m_nUser; i++)
331  {
332  // get the imsi
333  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
334  // get the lcId
335  uint8_t lcId = 3;
336  ulDataRxed.push_back (rlcStats->GetUlRxData (imsi, lcId));
337  NS_LOG_INFO ("\tUser " << i << " imsi " << imsi << " bytes rxed " << (double)ulDataRxed.at (i) << " thr " << (double)ulDataRxed.at (i) / statsDuration << " ref " << m_thrRefUl);
338  }
345  for (int i = 0; i < m_nUser; i++)
346  {
347  NS_TEST_ASSERT_MSG_EQ_TOL ((double)ulDataRxed.at (i) / statsDuration, m_thrRefUl, m_thrRefUl * tolerance, " Unfair Throughput!");
348  }
349  Simulator::Destroy ();
350 
351 }
352 
353 
354 
355 // --------------- T E S T - C A S E # 2 ------------------------------
356 
357 
358 std::string
359 LenaPfFfMacSchedulerTestCase2::BuildNameString (uint16_t nUser, std::vector<double> dist)
360 {
361  std::ostringstream oss;
362  oss << "distances (m) = [ " ;
363  for (std::vector<double>::iterator it = dist.begin (); it != dist.end (); ++it)
364  {
365  oss << *it << " ";
366  }
367  oss << "]";
368  return oss.str ();
369 }
370 
371 
372 LenaPfFfMacSchedulerTestCase2::LenaPfFfMacSchedulerTestCase2 (std::vector<double> dist, std::vector<uint32_t> estThrPfDl, std::vector<uint32_t> estThrPfUl, bool errorModelEnabled)
373  : TestCase (BuildNameString (dist.size (), dist)),
374  m_nUser (dist.size ()),
375  m_dist (dist),
376  m_estThrPfDl (estThrPfDl),
377  m_estThrPfUl (estThrPfUl),
378  m_errorModelEnabled (errorModelEnabled)
379 {
380 }
381 
382 LenaPfFfMacSchedulerTestCase2::~LenaPfFfMacSchedulerTestCase2 ()
383 {
384 }
385 
386 void
387 LenaPfFfMacSchedulerTestCase2::DoRun (void)
388 {
389  NS_LOG_FUNCTION (this);
390  if (!m_errorModelEnabled)
391  {
392  Config::SetDefault ("ns3::LteSpectrumPhy::CtrlErrorModelEnabled", BooleanValue (false));
393  Config::SetDefault ("ns3::LteSpectrumPhy::DataErrorModelEnabled", BooleanValue (false));
394  }
395  Config::SetDefault ("ns3::LteHelper::UseIdealRrc", BooleanValue (false));
396 
401  Ptr<LteHelper> lteHelper = CreateObject<LteHelper> ();
402 
403  lteHelper->SetAttribute ("PathlossModel", StringValue ("ns3::FriisSpectrumPropagationLossModel"));
404 
405  // Create Nodes: eNodeB and UE
406  NodeContainer enbNodes;
407  NodeContainer ueNodes;
408  enbNodes.Create (1);
409  ueNodes.Create (m_nUser);
410 
411  // Install Mobility Model
412  MobilityHelper mobility;
413  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
414  mobility.Install (enbNodes);
415  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
416  mobility.Install (ueNodes);
417 
418  // Create Devices and install them in the Nodes (eNB and UE)
419  NetDeviceContainer enbDevs;
420  NetDeviceContainer ueDevs;
421  lteHelper->SetSchedulerType ("ns3::PfFfMacScheduler");
422  enbDevs = lteHelper->InstallEnbDevice (enbNodes);
423  ueDevs = lteHelper->InstallUeDevice (ueNodes);
424 
425  // Attach a UE to a eNB
426  lteHelper->Attach (ueDevs, enbDevs.Get (0));
427 
428  // Activate an EPS bearer
429  enum EpsBearer::Qci q = EpsBearer::GBR_CONV_VOICE;
430  EpsBearer bearer (q);
431  lteHelper->ActivateDataRadioBearer (ueDevs, bearer);
432 
433  Ptr<LteEnbNetDevice> lteEnbDev = enbDevs.Get (0)->GetObject<LteEnbNetDevice> ();
434  Ptr<LteEnbPhy> enbPhy = lteEnbDev->GetPhy ();
435  enbPhy->SetAttribute ("TxPower", DoubleValue (30.0));
436  enbPhy->SetAttribute ("NoiseFigure", DoubleValue (5.0));
437 
438  // Set UEs' position and power
439  for (int i = 0; i < m_nUser; i++)
440  {
441  Ptr<ConstantPositionMobilityModel> mm = ueNodes.Get (i)->GetObject<ConstantPositionMobilityModel> ();
442  mm->SetPosition (Vector (m_dist.at (i), 0.0, 0.0));
443  Ptr<LteUeNetDevice> lteUeDev = ueDevs.Get (i)->GetObject<LteUeNetDevice> ();
444  Ptr<LteUePhy> uePhy = lteUeDev->GetPhy ();
445  uePhy->SetAttribute ("TxPower", DoubleValue (23.0));
446  uePhy->SetAttribute ("NoiseFigure", DoubleValue (9.0));
447  }
448 
449  double statsStartTime = 0.300; // need to allow for RRC connection establishment + SRS
450  double statsDuration = 0.4;
451  double tolerance = 0.1;
452  Simulator::Stop (Seconds (statsStartTime + statsDuration - 0.000001));
453 
454  lteHelper->EnableRlcTraces ();
455  Ptr<RadioBearerStatsCalculator> rlcStats = lteHelper->GetRlcStats ();
456  rlcStats->SetAttribute ("StartTime", TimeValue (Seconds (statsStartTime)));
457  rlcStats->SetAttribute ("EpochDuration", TimeValue (Seconds (statsDuration)));
458 
459 
460  Simulator::Run ();
461 
462  NS_LOG_INFO ("DL - Test with " << m_nUser << " user(s)");
463  std::vector <uint64_t> dlDataRxed;
464  double totalData = 0;
465  double totalEstThrPf = 0;
466  for (int i = 0; i < m_nUser; i++)
467  {
468  // get the imsi
469  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
470  // get the lcId
471  uint8_t lcId = 3;
472  dlDataRxed.push_back (rlcStats->GetDlRxData (imsi, lcId));
473  totalData += (double)dlDataRxed.at (i);
474  NS_LOG_INFO ("\tUser " << i << " dist " << m_dist.at (i) << " imsi " << imsi << " bytes rxed " << (double)dlDataRxed.at (i) << " thr " << (double)dlDataRxed.at (i) / statsDuration);
475  totalEstThrPf += m_estThrPfDl.at (i);
476  }
477 
483  for (int i = 0; i < m_nUser; i++)
484  {
485  double thrRatio = (double)dlDataRxed.at (i) / totalData;
486  double estThrRatio = (double)m_estThrPfDl.at (i) / totalEstThrPf;
487  NS_LOG_INFO ("\tUser " << i << " thrRatio " << thrRatio << " estThrRatio " << estThrRatio);
488  NS_TEST_ASSERT_MSG_EQ_TOL (estThrRatio, thrRatio, tolerance, " Unfair Throughput!");
489  }
490 
495  NS_LOG_INFO ("UL - Test with " << m_nUser);
496  std::vector <uint64_t> ulDataRxed;
497  for (int i = 0; i < m_nUser; i++)
498  {
499  // get the imsi
500  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
501  // get the lcId
502  uint8_t lcId = 3;
503  ulDataRxed.push_back (rlcStats->GetUlRxData (imsi, lcId));
504  NS_LOG_INFO ("\tUser " << i << " dist " << m_dist.at (i) << " bytes rxed " << (double)ulDataRxed.at (i) << " thr " << (double)ulDataRxed.at (i) / statsDuration << " ref " << (double)m_estThrPfUl.at (i));
505  NS_TEST_ASSERT_MSG_EQ_TOL ((double)ulDataRxed.at (i) / statsDuration, (double)m_estThrPfUl.at (i), (double)m_estThrPfUl.at (i) * tolerance, " Unfair Throughput!");
506  }
507  Simulator::Destroy ();
508 
509 }
NS_LOG_FUNCTION
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
Definition: log-macros-enabled.h:213
ns3::BooleanValue
AttributeValue implementation for Boolean.
Definition: boolean.h:36
ns3::LteHelper::InstallEnbDevice
NetDeviceContainer InstallEnbDevice(NodeContainer c)
Create a set of eNodeB devices.
Definition: lte-helper.cc:484
ns3::Object::GetObject
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:459
ns3::StringValue
Hold variables of type string.
Definition: string.h:41
ns3::NetDeviceContainer::Get
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
Definition: net-device-container.cc:62
ns3::TestSuite
A suite of tests to run.
Definition: test.h:1342
ns3::LteEnbNetDevice::GetPhy
Ptr< LteEnbPhy > GetPhy(void) const
Definition: lte-enb-net-device.cc:193
ns3::ConstantPositionMobilityModel
Mobility model for which the current position does not change once it has been set and until it is se...
Definition: constant-position-mobility-model.h:32
ns3::LteHelper::Attach
void Attach(NetDeviceContainer ueDevices)
Enables automatic attachment of a set of UE devices to a suitable cell using Idle mode initial cell s...
Definition: lte-helper.cc:943
NS_LOG_COMPONENT_DEFINE
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
ns3::LteHelper::EnableRlcTraces
void EnableRlcTraces(void)
Enable trace sinks for RLC layer.
Definition: lte-helper.cc:1350
NS_LOG_INFO
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:277
lenaTestPfFfMacSchedulerSuite
static LenaTestPfFfMacSchedulerSuite lenaTestPfFfMacSchedulerSuite
Definition: lte-test-pf-ff-mac-scheduler.cc:193
ns3::TestCase
encapsulates test code
Definition: test.h:1155
LenaPfFfMacSchedulerTestCase2::LenaPfFfMacSchedulerTestCase2
LenaPfFfMacSchedulerTestCase2(std::vector< double > dist, std::vector< uint32_t > estThrPfDl, std::vector< uint32_t > estThrPfUl, bool errorModelEnabled)
Constructor.
Definition: lte-test-pf-ff-mac-scheduler.cc:372
ns3::LteHelper::ActivateDataRadioBearer
void ActivateDataRadioBearer(NetDeviceContainer ueDevices, EpsBearer bearer)
Activate a Data Radio Bearer on a given UE devices (for LTE-only simulation).
Definition: lte-helper.cc:1294
LenaPfFfMacSchedulerTestCase1::DoRun
virtual void DoRun(void)
Implementation to actually run this TestCase.
Definition: lte-test-pf-ff-mac-scheduler.cc:222
ns3::LteHelper::SetSchedulerType
void SetSchedulerType(std::string type)
Set the type of scheduler to be used by eNodeB devices.
Definition: lte-helper.cc:282
LenaPfFfMacSchedulerTestCase1::m_dist
double m_dist
the distance between nodes
Definition: lte-test-pf-ff-mac-scheduler.h:69
ns3::EpsBearer
This class contains the specification of EPS Bearers.
Definition: eps-bearer.h:71
ns3::MobilityHelper::Install
void Install(Ptr< Node > node) const
"Layout" a single node according to the current position allocator type.
Definition: mobility-helper.cc:130
third.mobility
tuple mobility
Definition: third.py:101
LenaPfFfMacSchedulerTestCase2::m_errorModelEnabled
bool m_errorModelEnabled
indicates whether the error model is enabled
Definition: lte-test-pf-ff-mac-scheduler.h:109
ns3::TimeValue
AttributeValue implementation for Time.
Definition: nstime.h:1055
ns3::TestCase::AddTestCase
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Definition: test.cc:299
ns3::RadioBearerStatsCalculator::GetDlRxData
uint64_t GetDlRxData(uint64_t imsi, uint8_t lcid)
Gets the number of received downlink data bytes.
Definition: radio-bearer-stats-calculator.cc:518
ns3::NetDeviceContainer
holds a vector of ns3::NetDevice pointers
Definition: net-device-container.h:41
LenaPfFfMacSchedulerTestCase1::m_errorModelEnabled
bool m_errorModelEnabled
whether error model is enabled
Definition: lte-test-pf-ff-mac-scheduler.h:72
NS_TEST_ASSERT_MSG_EQ_TOL
#define NS_TEST_ASSERT_MSG_EQ_TOL(actual, limit, tol, msg)
Test that actual and expected (limit) values are equal to plus or minus some tolerance and report and...
Definition: test.h:380
LenaPfFfMacSchedulerTestCase2::m_estThrPfUl
std::vector< uint32_t > m_estThrPfUl
the estimated UL throughput
Definition: lte-test-pf-ff-mac-scheduler.h:108
LenaPfFfMacSchedulerTestCase2::m_dist
std::vector< double > m_dist
the distance between nodes
Definition: lte-test-pf-ff-mac-scheduler.h:106
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
LenaPfFfMacSchedulerTestCase1::BuildNameString
static std::string BuildNameString(uint16_t nUser, double dist)
Build name string.
Definition: lte-test-pf-ff-mac-scheduler.cc:200
ns3::NodeContainer
keep track of a set of node pointers.
Definition: node-container.h:38
ns3::MobilityHelper::SetMobilityModel
void SetMobilityModel(std::string type, std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue(), std::string n8="", const AttributeValue &v8=EmptyAttributeValue(), std::string n9="", const AttributeValue &v9=EmptyAttributeValue())
Definition: mobility-helper.cc:79
ns3::MobilityModel::SetPosition
void SetPosition(const Vector &position)
Definition: mobility-model.cc:75
ns3::LteHelper::GetRlcStats
Ptr< RadioBearerStatsCalculator > GetRlcStats(void)
Definition: lte-helper.cc:1487
ns3::LteHelper::InstallUeDevice
NetDeviceContainer InstallUeDevice(NodeContainer c)
Create a set of UE devices.
Definition: lte-helper.cc:499
LenaPfFfMacSchedulerTestCase2::BuildNameString
static std::string BuildNameString(uint16_t nUser, std::vector< double > dist)
Builds the test name string based on provided parameter values.
Definition: lte-test-pf-ff-mac-scheduler.cc:359
ns3::MobilityHelper
Helper class used to assign positions and mobility models to nodes.
Definition: mobility-helper.h:42
ns3::RadioBearerStatsCalculator::GetUlRxData
uint64_t GetUlRxData(uint64_t imsi, uint8_t lcid)
Gets the number of received uplink data bytes.
Definition: radio-bearer-stats-calculator.cc:425
LenaPfFfMacSchedulerTestCase2::DoRun
virtual void DoRun(void)
Implementation to actually run this TestCase.
Definition: lte-test-pf-ff-mac-scheduler.cc:387
LenaPfFfMacSchedulerTestCase2
Lena PfFf Mac Scheduler Test Case 2.
Definition: lte-test-pf-ff-mac-scheduler.h:82
ns3::NodeContainer::Get
Ptr< Node > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
Definition: node-container.cc:88
LenaPfFfMacSchedulerTestCase1::m_thrRefUl
double m_thrRefUl
the UL throughput reference
Definition: lte-test-pf-ff-mac-scheduler.h:71
ns3::Seconds
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:993
ns3::Config::SetDefault
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:782
LenaPfFfMacSchedulerTestCase1::m_thrRefDl
double m_thrRefDl
the DL throughput reference
Definition: lte-test-pf-ff-mac-scheduler.h:70
LenaPfFfMacSchedulerTestCase2::m_estThrPfDl
std::vector< uint32_t > m_estThrPfDl
the estimated DL throughput
Definition: lte-test-pf-ff-mac-scheduler.h:107
ns3::NodeContainer::Create
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Definition: node-container.cc:93
ns3::LteHelper::EnableMacTraces
void EnableMacTraces(void)
Enable trace sinks for MAC layer.
Definition: lte-helper.cc:1444
ns3::LteUeNetDevice::GetPhy
Ptr< LteUePhy > GetPhy(void) const
Get the Phy.
Definition: lte-ue-net-device.cc:184
ns3::DoubleValue
This class can be used to hold variables of floating point type such as 'double' or 'float'...
Definition: double.h:41
ns3::ObjectBase::SetAttribute
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful.
Definition: object-base.cc:185
ns3::LteEnbNetDevice
The eNodeB device implementation.
Definition: lte-enb-net-device.h:56
ns3::EpsBearer::Qci
Qci
QoS Class Indicator.
Definition: eps-bearer.h:77
LenaPfFfMacSchedulerTestCase1
This system test program creates different test cases with a single eNB and several UEs...
Definition: lte-test-pf-ff-mac-scheduler.h:44
LenaPfFfMacSchedulerTestCase1::LenaPfFfMacSchedulerTestCase1
LenaPfFfMacSchedulerTestCase1(uint16_t nUser, double dist, double thrRefDl, double thrRefUl, bool errorModelEnabled)
Constructor.
Definition: lte-test-pf-ff-mac-scheduler.cc:207
ns3::LteUeNetDevice
The LteUeNetDevice class implements the UE net device.
Definition: lte-ue-net-device.h:57