inet::physicallayer::Ieee80211OFDMErrorModel Class Reference

#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) const override
	Prints this object to the provided output stream. More...
Public Member Functions inherited from inet::physicallayer::IPrintableObject
virtual	~IPrintableObject ()
virtual std::string	getInfoStringRepresentation () const
virtual std::string	getDetailStringRepresentation () const
virtual std::string	getDebugStringRepresentation () const
virtual std::string	getTraceStringRepresentation () const
virtual std::string	getCompleteStringRepresentation () const

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int stage) override
virtual void	handleMessage (cMessage *msg) override
Ieee80211OFDMSymbol *	corruptOFDMSymbol (const Ieee80211OFDMSymbol *symbol, double ser, int constellationSize, const std::vector< APSKSymbol > *constellation) const
void	corruptBits (BitVector *bits, double ber, int begin, int end) const

Protected Attributes
double	signalSymbolErrorRate
double	dataSymbolErrorRate
double	signalBitErrorRate
double	dataBitErrorRate

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

Member Function Documentation

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 = transmissionBitModel->getHeaderBitLength();
    bps signalBitRate = transmissionBitModel->getHeaderBitRate();
    int dataBitLength = transmissionBitModel->getPayloadBitLength();
    bps dataBitRate = transmissionBitModel->getPayloadBitRate();
    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 (dynamic_cast<const IAPSKModulation *>(signalModulation)) {
        const IAPSKModulation *apskSignalModulation = (const IAPSKModulation *)signalModulation;
        double signalFieldBer = std::isnan(signalBitErrorRate) ? apskSignalModulation->calculateBER(snir->getMin(), analogModel->getBandwidth(), signalBitRate) : signalBitErrorRate;
        corruptBits(corruptedBits, signalFieldBer, 0, signalBitLength);
    }
    else
        throw cRuntimeError("Unknown signal modulation");
    if (dynamic_cast<const IAPSKModulation *>(dataModulation)) {
        const IAPSKModulation *apskDataModulation = (const IAPSKModulation *)signalModulation;
        double dataFieldBer = std::isnan(dataBitErrorRate) ? apskDataModulation->calculateBER(snir->getMin(), analogModel->getBandwidth(), dataBitRate) : dataBitErrorRate;
        corruptBits(corruptedBits, dataFieldBer, signalBitLength, corruptedBits->getSize());
    }
    else
        throw cRuntimeError("Unknown data modulation");
    return new const ReceptionBitModel(signalBitLength, signalBitRate, dataBitLength, dataBitRate, corruptedBits);
}

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.

{
    throw cRuntimeError("Unimplemented!");
    // TODO: implement error model
    const ITransmissionPacketModel *transmissionPacketModel = transmission->getPacketModel();
    const cPacket *packet = transmissionPacketModel->getPacket();
    double per = 0.0;
    bool packetErrorless = per == 0.0;
    return new const ReceptionPacketModel(packet, nullptr, bps(NaN), per, packetErrorless);
}

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 const ReceptionSampleModel(sampleLength, sampleRate, samples, rssi);
}

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.

{
    const ITransmissionBitModel *transmissionBitModel = transmission->getBitModel();
    const TransmissionSymbolModel *transmissionSymbolModel = check_and_cast<const Ieee80211OFDMTransmissionSymbolModel *>(transmission->getSymbolModel());
    const IModulation *modulation = transmissionSymbolModel->getPayloadModulation();
    const APSKModulationBase *dataModulation = check_and_cast<const APSKModulationBase *>(modulation);
    unsigned int dataFieldConstellationSize = dataModulation->getConstellationSize();
    unsigned int signalFieldConstellationSize = BPSKModulation::singleton.getConstellationSize();
    const std::vector<APSKSymbol> *constellationForDataField = dataModulation->getConstellation();
    const std::vector<APSKSymbol> *constellationForSignalField = BPSKModulation::singleton.getConstellation();
    const ScalarTransmissionSignalAnalogModel *analogModel = check_and_cast<const ScalarTransmissionSignalAnalogModel *>(transmission->getAnalogModel());
    double signalSER = std::isnan(signalSymbolErrorRate) ? BPSKModulation::singleton.calculateSER(snir->getMin(), analogModel->getBandwidth(), transmissionBitModel->getHeaderBitRate()) : signalSymbolErrorRate;
    double dataSER = std::isnan(dataSymbolErrorRate) ? dataModulation->calculateSER(snir->getMin(), analogModel->getBandwidth(), transmissionBitModel->getPayloadBitRate()) : dataSymbolErrorRate;
    const std::vector<const ISymbol *> *symbols = transmissionSymbolModel->getSymbols();
    std::vector<const ISymbol *> *corruptedSymbols = new std::vector<const ISymbol *>();
    // Only the first symbol is signal field symbol
    corruptedSymbols->push_back(corruptOFDMSymbol(check_and_cast<const Ieee80211OFDMSymbol *>(symbols->at(0)), signalSER, signalFieldConstellationSize, constellationForSignalField));
    // The remaining are all data field symbols
    for (unsigned int i = 1; i < symbols->size(); i++) {
        Ieee80211OFDMSymbol *corruptedOFDMSymbol = corruptOFDMSymbol(check_and_cast<const Ieee80211OFDMSymbol *>(symbols->at(i)), dataSER,
                    dataFieldConstellationSize, constellationForDataField);
        corruptedSymbols->push_back(corruptedOFDMSymbol);
    }
    return new Ieee80211OFDMReceptionSymbolModel(transmissionSymbolModel->getHeaderSymbolLength(), transmissionSymbolModel->getHeaderSymbolRate(), transmissionSymbolModel->getPayloadSymbolLength(), transmissionSymbolModel->getPayloadSymbolRate(), corruptedSymbols);
}

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

protected

Referenced by computeBitModel().

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

Ieee80211OFDMSymbol * inet::physicallayer::Ieee80211OFDMErrorModel::corruptOFDMSymbol ( const Ieee80211OFDMSymbol *  symbol, double  ser, int  constellationSize, const std::vector< APSKSymbol > *  constellation  ) const

protected

Referenced by computeSymbolModel().

{
    std::vector<const APSKSymbol *> subcarrierSymbols = symbol->getSubCarrierSymbols();
    for (int j = 0; j < symbol->symbolSize(); j++) {
        double p = uniform(0, 1);
        if (p <= ser) {
            int corruptedSubcarrierSymbolIndex = intuniform(0, constellationSize - 1); // TODO: it can be equal to the current symbol
            const APSKSymbol *corruptedSubcarrierSymbol = &constellation->at(corruptedSubcarrierSymbolIndex);
            subcarrierSymbols[j] = corruptedSubcarrierSymbol;
        }
    }
    return new Ieee80211OFDMSymbol(subcarrierSymbols);
}

virtual void inet::physicallayer::Ieee80211OFDMErrorModel::handleMessage ( cMessage *  msg )

inlineoverrideprotectedvirtual

{ throw cRuntimeError("The module doesn't handle self messages"); }

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

overrideprotectedvirtual

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

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

inlineoverrideprotectedvirtual

{ return NUM_INIT_STAGES; }

std::ostream & inet::physicallayer::Ieee80211OFDMErrorModel::printToStream ( std::ostream &  stream, int  level  ) const

overridevirtual

Prints this object to the provided output stream.

Function calls to operator<< with pointers or references either const or not are all forwarded to this function.

Reimplemented from inet::physicallayer::IPrintableObject.

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

Member Data Documentation

double inet::physicallayer::Ieee80211OFDMErrorModel::dataBitErrorRate

protected

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

double inet::physicallayer::Ieee80211OFDMErrorModel::dataSymbolErrorRate

protected

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

double inet::physicallayer::Ieee80211OFDMErrorModel::signalBitErrorRate

protected

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

double inet::physicallayer::Ieee80211OFDMErrorModel::signalSymbolErrorRate

protected

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

---

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

• Ieee80211OFDMErrorModel.h
• Ieee80211OFDMErrorModel.cc