25 #include "ns3/string.h"
26 #include "ns3/pointer.h"
27 #include "ns3/uinteger.h"
31 #include "ns3/dsss-error-rate-model.h"
46 static TypeId tid =
TypeId (
"ns3::TableBasedErrorRateModel")
48 .SetGroupName (
"Wifi")
50 .AddAttribute (
"FallbackErrorRateModel",
51 "Ptr to the fallback error rate model to be used when no matching value is found in a table",
54 MakePointerChecker <ErrorRateModel> ())
55 .AddAttribute (
"SizeThreshold",
56 "Threshold in bytes over which the table for large size frames is used",
59 MakeUintegerChecker<uint64_t> ())
80 double multiplier = std::round (std::pow (10.0, precision));
81 return std::floor (snr * multiplier + 0.5) / multiplier;
84 std::optional<uint8_t>
87 std::optional<uint8_t> mcs;
94 if (constellationSize == 2)
105 else if (constellationSize == 4)
116 else if (constellationSize == 16)
127 else if (constellationSize == 64)
149 NS_LOG_FUNCTION (
this << mode << txVector << snr << nbits << +numRxAntennas << field << staId);
150 uint64_t size = std::max<uint64_t> (1, (nbits / 8));
159 NS_LOG_DEBUG (
"No MCS found for mode " << mode <<
": use fallback error rate model");
162 bool ldpc = txVector.
IsLdpc ();
173 NS_LOG_WARN (
"Table missing for MCS: " << +mcs <<
" in TableBasedErrorRateModel: use fallback error rate model");
178 const auto& itVector = errorTable[mcs];
179 auto itTable = std::find_if (itVector.cbegin (), itVector.cend (),
180 [&roundedSnr](
const std::pair<double, double>& element) {
181 return element.first == roundedSnr;
183 double minSnr = itVector.cbegin ()->first;
184 double maxSnr = (--itVector.cend ())->
first;
186 if (itTable == itVector.cend ())
188 if (roundedSnr < minSnr)
192 else if (roundedSnr > maxSnr)
198 double a = 0.0, b = 0.0, previousSnr = 0.0, nextSnr = 0.0;
199 for (
auto i = itVector.cbegin (); i != itVector.cend (); ++i)
201 if (i->first < roundedSnr)
203 previousSnr = i->first;
213 per = a + (roundedSnr - previousSnr) * (b - a) / (nextSnr - previousSnr);
218 per = itTable->second;
222 if (size != tableSize)
225 per = (1.0 - std::pow ((1 - per), (
static_cast<double> (size) / tableSize)));
the interface for Wifi's error models
Hold objects of type Ptr<T>.
Introspection did not find any typical Config paths.
Ptr< ErrorRateModel > m_fallbackErrorModel
Error rate model to fallback to if no value is found in the table.
static std::optional< uint8_t > GetMcsForMode(WifiMode mode)
Utility function to convert WifiMode to an MCS value.
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.
TableBasedErrorRateModel()
static TypeId GetTypeId(void)
Get the type ID.
~TableBasedErrorRateModel()
double RoundSnr(double snr, double precision) const
Round SNR (in dB) to the specified precision.
uint64_t m_threshold
Threshold in bytes over which the table for large size frames is used.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Hold an unsigned integer type.
represent a single transmission mode
uint16_t GetConstellationSize(void) const
uint8_t GetMcsValue(void) const
WifiModulationClass GetModulationClass() const
WifiCodeRate GetCodeRate(void) const
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
bool IsLdpc(void) const
Check if LDPC FEC coding is used or not.
Ptr< const AttributeAccessor > MakePointerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_LOG_WARN(msg)
Use NS_LOG to output a message of level LOG_WARN.
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
WifiModulationClass
This enumeration defines the modulation classes per (Table 10-6 "Modulation classes"; IEEE 802....
WifiPpduField
The type of PPDU field (grouped for convenience)
@ WIFI_MOD_CLASS_OFDM
OFDM (Clause 17)
@ WIFI_MOD_CLASS_HT
HT (Clause 19)
@ WIFI_MOD_CLASS_ERP_OFDM
ERP-OFDM (18.4)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
static const SnrPerTable AwgnErrorTableBcc32[ERROR_TABLE_BCC_MAX_NUM_MCS]
AWGN error table for BCC with reference size of 32 bytes.
double RatioToDb(double ratio)
Convert from ratio to dB.
const uint16_t WIFI_CODE_RATE_3_4
3/4 coding rate
const uint16_t WIFI_CODE_RATE_1_2
1/2 coding rate
const uint8_t ERROR_TABLE_BCC_MAX_NUM_MCS
maximum number of MCSs for BCC
static const SnrPerTable AwgnErrorTableLdpc1458[ERROR_TABLE_LDPC_MAX_NUM_MCS]
AWGN error table for LDPC with reference size of 1458 bytes.
static const SnrPerTable AwgnErrorTableBcc1458[ERROR_TABLE_BCC_MAX_NUM_MCS]
AWGN error table for BCC with reference size of 1458 bytes.
const uint16_t WIFI_CODE_RATE_2_3
2/3 coding rate
const uint8_t ERROR_TABLE_LDPC_MAX_NUM_MCS
maximum number of MCSs for LDPC
const uint16_t ERROR_TABLE_BCC_LARGE_FRAME_SIZE
reference size (bytes) of large frames for BCC
uint16_t WifiCodeRate
These constants define the various convolutional coding rates used for the OFDM transmission modes in...
const uint16_t ERROR_TABLE_BCC_SMALL_FRAME_SIZE
reference size (bytes) of small frames for BCC
static const double TABLED_BASED_ERROR_MODEL_PRECISION
precision for PER
static const double SNR_PRECISION
precision for SNR
const uint16_t ERROR_TABLE_LDPC_FRAME_SIZE
reference size (bytes) for LDPC