A Discrete-Event Network Simulator
API
LenaFdMtFfMacSchedulerTestCase Class Reference

This system test program creates different test cases with a single eNB and several UEs, all having the same Radio Bearer specification. More...

#include "lte-test-fdmt-ff-mac-scheduler.h"

+ Inheritance diagram for LenaFdMtFfMacSchedulerTestCase:
+ Collaboration diagram for LenaFdMtFfMacSchedulerTestCase:

Public Member Functions

 LenaFdMtFfMacSchedulerTestCase (uint16_t nUser, double dist, double thrRefDl, double thrRefUl, bool errorModelEnabled)
 Constructor. More...
 
 ~LenaFdMtFfMacSchedulerTestCase () override
 
- Public Member Functions inherited from ns3::TestCase
 TestCase (const TestCase &)=delete
 
virtual ~TestCase ()
 Destructor. More...
 
std::string GetName () const
 
TestCaseoperator= (const TestCase &)=delete
 

Private Member Functions

void DoRun () override
 Implementation to actually run this TestCase. More...
 

Static Private Member Functions

static std::string BuildNameString (uint16_t nUser, double dist)
 Builds the test name string based on provided parameter values. More...
 

Private Attributes

double m_dist
 distance between the nodes More...
 
bool m_errorModelEnabled
 error model enabled? More...
 
uint16_t m_nUser
 number of UE nodes More...
 
double m_thrRefDl
 DL throughput reference. More...
 
double m_thrRefUl
 UL throughput reference. More...
 

Additional Inherited Members

- Public Types inherited from ns3::TestCase
enum  TestDuration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
 How long the test takes to execute. More...
 
- Protected Member Functions inherited from ns3::TestCase
 TestCase (std::string name)
 Constructor. More...
 
void AddTestCase (TestCase *testCase, TestDuration duration=QUICK)
 Add an individual child TestCase to this test suite. More...
 
TestCaseGetParent () const
 Get the parent of this TestCase. More...
 
bool IsStatusFailure () const
 Check if any tests failed. More...
 
bool IsStatusSuccess () const
 Check if all tests passed. More...
 
void SetDataDir (std::string directory)
 Set the data directory where reference trace files can be found. More...
 
void ReportTestFailure (std::string cond, std::string actual, std::string limit, std::string message, std::string file, int32_t line)
 Log the failure of this TestCase. More...
 
bool MustAssertOnFailure () const
 Check if this run should assert on failure. More...
 
bool MustContinueOnFailure () const
 Check if this run should continue on failure. More...
 
std::string CreateDataDirFilename (std::string filename)
 Construct the full path to a file in the data directory. More...
 
std::string CreateTempDirFilename (std::string filename)
 Construct the full path to a file in a temporary directory. More...
 

Detailed Description

This system test program creates different test cases with a single eNB and several UEs, all having the same Radio Bearer specification.

In each test case, the UEs see the same SINR from the eNB; different test cases are implemented obtained by using different SINR values and different numbers of UEs. The test consists on checking that the obtained throughput performance is consistent with the definition of maximum throughput scheduling

Definition at line 41 of file lte-test-fdmt-ff-mac-scheduler.h.

Constructor & Destructor Documentation

◆ LenaFdMtFfMacSchedulerTestCase()

LenaFdMtFfMacSchedulerTestCase::LenaFdMtFfMacSchedulerTestCase ( uint16_t  nUser,
double  dist,
double  thrRefDl,
double  thrRefUl,
bool  errorModelEnabled 
)

Constructor.

Parameters
nUsernumber of UE nodes
distdistance between nodes
thrRefDlDL throughput reference
thrRefUlUL throughput reference
errorModelEnablederror model enabled?

Definition at line 189 of file lte-test-fdmt-ff-mac-scheduler.cc.

◆ ~LenaFdMtFfMacSchedulerTestCase()

LenaFdMtFfMacSchedulerTestCase::~LenaFdMtFfMacSchedulerTestCase ( )
override

Definition at line 203 of file lte-test-fdmt-ff-mac-scheduler.cc.

Member Function Documentation

◆ BuildNameString()

std::string LenaFdMtFfMacSchedulerTestCase::BuildNameString ( uint16_t  nUser,
double  dist 
)
staticprivate

Builds the test name string based on provided parameter values.

Parameters
nUsernumber of UE nodes
distdistance between nodes
Returns
name string

Definition at line 182 of file lte-test-fdmt-ff-mac-scheduler.cc.

◆ DoRun()

void LenaFdMtFfMacSchedulerTestCase::DoRun ( )
overrideprivatevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Initialize Simulation Scenario: 1 eNB and m_nUser UEs

Check that the downlink assignment is done in a "frequency domain maximum throughput" manner

Check that the assignment is done in a "frequency domain maximum throughput" manner among users with maximum SINRs: without fading, current FD MT always assign all resources to one UE

Check that the uplink assignment is done in a "proportional fair" manner

Check that the assignment is done in a "proportional fair" manner among users with equal SINRs: the bandwidth should be distributed according to the ratio of the estimated throughput per TTI of each user; therefore equally partitioning the whole bandwidth achievable from a single users in a TTI

Implements ns3::TestCase.

Definition at line 208 of file lte-test-fdmt-ff-mac-scheduler.cc.

References ns3::LteHelper::ActivateDataRadioBearer(), ns3::LteHelper::Attach(), ns3::NodeContainer::Create(), ns3::TestCase::CreateTempDirFilename(), ns3::LteHelper::EnableMacTraces(), ns3::LteHelper::EnableRlcTraces(), ns3::NetDeviceContainer::Get(), ns3::NodeContainer::Get(), ns3::Object::GetObject(), ns3::LteEnbNetDevice::GetPhy(), ns3::LteHelper::GetRlcStats(), ns3::LteHelper::InstallEnbDevice(), ns3::LteHelper::InstallUeDevice(), m_dist, m_errorModelEnabled, m_nUser, m_thrRefDl, m_thrRefUl, third::mobility, NS_LOG_FUNCTION, NS_LOG_INFO, NS_TEST_ASSERT_MSG_EQ_TOL, ns3::Seconds(), ns3::ObjectBase::SetAttribute(), ns3::Config::SetDefault(), ns3::LteHelper::SetSchedulerAttribute(), ns3::LteHelper::SetSchedulerType(), and throughput.

+ Here is the call graph for this function:

Member Data Documentation

◆ m_dist

double LenaFdMtFfMacSchedulerTestCase::m_dist
private

distance between the nodes

Definition at line 71 of file lte-test-fdmt-ff-mac-scheduler.h.

Referenced by DoRun().

◆ m_errorModelEnabled

bool LenaFdMtFfMacSchedulerTestCase::m_errorModelEnabled
private

error model enabled?

Definition at line 74 of file lte-test-fdmt-ff-mac-scheduler.h.

Referenced by DoRun().

◆ m_nUser

uint16_t LenaFdMtFfMacSchedulerTestCase::m_nUser
private

number of UE nodes

Definition at line 70 of file lte-test-fdmt-ff-mac-scheduler.h.

Referenced by DoRun().

◆ m_thrRefDl

double LenaFdMtFfMacSchedulerTestCase::m_thrRefDl
private

DL throughput reference.

Definition at line 72 of file lte-test-fdmt-ff-mac-scheduler.h.

Referenced by DoRun().

◆ m_thrRefUl

double LenaFdMtFfMacSchedulerTestCase::m_thrRefUl
private

UL throughput reference.

Definition at line 73 of file lte-test-fdmt-ff-mac-scheduler.h.

Referenced by DoRun().


The documentation for this class was generated from the following files: