inet::physicallayer::StochasticErrorModel Class Reference

Implements the StochasticErrorModel model, see the NED file for details. More...

#include <StochasticErrorModel.h>

Inheritance diagram for inet::physicallayer::StochasticErrorModel:

Public Member Functions
	StochasticErrorModel ()
virtual std::ostream &	printToStream (std::ostream &stream, int level) const override
	Prints this object to the provided output stream. More...
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::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 void	initialize (int stage) override

Protected Attributes
double	packetErrorRate
double	bitErrorRate
double	symbolErrorRate

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 }

Detailed Description

Implements the StochasticErrorModel model, see the NED file for details.

Constructor & Destructor Documentation

inet::physicallayer::StochasticErrorModel::StochasticErrorModel

(

)

                                           :
    packetErrorRate(NaN),
    bitErrorRate(NaN),
    symbolErrorRate(NaN)
{
}

Member Function Documentation

double inet::physicallayer::StochasticErrorModel::computeBitErrorRate ( const ISNIR *  snir, IRadioSignal::SignalPart  part  ) const

overridevirtual

Returns the bit error rate based on SNIR, modulation, FEC encoding and any other physical layer characteristics.

Implements inet::physicallayer::IErrorModel.

Referenced by computePacketErrorRate().

{
    Enter_Method_Silent();
    if (!std::isnan(bitErrorRate)) {
        return bitErrorRate;
    }
    else {
        // TODO: compute bit error rate based on symbol error rate and modulation
//        const IReception *reception = snir->getReception();
//        const NarrowbandTransmissionBase *narrowbandTransmission = check_and_cast<const NarrowbandTransmissionBase *>(reception->getTransmission());
//        const IModulation *modulation = narrowbandTransmission->getModulation();
//        double symbolErrorRate = computeSymbolErrorRate(snir);
        throw cRuntimeError("Not yet implemented");
    }
}

double inet::physicallayer::StochasticErrorModel::computePacketErrorRate ( const ISNIR *  snir, IRadioSignal::SignalPart  part  ) const

overridevirtual

Returns the packet error rate based on SNIR, modulation, FEC encoding and any other physical layer characteristics.

Implements inet::physicallayer::IErrorModel.

{
    Enter_Method_Silent();
    const IReception *reception = snir->getReception();
    if (!std::isnan(packetErrorRate)) {
        double factor = reception->getDuration(part) / reception->getDuration();
        return pow(packetErrorRate, factor);
    }
    else {
        const FlatTransmissionBase *flatTransmission = check_and_cast<const FlatTransmissionBase *>(reception->getTransmission());
        double bitErrorRate = computeBitErrorRate(snir, part);
        double headerSuccessRate = pow(1.0 - bitErrorRate, flatTransmission->getHeaderBitLength());
        double dataSuccessRate = pow(1.0 - bitErrorRate, flatTransmission->getDataBitLength());
        switch (part) {
            case IRadioSignal::SIGNAL_PART_WHOLE:
                return 1.0 - headerSuccessRate * dataSuccessRate;
            case IRadioSignal::SIGNAL_PART_PREAMBLE:
                return 0;
            case IRadioSignal::SIGNAL_PART_HEADER:
                return 1.0 - headerSuccessRate;
            case IRadioSignal::SIGNAL_PART_DATA:
                return 1.0 - dataSuccessRate;
            default:
                throw cRuntimeError("Unknown signal part: '%s'", IRadioSignal::getSignalPartName(part));
        }
    }
}

double inet::physicallayer::StochasticErrorModel::computeSymbolErrorRate ( const ISNIR *  snir, IRadioSignal::SignalPart  part  ) const

overridevirtual

Returns the symbol error rate based on SNIR, modulation, and any other physical layer characteristics.

Implements inet::physicallayer::IErrorModel.

{
    Enter_Method_Silent();
    return symbolErrorRate;
}

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

overrideprotectedvirtual

{
    if (stage == INITSTAGE_LOCAL) {
        packetErrorRate = par("packetErrorRate");
        bitErrorRate = par("bitErrorRate");
        symbolErrorRate = par("symbolErrorRate");
    }
}

std::ostream & inet::physicallayer::StochasticErrorModel::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.

{
    if (level <= PRINT_LEVEL_TRACE)
        stream << "StochasticErrorModel"
               << "packetErrorRate = " << packetErrorRate
               << "bitErrorRate = " << bitErrorRate
               << "symbolErrorRate = " << symbolErrorRate;
    return stream;
}

Member Data Documentation

double inet::physicallayer::StochasticErrorModel::bitErrorRate

protected

Referenced by computeBitErrorRate(), computePacketErrorRate(), initialize(), and printToStream().

double inet::physicallayer::StochasticErrorModel::packetErrorRate

protected

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

double inet::physicallayer::StochasticErrorModel::symbolErrorRate

protected

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

---

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

• StochasticErrorModel.h
• StochasticErrorModel.cc