Model the error rate for different modulations. More...
#include "yans-error-rate-model.h"
Public Member Functions | |
YansErrorRateModel () | |
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 | Binomial (uint32_t k, double p, uint32_t n) const |
Return Binomial distribution for a given k, p, and n. | |
double | CalculatePd (double ber, unsigned int d) const |
double | CalculatePdEven (double ber, unsigned int d) const |
double | CalculatePdOdd (double ber, unsigned int d) const |
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. | |
uint32_t | Factorial (uint32_t k) const |
Return k! | |
double | GetBpskBer (double snr, uint32_t signalSpread, uint64_t phyRate) const |
Return BER of BPSK with the given parameters. | |
double | GetFecBpskBer (double snr, uint64_t nbits, uint32_t signalSpread, uint64_t phyRate, uint32_t dFree, uint32_t adFree) const |
double | GetFecQamBer (double snr, uint64_t nbits, uint32_t signalSpread, uint64_t phyRate, uint32_t m, uint32_t dfree, uint32_t adFree, uint32_t adFreePlusOne) const |
double | GetQamBer (double snr, unsigned int m, uint32_t signalSpread, uint64_t phyRate) const |
Return BER of QAM-m with the given parameters. | |
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. | |
Model the error rate for different modulations.
Introspection did not find any typical Config paths.
A packet of interest (e.g., a packet can potentially be received by the MAC) is divided into chunks. Each chunk is related to an start/end receiving event. For each chunk, it calculates the ratio (SINR) between received power of packet of interest and summation of noise and interfering power of all the other incoming packets. Then, it will calculate the success rate of the chunk based on BER of the modulation. The success reception rate of the packet is derived from the success rate of all chunks.
The 802.11b modulations:
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 42 of file yans-error-rate-model.h.
ns3::YansErrorRateModel::YansErrorRateModel | ( | ) |
Definition at line 36 of file yans-error-rate-model.cc.
Return Binomial distribution for a given k, p, and n.
k | |
p | |
n |
Definition at line 80 of file yans-error-rate-model.cc.
References Factorial().
Referenced by CalculatePdEven(), and CalculatePdOdd().
ber | |
d |
Definition at line 121 of file yans-error-rate-model.cc.
References CalculatePdEven(), CalculatePdOdd(), and NS_LOG_FUNCTION.
Referenced by GetFecBpskBer(), and GetFecQamBer().
ber | |
d |
Definition at line 104 of file yans-error-rate-model.cc.
References Binomial(), and NS_ASSERT.
Referenced by CalculatePd().
ber | |
d |
Definition at line 89 of file yans-error-rate-model.cc.
References Binomial(), and NS_ASSERT.
Referenced by CalculatePd().
|
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 186 of file yans-error-rate-model.cc.
References ns3::WifiTxVector::GetChannelWidth(), ns3::WifiMode::GetCodeRate(), ns3::WifiMode::GetConstellationSize(), GetFecBpskBer(), GetFecQamBer(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), ns3::WifiMode::GetPhyRate(), ns3::WifiTxVector::IsMu(), NS_LOG_FUNCTION, ns3::SU_STA_ID, ns3::WIFI_CODE_RATE_1_2, ns3::WIFI_CODE_RATE_2_3, ns3::WIFI_CODE_RATE_5_6, and ns3::WIFI_MOD_CLASS_ERP_OFDM.
Return k!
k |
Definition at line 68 of file yans-error-rate-model.cc.
Referenced by Binomial().
|
private |
Return BER of BPSK with the given parameters.
snr | SNR ratio (not dB) |
signalSpread | |
phyRate |
Definition at line 41 of file yans-error-rate-model.cc.
References NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by GetFecBpskBer().
|
private |
snr | SNR ratio (not dB) |
nbits | |
signalSpread | |
phyRate | |
dFree | |
adFree |
Definition at line 137 of file yans-error-rate-model.cc.
References CalculatePd(), GetBpskBer(), and NS_LOG_FUNCTION.
Referenced by DoGetChunkSuccessRate().
|
private |
snr | SNR ratio (not dB) |
nbits | |
signalSpread | |
phyRate | |
m | |
dfree | |
adFree | |
adFreePlusOne |
Definition at line 158 of file yans-error-rate-model.cc.
References CalculatePd(), GetQamBer(), and NS_LOG_FUNCTION.
Referenced by DoGetChunkSuccessRate().
|
private |
Return BER of QAM-m with the given parameters.
snr | SNR ratio (not dB) |
m | |
signalSpread | |
phyRate |
Definition at line 52 of file yans-error-rate-model.cc.
References NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by GetFecQamBer().
|
static |
Get the type ID.
Definition at line 27 of file yans-error-rate-model.cc.
References ns3::TypeId::SetParent().