A model for the error rate for different modulations. More...
#include "nist-error-rate-model.h"
Public Member Functions | |
NistErrorRateModel () | |
Public Member Functions inherited from ns3::ErrorRateModel | |
virtual int64_t | AssignStreams (int64_t stream) |
Assign a fixed random variable stream number to the random variables used by this model. | |
double | CalculateSnr (const WifiTxVector &txVector, double ber) const |
double | GetChunkSuccessRate (WifiMode mode, const WifiTxVector &txVector, double snr, uint64_t nbits, uint8_t numRxAntennas=1, WifiPpduField field=WIFI_PPDU_FIELD_DATA, uint16_t staId=SU_STA_ID) const |
This method returns the probability that the given 'chunk' of the packet will be successfully received by the PHY. | |
virtual bool | IsAwgn () const |
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::ErrorRateModel | |
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 Member Functions | |
double | CalculatePe (double p, uint8_t bValue) const |
Return the coded BER for the given p and b. | |
double | DoGetChunkSuccessRate (WifiMode mode, const WifiTxVector &txVector, double snr, uint64_t nbits, uint8_t numRxAntennas, WifiPpduField field, uint16_t staId) const override |
A pure virtual method that must be implemented in the subclass. | |
double | GetBpskBer (double snr) const |
Return BER of BPSK at the given SNR. | |
uint8_t | GetBValue (WifiCodeRate codeRate) const |
Return the bValue such that coding rate = bValue / (bValue + 1). | |
double | GetFecBpskBer (double snr, uint64_t nbits, uint8_t bValue) const |
Return BER of BPSK at the given SNR after applying FEC. | |
double | GetFecQamBer (uint16_t constellationSize, double snr, uint64_t nbits, uint8_t bValue) const |
Return BER of QAM for a given constellation size at the given SNR after applying FEC. | |
double | GetFecQpskBer (double snr, uint64_t nbits, uint8_t bValue) const |
Return BER of QPSK at the given SNR after applying FEC. | |
double | GetQamBer (uint16_t constellationSize, double snr) const |
Return BER of QAM for a given constellation size at the given SNR. | |
double | GetQpskBer (double snr) const |
Return BER of QPSK at the given SNR. | |
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. | |
A model for the error rate for different modulations.
Introspection did not find any typical Config paths.
For OFDM modulation, the model description and validation can be found in http://www.nsnam.org/~pei/80211ofdm.pdf. For DSSS modulations (802.11b), the model uses the DsssErrorRateModel.
No Attributes are defined for this type.
No TraceSources are defined for this type.
Group: Wifi
Size of this type is 56 bytes (on a 64-bit architecture).
Definition at line 26 of file nist-error-rate-model.h.
ns3::NistErrorRateModel::NistErrorRateModel | ( | ) |
Definition at line 36 of file nist-error-rate-model.cc.
Return the coded BER for the given p and b.
p | the SNR ratio (in linear scale) |
bValue | such that coding rate = bValue / (bValue + 1) |
Definition at line 104 of file nist-error-rate-model.cc.
References NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by GetFecBpskBer(), GetFecQamBer(), and GetFecQpskBer().
|
overrideprivatevirtual |
A pure virtual method that must be implemented in the subclass.
mode | the Wi-Fi mode applicable to this chunk |
txVector | TXVECTOR of the overall transmission |
snr | the SNR of the chunk |
nbits | the number of bits in this chunk |
numRxAntennas | the number of active RX antennas |
field | the PPDU field to which the chunk belongs to |
staId | the station ID for MU |
Implements ns3::ErrorRateModel.
Definition at line 194 of file nist-error-rate-model.cc.
References GetBValue(), ns3::WifiMode::GetCodeRate(), ns3::WifiMode::GetConstellationSize(), GetFecBpskBer(), GetFecQamBer(), GetFecQpskBer(), ns3::WifiMode::GetModulationClass(), NS_LOG_FUNCTION, and ns3::WIFI_MOD_CLASS_ERP_OFDM.
Return BER of BPSK at the given SNR.
snr | SNR ratio (in linear scale) |
Definition at line 41 of file nist-error-rate-model.cc.
References NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by GetFecBpskBer().
|
private |
Return the bValue such that coding rate = bValue / (bValue + 1).
codeRate | the coding rate |
Definition at line 173 of file nist-error-rate-model.cc.
References NS_FATAL_ERROR, ns3::WIFI_CODE_RATE_1_2, ns3::WIFI_CODE_RATE_2_3, ns3::WIFI_CODE_RATE_3_4, ns3::WIFI_CODE_RATE_5_6, and ns3::WIFI_CODE_RATE_UNDEFINED.
Referenced by DoGetChunkSuccessRate().
|
private |
Return BER of BPSK at the given SNR after applying FEC.
snr | SNR ratio (in linear scale) |
nbits | the number of bits in the chunk |
bValue | the bValue such that coding rate = bValue / (bValue + 1) |
Definition at line 74 of file nist-error-rate-model.cc.
References CalculatePe(), GetBpskBer(), and NS_LOG_FUNCTION.
Referenced by DoGetChunkSuccessRate().
|
private |
Return BER of QAM for a given constellation size at the given SNR after applying FEC.
constellationSize | the constellation size (M) |
snr | SNR ratio (in linear scale) |
nbits | the number of bits in the chunk |
bValue | the bValue such that coding rate = bValue / (bValue + 1) |
Definition at line 155 of file nist-error-rate-model.cc.
References CalculatePe(), GetQamBer(), and NS_LOG_FUNCTION.
Referenced by DoGetChunkSuccessRate().
|
private |
Return BER of QPSK at the given SNR after applying FEC.
snr | SNR ratio (in linear scale) |
nbits | the number of bits in the chunk |
bValue | the bValue such that coding rate = bValue / (bValue + 1) |
Definition at line 89 of file nist-error-rate-model.cc.
References CalculatePe(), GetQpskBer(), and NS_LOG_FUNCTION.
Referenced by DoGetChunkSuccessRate().
Return BER of QAM for a given constellation size at the given SNR.
constellationSize | the constellation size (M) |
snr | SNR ratio (in linear scale) |
Definition at line 61 of file nist-error-rate-model.cc.
References NS_ASSERT, NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by GetFecQamBer().
Return BER of QPSK at the given SNR.
snr | SNR ratio (in linear scale) |
Definition at line 51 of file nist-error-rate-model.cc.
References NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by GetFecQpskBer().
|
static |
Get the type ID.
Definition at line 27 of file nist-error-rate-model.cc.
References ns3::TypeId::SetParent().