inet::physicallayer::APSKModulationBase Class Reference

Base class for modulations using various amplitude and phase-shift keying. More...

#include <APSKModulationBase.h>

Inheritance diagram for inet::physicallayer::APSKModulationBase:

Public Member Functions
	APSKModulationBase (const std::vector< APSKSymbol > *constellation)
virtual std::ostream &	printToStream (std::ostream &stream, int level) const override
	Prints this object to the provided output stream. More...
virtual const std::vector< APSKSymbol > *	getConstellation () const
virtual unsigned int	getConstellationSize () const override
virtual unsigned int	getCodeWordSize () const override
virtual const APSKSymbol *	mapToConstellationDiagram (const ShortBitVector &symbol) const
virtual ShortBitVector	demapToBitRepresentation (const APSKSymbol *symbol) const
Public Member Functions inherited from inet::physicallayer::IModulation
virtual double	calculateBER (double snir, Hz bandwidth, bps bitrate) const =0
	Returns the bit error rate as a function of the signal to noise and interference ratio, the bandwidth, and the gross (physical) bitrate. More...
virtual double	calculateSER (double snir, Hz bandwidth, bps bitrate) const =0
	Returns the symbol error rate as a function of the signal to noise and interference ratio, the bandwidth, and the gross (physical) bitrate. 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

Static Public Member Functions
static const APSKModulationBase *	findModulation (const char *name)

Protected Attributes
const std::vector< APSKSymbol > *	constellation
const unsigned int	codeWordSize
const unsigned int	constellationSize

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

Base class for modulations using various amplitude and phase-shift keying.

Constructor & Destructor Documentation

inet::physicallayer::APSKModulationBase::APSKModulationBase

(

const std::vector< APSKSymbol > *

constellation

)

                                                                                 :
    constellation(constellation),
    codeWordSize(log2(constellation->size())),
    constellationSize(constellation->size())
{
}

Member Function Documentation

ShortBitVector inet::physicallayer::APSKModulationBase::demapToBitRepresentation ( const APSKSymbol *  symbol ) const

virtual

Referenced by inet::physicallayer::APSKDemodulator::demodulate(), and inet::physicallayer::Ieee80211OFDMDemodulator::demodulateSymbol().

{
    // TODO: Complete implementation: http://eprints.soton.ac.uk/354719/1/tvt-hanzo-2272640-proof.pdf
    double symbolQ = symbol->real();
    double symbolI = symbol->imag();
    double minDist = DBL_MAX;
    int nearestNeighborIndex = -1;
    for (unsigned int i = 0; i < constellationSize; i++) {
        const APSKSymbol *constellationSymbol = &constellation->at(i);
        double cQ = constellationSymbol->real();
        double cI = constellationSymbol->imag();
        double dist = (symbolQ - cQ) * (symbolQ - cQ) + (symbolI - cI) * (symbolI - cI);
        if (dist < minDist) {
            minDist = dist;
            nearestNeighborIndex = i;
        }
    }
    ASSERT(nearestNeighborIndex != -1);
    return ShortBitVector(nearestNeighborIndex, codeWordSize);
}

const APSKModulationBase * inet::physicallayer::APSKModulationBase::findModulation ( const char *  name )

static

Referenced by inet::physicallayer::Ieee80211OFDMModulatorModule::initialize(), inet::physicallayer::Ieee80211OFDMDemodulatorModule::initialize(), inet::physicallayer::NarrowbandTransmitterBase::initialize(), inet::physicallayer::NarrowbandReceiverBase::initialize(), inet::physicallayer::APSKModulator::initialize(), and inet::physicallayer::APSKDemodulator::initialize().

{
    if (!strcmp("BPSK", modulation))
        return &BPSKModulation::singleton;
    else if (!strcmp("QPSK", modulation))
        return &QPSKModulation::singleton;
    else if (!strcmp("QAM-16", modulation))
        return &QAM16Modulation::singleton;
    else if (!strcmp("QAM-64", modulation))
        return &QAM64Modulation::singleton;
    else if (!strcmp("QAM-256", modulation))
        return &QAM256Modulation::singleton;
    else if (!strncmp("MQAM-", modulation, 5))
        return new MQAMModulation(atoi(modulation + 5));
    else if (!strncmp("MPSK-", modulation, 5))
        return new MPSKModulation(atoi(modulation + 5));
    else if (!strcmp(modulation, "DSSS-OQPSK-16"))
        return new DSSSOQPSK16Modulation();
    else
        throw cRuntimeError("Unknown modulation = %s", modulation);
}

virtual unsigned int inet::physicallayer::APSKModulationBase::getCodeWordSize ( ) const

inlineoverridevirtual

Implements inet::physicallayer::IAPSKModulation.

Referenced by inet::physicallayer::Ieee80211LayeredOFDMReceiver::calculatePadding(), inet::physicallayer::Ieee80211OFDMModeBase::computeGrossBitrate(), inet::physicallayer::Ieee80211HTCompliantCodes::getCompliantCode(), inet::physicallayer::Ieee80211OFDMDataMode::getDuration(), and inet::physicallayer::APSKModulator::modulate().

{ return codeWordSize; }

virtual const std::vector<APSKSymbol>* inet::physicallayer::APSKModulationBase::getConstellation ( ) const

inlinevirtual

Referenced by inet::physicallayer::Ieee80211OFDMErrorModel::computeSymbolModel().

{ return constellation; }

virtual unsigned int inet::physicallayer::APSKModulationBase::getConstellationSize ( ) const

inlineoverridevirtual

Implements inet::physicallayer::IAPSKModulation.

Referenced by inet::physicallayer::Ieee80211OFDMErrorModel::computeSymbolModel().

{ return constellationSize; }

const APSKSymbol * inet::physicallayer::APSKModulationBase::mapToConstellationDiagram ( const ShortBitVector &  symbol ) const

virtual

Referenced by inet::physicallayer::APSKModulator::modulate().

{
    unsigned int decimalSymbol = symbol.toDecimal();
    if (decimalSymbol >= constellationSize)
        throw cRuntimeError("Unknown input: %d", decimalSymbol);
    return &constellation->at(decimalSymbol);
}

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

Reimplemented in inet::physicallayer::QAM16Modulation, inet::physicallayer::QAM256Modulation, inet::physicallayer::QAM64Modulation, inet::physicallayer::BPSKModulation, inet::physicallayer::QPSKModulation, inet::physicallayer::MASKModulation, inet::physicallayer::MPSKModulation, and inet::physicallayer::MQAMModulation.

Referenced by inet::physicallayer::MASKModulation::printToStream(), inet::physicallayer::MQAMModulation::printToStream(), and inet::physicallayer::MPSKModulation::printToStream().

{
    if (level <= PRINT_LEVEL_TRACE)
        stream << ", constellationSize = " << constellationSize
               << ", codeWordSize = " << codeWordSize;
    return stream;
}

Member Data Documentation

const unsigned int inet::physicallayer::APSKModulationBase::codeWordSize

protected

Referenced by inet::physicallayer::MQAMModulationBase::calculateBER(), inet::physicallayer::MPSKModulation::calculateBER(), demapToBitRepresentation(), and printToStream().

const std::vector<APSKSymbol>* inet::physicallayer::APSKModulationBase::constellation

protected

Referenced by demapToBitRepresentation(), mapToConstellationDiagram(), inet::physicallayer::DSSSOQPSK16Modulation::~DSSSOQPSK16Modulation(), inet::physicallayer::MASKModulation::~MASKModulation(), inet::physicallayer::MPSKModulation::~MPSKModulation(), and inet::physicallayer::MQAMModulation::~MQAMModulation().

const unsigned int inet::physicallayer::APSKModulationBase::constellationSize

protected

Referenced by inet::physicallayer::MQAMModulationBase::calculateBER(), inet::physicallayer::MQAMModulationBase::calculateSER(), demapToBitRepresentation(), mapToConstellationDiagram(), and printToStream().

---

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

• APSKModulationBase.h
• APSKModulationBase.cc