#include <Ieee80211OfdmErrorModel.h>

Inheritance diagram for inet::physicallayer::Ieee80211OfdmErrorModel:

Public Member Functions
virtual const IReceptionPacketModel *	computePacketModel (const LayeredTransmission transmission, const ISnir snir) const override
	Computes the packet domain representation at the receiver using a simplified model for the underlying domains. More...

virtual const IReceptionBitModel *	computeBitModel (const LayeredTransmission transmission, const ISnir snir) const override
	Computes the bit domain representation at the receiver using a simplified model for the underlying domains. More...

virtual const IReceptionSymbolModel *	computeSymbolModel (const LayeredTransmission transmission, const ISnir snir) const override
	Computes the symbol domain representation at the receiver using a simplified model for the underlying domains. More...

virtual const IReceptionSampleModel *	computeSampleModel (const LayeredTransmission transmission, const ISnir snir) const override
	Computes the sample domain representation at the receiver using a simplified model for the underlying domains. More...

virtual std::ostream &	printToStream (std::ostream &stream, int level, int evFlags=0) const override
	Prints this object to the provided output stream. More...

Public Member Functions inherited from inet::physicallayer::Ieee80211ErrorModelBase
	Ieee80211ErrorModelBase ()

virtual double	computePacketErrorRate (const ISnir *snir, IRadioSignal::SignalPart part) const override
	Returns the packet error rate based on SNIR, modulation, FEC encoding and any other physical layer characteristics. More...

virtual double	computeBitErrorRate (const ISnir *snir, IRadioSignal::SignalPart part) const override
	Returns the bit error rate based on SNIR, modulation, FEC encoding and any other physical layer characteristics. More...

virtual double	computeSymbolErrorRate (const ISnir *snir, IRadioSignal::SignalPart part) const override
	Returns the symbol error rate based on SNIR, modulation, and any other physical layer characteristics. More...

Public Member Functions inherited from inet::IPrintableObject
virtual	~IPrintableObject ()

virtual std::string	printToString () const

virtual std::string	printToString (int level, int evFlags=0) const

virtual std::string	getInfoStringRepresentation (int evFlags=0) const

virtual std::string	getDetailStringRepresentation (int evFlags=0) const

virtual std::string	getDebugStringRepresentation (int evFlags=0) const

virtual std::string	getTraceStringRepresentation (int evFlags=0) const

virtual std::string	getCompleteStringRepresentation (int evFlags=0) const

Protected Member Functions
virtual int	numInitStages () const override

virtual void	initialize (int stage) override

virtual Ieee80211OfdmSymbol *	corruptOfdmSymbol (const Ieee80211OfdmSymbol symbol, const MqamModulationBase modulation, double snir) const

virtual void	corruptBits (BitVector *bits, double ber, int begin, int end) const

Protected Member Functions inherited from inet::physicallayer::Ieee80211NistErrorModel
double	calculatePe (double p, uint32_t bValue) const

double	getBpskBer (double snr) const

double	getQpskBer (double snr) const

double	get16QamBer (double snr) const

double	get64QamBer (double snr) const

double	get256QamBer (double snr) const

double	get1024QamBer (double snr) const

double	getFecBpskBer (double snr, double nbits, uint32_t bValue) const

double	getFecQpskBer (double snr, double nbits, uint32_t bValue) const

double	getFec16QamBer (double snr, uint32_t nbits, uint32_t bValue) const

double	getFec64QamBer (double snr, uint32_t nbits, uint32_t bValue) const

double	getFec256QamBer (double snr, uint64_t nbits, uint32_t bValue) const

double	getFec1024QamBer (double snr, uint64_t nbits, uint32_t bValue) const

virtual double	getOFDMAndERPOFDMChunkSuccessRate (const ApskModulationBase subcarrierModulation, const ConvolutionalCode convolutionalCode, unsigned int bitLength, double snr) const

virtual double	getDSSSAndHrDSSSChunkSuccessRate (bps bitrate, unsigned int bitLength, double snr) const

virtual double	getHeaderSuccessRate (const IIeee80211Mode *mode, unsigned int headerBitLength, double snr) const override

virtual double	getDataSuccessRate (const IIeee80211Mode *mode, unsigned int bitLength, double snr) const override

Protected Member Functions inherited from inet::physicallayer::Ieee80211ErrorModelBase
virtual Packet *	computeCorruptedPacket (const Packet *packet, double ber) const override

virtual double	getDsssDbpskSuccessRate (unsigned int bitLength, double snir) const

virtual double	getDsssDqpskSuccessRate (unsigned int bitLength, double snir) const

virtual double	getDsssDqpskCck5_5SuccessRate (unsigned int bitLength, double snir) const

virtual double	getDsssDqpskCck11SuccessRate (unsigned int bitLength, double snir) const

Protected Member Functions inherited from inet::physicallayer::ErrorModelBase
virtual double	getScalarSnir (const ISnir *snir) const

virtual bool	hasProbabilisticError (b length, double ber) const

virtual Packet *	corruptBits (const Packet *packet, double ber, bool &isCorrupted) const

virtual Packet *	corruptBytes (const Packet *packet, double ber, bool &isCorrupted) const

virtual Packet *	corruptChunks (const Packet *packet, double ber, bool &isCorrupted) const

virtual Packet *	corruptPacket (const Packet *packet, bool &isCorrupted) const

virtual Packet *	computeCorruptedPacket (const ISnir *snir) const override

Protected Attributes
double	signalSymbolErrorRate

double	dataSymbolErrorRate

double	signalBitErrorRate

double	dataBitErrorRate

Protected Attributes inherited from inet::physicallayer::Ieee80211ErrorModelBase
double	spectralEfficiency1bit = 2000000.0 / 1000000.0

double	spectralEfficiency2bit = 2000000.0 / 1000000.0 / 2.0

double	sirPerfect = 10.0

double	sirImpossible = 0.1

Protected Attributes inherited from inet::physicallayer::ErrorModelBase
CorruptionMode	corruptionMode = CorruptionMode::CM_UNDEFINED

SnirMode	snirMode = SnirMode::SM_UNDEFINED

double	snirOffset = NaN

Additional Inherited Members
Public Types inherited from inet::physicallayer::ErrorModelBase
enum	CorruptionMode { CorruptionMode::CM_UNDEFINED = -1, CorruptionMode::CM_PACKET, CorruptionMode::CM_CHUNK, CorruptionMode::CM_BYTE, CorruptionMode::CM_BIT }

enum	SnirMode { SnirMode::SM_UNDEFINED = -1, SnirMode::SM_MIN, SnirMode::SM_MEAN }

Public Types inherited from inet::IPrintableObject
enum	PrintLevel { PRINT_LEVEL_TRACE, PRINT_LEVEL_DEBUG, PRINT_LEVEL_DETAIL, PRINT_LEVEL_INFO, PRINT_LEVEL_COMPLETE = INT_MIN }

enum	PrintFlag { PRINT_FLAG_FORMATTED = (1 << 0), PRINT_FLAG_MULTILINE = (1 << 1) }

Member Function Documentation

◆ computeBitModel()

const IReceptionBitModel * inet::physicallayer::Ieee80211OfdmErrorModel::computeBitModel	(	const LayeredTransmission *	transmission,
		const ISnir *	snir
	)		const

overridevirtual

Computes the bit domain representation at the receiver using a simplified model for the underlying domains.

This result includes all potential errors that were not corrected by the underlying domains.

Implements inet::physicallayer::ILayeredErrorModel.

 {
     const ITransmissionBitModel *transmissionBitModel = transmission->getBitModel();
     int signalBitLength = b(transmissionBitModel->getHeaderLength()).get();
     bps signalBitRate = transmissionBitModel->getHeaderBitRate();
     int dataBitLength = b(transmissionBitModel->getDataLength()).get();
     bps dataBitRate = transmissionBitModel->getDataBitRate();
     ASSERT(transmission->getSymbolModel() != nullptr);
     const IModulation *signalModulation = transmission->getSymbolModel()->getHeaderModulation();
     const IModulation *dataModulation = transmission->getSymbolModel()->getPayloadModulation();
     const BitVector *bits = transmissionBitModel->getBits();
     BitVector *corruptedBits = new BitVector(*bits);
     const ScalarTransmissionSignalAnalogModel *analogModel = check_and_cast<const ScalarTransmissionSignalAnalogModel *>(transmission->getAnalogModel());
     if (auto apskSignalModulation = dynamic_cast<const IApskModulation *>(signalModulation)) {
         double signalFieldBer = std::isnan(signalBitErrorRate) ? apskSignalModulation->calculateBER(getScalarSnir(snir), analogModel->getBandwidth(), signalBitRate) : signalBitErrorRate;
         corruptBits(corruptedBits, signalFieldBer, 0, signalBitLength);
     }
     else
         throw cRuntimeError("Unknown signal modulation");
     if (auto apskDataModulation = dynamic_cast<const IApskModulation *>(dataModulation)) {
         double dataFieldBer = std::isnan(dataBitErrorRate) ? apskDataModulation->calculateBER(getScalarSnir(snir), analogModel->getBandwidth(), dataBitRate) : dataBitErrorRate;
         corruptBits(corruptedBits, dataFieldBer, signalBitLength, corruptedBits->getSize());
     }
     else
         throw cRuntimeError("Unknown data modulation");
     return new ReceptionBitModel(b(signalBitLength), signalBitRate, b(dataBitLength), dataBitRate, corruptedBits, NaN);
 }

◆ computePacketModel()

const IReceptionPacketModel * inet::physicallayer::Ieee80211OfdmErrorModel::computePacketModel	(	const LayeredTransmission *	transmission,
		const ISnir *	snir
	)		const

overridevirtual

Computes the packet domain representation at the receiver using a simplified model for the underlying domains.

This result includes all potential errors that were not corrected by the underlying domains.

Implements inet::physicallayer::ILayeredErrorModel.

 {
     double packetErrorRate = computePacketErrorRate(snir, IRadioSignal::SIGNAL_PART_WHOLE);
     auto transmissionPacketModel = check_and_cast<const TransmissionPacketModel *>(transmission->getPacketModel());
     auto transmittedPacket = transmissionPacketModel->getPacket();
     auto receivedPacket = transmittedPacket->dup();
     if (packetErrorRate != 0 && uniform(0, 1) < packetErrorRate)
         receivedPacket->setBitError(true);
     receivedPacket->addTagIfAbsent<ErrorRateInd>()->setPacketErrorRate(packetErrorRate);
     return new ReceptionPacketModel(receivedPacket, transmissionPacketModel->getBitrate(), NaN);
 }

◆ computeSampleModel()

const IReceptionSampleModel * inet::physicallayer::Ieee80211OfdmErrorModel::computeSampleModel	(	const LayeredTransmission *	transmission,
		const ISnir *	snir
	)		const

overridevirtual

Computes the sample domain representation at the receiver using a simplified model for the underlying domains.

This result includes all potential errors that were not corrected by the underlying domains.

Implements inet::physicallayer::ILayeredErrorModel.

 {
     throw cRuntimeError("Unimplemented!");
     // TODO implement sample error model
     const ITransmissionSampleModel *transmissionSampleModel = transmission->getSampleModel();
     int sampleLength = transmissionSampleModel->getSampleLength();
     double sampleRate = transmissionSampleModel->getSampleRate();
     const std::vector<W> *samples = transmissionSampleModel->getSamples();
     W rssi = W(0); // TODO error model
     return new ReceptionSampleModel(sampleLength, sampleRate, samples, rssi);
 }

◆ computeSymbolModel()

const IReceptionSymbolModel * inet::physicallayer::Ieee80211OfdmErrorModel::computeSymbolModel	(	const LayeredTransmission *	transmission,
		const ISnir *	snir
	)		const

overridevirtual

Computes the symbol domain representation at the receiver using a simplified model for the underlying domains.

This result includes all potential errors that were not corrected by the underlying domains.

Implements inet::physicallayer::ILayeredErrorModel.

 {
     auto transmissionSymbolModel = check_and_cast<const Ieee80211OfdmTransmissionSymbolModel *>(transmission->getSymbolModel());
     auto symbols = transmissionSymbolModel->getSymbols();
     auto receivedSymbols = new std::vector<const ISymbol *>();
     // Only the first symbol is signal field symbol
     double scalarSnir = getScalarSnir(snir);
     receivedSymbols->push_back(corruptOfdmSymbol(check_and_cast<const Ieee80211OfdmSymbol *>(symbols->at(0)), &BpskModulation::singleton, scalarSnir));
     // The remaining are all data field symbols
     auto dataModulation = check_and_cast<const MqamModulationBase *>(transmissionSymbolModel->getPayloadModulation());
     for (unsigned int i = 1; i < symbols->size(); i++) {
         Ieee80211OfdmSymbol *corruptedOFDMSymbol = corruptOfdmSymbol(check_and_cast<const Ieee80211OfdmSymbol *>(symbols->at(i)), dataModulation, scalarSnir);
         receivedSymbols->push_back(corruptedOFDMSymbol);
     }
     return new Ieee80211OfdmReceptionSymbolModel(transmissionSymbolModel->getHeaderSymbolLength(), transmissionSymbolModel->getHeaderSymbolRate(), transmissionSymbolModel->getPayloadSymbolLength(), transmissionSymbolModel->getPayloadSymbolRate(), receivedSymbols);
 }

◆ corruptBits()

void inet::physicallayer::Ieee80211OfdmErrorModel::corruptBits	(	BitVector *	bits,
		double	ber,
		int	begin,
		int	end
	)		const

protectedvirtual

 {
     for (int i = begin; i != end; i++) {
         double p = uniform(0, 1);
         if (p <= ber)
             bits->toggleBit(i);
     }
 }

Referenced by computeBitModel().

◆ corruptOfdmSymbol()

Ieee80211OfdmSymbol * inet::physicallayer::Ieee80211OfdmErrorModel::corruptOfdmSymbol	(	const Ieee80211OfdmSymbol *	symbol,
		const MqamModulationBase *	modulation,
		double	snir
	)		const

protectedvirtual

 {
     std::vector<const ApskSymbol *> subcarrierSymbols = ofdmSymbol->getSubCarrierSymbols();
     for (auto& subcarrierSymbol : subcarrierSymbols) {
         if (subcarrierSymbol != nullptr) {
             double transmittedI = subcarrierSymbol->real();
             double transmittedQ = subcarrierSymbol->imag();
             double sigma = std::sqrt(0.5 / snir);
             double receivedI = normal(transmittedI, sigma);
             double receivedQ = normal(transmittedQ, sigma);
             double bestDistanceSquare = DBL_MAX;
             const ApskSymbol *receivedSubcarrierSymbol = subcarrierSymbol;
             for (auto& symbol : *modulation->getConstellation()) {
                 double i = symbol.real();
                 double q = symbol.imag();
                 double distanceSquare = std::pow((i - receivedI), 2) + std::pow((q - receivedQ), 2);
                 if (distanceSquare < bestDistanceSquare) {
                     bestDistanceSquare = distanceSquare;
                     receivedSubcarrierSymbol = &symbol;
                 }
             }
             subcarrierSymbol = receivedSubcarrierSymbol;
         }
     }
     return new Ieee80211OfdmSymbol(subcarrierSymbols);
 }

Referenced by computeSymbolModel().

◆ initialize()

void inet::physicallayer::Ieee80211OfdmErrorModel::initialize ( int stage )

overrideprotectedvirtual

Reimplemented from inet::physicallayer::ErrorModelBase.

 {
     Ieee80211NistErrorModel::initialize(stage);
     if (stage == INITSTAGE_LOCAL) {
         dataSymbolErrorRate = par("dataSymbolErrorRate");
         dataBitErrorRate = par("dataBitErrorRate");
         signalSymbolErrorRate = par("signalSymbolErrorRate");
         signalBitErrorRate = par("signalBitErrorRate");
     }
 }

◆ numInitStages()

virtual int inet::physicallayer::Ieee80211OfdmErrorModel::numInitStages ( ) const

inlineoverrideprotectedvirtual

29 { return NUM_INIT_STAGES; }

◆ printToStream()

std::ostream & inet::physicallayer::Ieee80211OfdmErrorModel::printToStream	(	std::ostream &	stream,
		int	level,
		int	evFlags = `0`
	)		const

overridevirtual

Prints this object to the provided output stream.

Reimplemented from inet::physicallayer::Ieee80211NistErrorModel.

 {
     stream << "Ieee80211OfdmErrorModel";
     if (level <= PRINT_LEVEL_TRACE)
         stream << EV_FIELD(signalSymbolErrorRate)
                << EV_FIELD(dataSymbolErrorRate)
                << EV_FIELD(signalBitErrorRate)
                << EV_FIELD(dataBitErrorRate);
     return stream;
 }

Member Data Documentation

◆ dataBitErrorRate

double inet::physicallayer::Ieee80211OfdmErrorModel::dataBitErrorRate

protected

Referenced by computeBitModel(), initialize(), and printToStream().

◆ dataSymbolErrorRate

double inet::physicallayer::Ieee80211OfdmErrorModel::dataSymbolErrorRate

protected

Referenced by initialize(), and printToStream().

◆ signalBitErrorRate

double inet::physicallayer::Ieee80211OfdmErrorModel::signalBitErrorRate

protected

Referenced by computeBitModel(), initialize(), and printToStream().

◆ signalSymbolErrorRate

double inet::physicallayer::Ieee80211OfdmErrorModel::signalSymbolErrorRate

protected

Referenced by initialize(), and printToStream().

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

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Member Function Documentation

◆ computeBitModel()

◆ computePacketModel()

◆ computeSampleModel()

◆ computeSymbolModel()

◆ corruptBits()

◆ corruptOfdmSymbol()

◆ initialize()

◆ numInitStages()

◆ printToStream()

Member Data Documentation

◆ dataBitErrorRate

◆ dataSymbolErrorRate

◆ signalBitErrorRate

◆ signalSymbolErrorRate