Implements the Adaptive Modulation And Coding Scheme. More...
#include "lte-amc.h"
Public Types | |
enum | AmcModel { PiroEW2010 , MiErrorModel } |
Types of AMC model. More... | |
Public Member Functions | |
LteAmc () | |
~LteAmc () override | |
std::vector< int > | CreateCqiFeedbacks (const SpectrumValue &sinr, uint8_t rbgSize=0) |
Create a message with CQI feedback. | |
int | GetCqiFromSpectralEfficiency (double s) |
Get a proper CQI for the spectral efficiency value. | |
int | GetDlTbSizeFromMcs (int mcs, int nprb) |
Get the Transport Block Size for a selected MCS and number of PRB (table 7.1.7.2.1-1 of 36.213) | |
int | GetMcsFromCqi (int cqi) |
Get the Modulation and Coding Scheme for a CQI value. | |
double | GetSpectralEfficiencyFromCqi (int cqi) |
Get the spectral efficiency value associated to the received CQI. | |
int | GetUlTbSizeFromMcs (int mcs, int nprb) |
Get the Transport Block Size for a selected MCS and number of PRB (table 8.6.1-1 of 36.213) | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. | |
~Object () override | |
Destructor. | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. | |
void | Dispose () |
Dispose of this Object. | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. | |
bool | IsInitialized () const |
Check if the object has been initialized. | |
void | UnidirectionalAggregateObject (Ptr< Object > other) |
Aggregate an Object to another Object. | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. | |
void | Ref () const |
Increment the reference count. | |
void | Unref () const |
Decrement the reference count. | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. | |
void | GetAttribute (std::string name, AttributeValue &value, bool permissive=false) const |
Get the value of an attribute, raising fatal errors if unsuccessful. | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId () |
Register this type. | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. | |
Private Attributes | |
AmcModel | m_amcModel |
The AmcModel attribute. | |
double | m_ber |
The Ber attribute. | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. | |
virtual void | DoDispose () |
Destructor implementation. | |
virtual void | DoInitialize () |
Initialize() implementation. | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. | |
Related Symbols inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
Implements the Adaptive Modulation And Coding Scheme.
As proposed in 3GPP TSG-RAN WG1 [R1-081483 Conveying MCS and TB size via PDCCH] (http://www.3gpp.org/ftp/tsg_ran/WG1_RL1/TSGR1_52b/Docs/R1-081483.zip).
Types of AMC model.
Enumerator | |
---|---|
PiroEW2010 | An AMC model based on Piro, G.; Grieco, L.A; Boggia, G.; Camarda, P., "A two-level scheduling algorithm for QoS support in the downlink of LTE cellular networks," Wireless Conference (EW), 2010 European, pp.246,253, 12-15 April 2010. |
MiErrorModel | An AMC model based on 10% of BER according to LteMiErrorModel. |
ns3::LteAmc::LteAmc | ( | ) |
Definition at line 448 of file lte-amc.cc.
|
override |
Definition at line 452 of file lte-amc.cc.
std::vector< int > ns3::LteAmc::CreateCqiFeedbacks | ( | const SpectrumValue & | sinr, |
uint8_t | rbgSize = 0 ) |
Create a message with CQI feedback.
sinr | the SpectrumValue vector of SINR for evaluating the CQI |
rbgSize | size of RB group (in RBs) for evaluating subband/wideband CQI |
Definition at line 541 of file lte-amc.cc.
References ns3::SpectrumValue::ConstValuesBegin(), ns3::SpectrumValue::ConstValuesEnd(), GetCqiFromSpectralEfficiency(), GetDlTbSizeFromMcs(), ns3::LteMiErrorModel::GetTbDecodificationStats(), m_amcModel, m_ber, MiErrorModel, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, NS_LOG_LOGIC, PiroEW2010, ns3::SpectralEfficiencyForCqi, ns3::SpectralEfficiencyForMcs, and ns3::TbStats_t::tbler.
int ns3::LteAmc::GetCqiFromSpectralEfficiency | ( | double | s | ) |
Get a proper CQI for the spectral efficiency value.
In order to assure a lower block error rate, the AMC chooses the lower CQI value for a given spectral efficiency
s | the spectral efficiency |
Definition at line 479 of file lte-amc.cc.
References NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, and ns3::SpectralEfficiencyForCqi.
Referenced by CreateCqiFeedbacks().
int ns3::LteAmc::GetDlTbSizeFromMcs | ( | int | mcs, |
int | nprb ) |
Get the Transport Block Size for a selected MCS and number of PRB (table 7.1.7.2.1-1 of 36.213)
mcs | the MCS index |
nprb | the no. of PRB |
Definition at line 508 of file lte-amc.cc.
References ns3::McsToItbsDl, NS_ASSERT_MSG, NS_LOG_FUNCTION, and ns3::TransportBlockSizeTable.
Referenced by CreateCqiFeedbacks().
int ns3::LteAmc::GetMcsFromCqi | ( | int | cqi | ) |
Get the Modulation and Coding Scheme for a CQI value.
cqi | the cqi value |
Definition at line 493 of file lte-amc.cc.
References NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, ns3::SpectralEfficiencyForCqi, and ns3::SpectralEfficiencyForMcs.
double ns3::LteAmc::GetSpectralEfficiencyFromCqi | ( | int | cqi | ) |
Get the spectral efficiency value associated to the received CQI.
cqi | the cqi value |
Definition at line 532 of file lte-amc.cc.
References NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, and ns3::SpectralEfficiencyForCqi.
|
static |
Get the type ID.
Definition at line 457 of file lte-amc.cc.
References m_amcModel, m_ber, ns3::MakeDoubleAccessor(), ns3::MakeDoubleChecker(), ns3::MakeEnumAccessor(), ns3::MakeEnumChecker(), MiErrorModel, PiroEW2010, and ns3::TypeId::SetParent().
int ns3::LteAmc::GetUlTbSizeFromMcs | ( | int | mcs, |
int | nprb ) |
Get the Transport Block Size for a selected MCS and number of PRB (table 8.6.1-1 of 36.213)
mcs | the MCS index |
nprb | the no. of PRB |
Definition at line 520 of file lte-amc.cc.
References ns3::McsToItbsUl, NS_ASSERT_MSG, NS_LOG_FUNCTION, and ns3::TransportBlockSizeTable.
|
private |
The AmcModel
attribute.
AMC model used to assign CQI.
Definition at line 123 of file lte-amc.h.
Referenced by CreateCqiFeedbacks(), and GetTypeId().
|
private |
The Ber
attribute.
The requested BER in assigning MCS (default is 0.00005).
Definition at line 116 of file lte-amc.h.
Referenced by CreateCqiFeedbacks(), and GetTypeId().