Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Namespace Members | Class Members | File Members

simthlib::ApskDemodulator Class Reference

APSK Demodulator. More...

#include <absdemodulator.h>

Inheritance diagram for simthlib::ApskDemodulator:

Inheritance graph
[legend]
List of all members.

Public Member Functions

 ApskDemodulator (int deviceID, simth::DeviceSystemIntf *system, const simth::PropertyList &pl)
 ApskDemodulator (int deviceID, simth::DeviceSystemIntf *system, const simth::PropertyList &pl, int bitsPerAmpl, int bitsPerPhase, double amplFactor, double amplAddend)
 ~ApskDemodulator ()
virtual int getBitsPerSymbol () const
virtual int getNumStates () const
virtual void print (std::ostream &os) const

Protected Member Functions

Complex getComplSymbol (int symbolIndex) const
double getPhase (int symbIndex) const
double getAmplitude (int symbIndex) const
virtual void MakeMetric (Complex sym, simth::Llv *const llv, Complex h, double noise) const
virtual void MakeMetric (Complex sym, simth::Llv *const llv) const

Related Functions

(Note that these are not member functions.)

 propertylist_ApskDemodulator (not_a_function)

Detailed Description

APSK Demodulator.

Note: These classes also have a zero-forcing equalization built-in. If you intend to perform the equalization otherwise, you *must* either leave the channel information interface unconnected, or you need to look into the "phase_only_equalization" property because that one will skip the equalization but still calculate the correct LLRs.


Constructor & Destructor Documentation

simthlib::ApskDemodulator::ApskDemodulator int  deviceID,
simth::DeviceSystemIntf system,
const simth::PropertyList pl
 

Class constructor which computes the number of bits per phase and the number of bits per amplitude by the given number of bits per state according to the phd. thesis from Thomas May (S. 24, on german). Furthermore, the optimal (according to Thomas May) amplitude ratio between the amplitude rings is computed. The outType determines the type of the output sequence which could be a simth::Llv sequence or an simth::LLR_ sequence (see simth::LlvSeq and simth::LlrSeq)

simthlib::ApskDemodulator::ApskDemodulator int  deviceID,
simth::DeviceSystemIntf system,
const simth::PropertyList pl,
int  bitsPerAmpl,
int  bitsPerPhase,
double  amplFactor,
double  amplAddend
 

Class constructor with explicit number of bits per phase, number of bits per amplitude, amplitude factor and amplitude addend. The amplitude of the i-th ring is computed by: $a_i = f^i + i*A$ where f is the amplitude Factor and A is the amplitude addend. The outType determines the type of the output sequence which could be a simth::Llv sequence or an simth::LLR_ sequence (see simth::LlvSeq and simth::LlrSeq)

simthlib::ApskDemodulator::~ApskDemodulator  ) 
 


Member Function Documentation

double simthlib::ApskDemodulator::getAmplitude int  symbIndex  )  const [inline, protected]
 

virtual int simthlib::ApskDemodulator::getBitsPerSymbol  )  const [inline, virtual]
 

Implements simthlib::Demodulator.

Complex simthlib::ApskDemodulator::getComplSymbol int  symbolIndex  )  const [inline, protected, virtual]
 

Implements simthlib::Demodulator.

virtual int simthlib::ApskDemodulator::getNumStates  )  const [inline, virtual]
 

Implements simthlib::Demodulator.

double simthlib::ApskDemodulator::getPhase int  symbIndex  )  const [inline, protected]
 

virtual void simthlib::ApskDemodulator::MakeMetric Complex  sym,
simth::Llv *const   llv
const [protected, virtual]
 

Returns the metric for the given symbol sym by the symbol itself and without any channel information h.

Normally this would cause an error, because the channel information is needed for the equalization before absolute demodulation. However, this function will silently assume that the equalization has been done beforehand. Or probably its possible to implement a derived class which is able to demodulate without channel information.

Implements simthlib::AbsDemodulatorMetric.

virtual void simthlib::ApskDemodulator::MakeMetric Complex  sym,
simth::Llv *const   llv,
Complex  h,
double  noise
const [protected, virtual]
 

Returns the metric for the given symbol by the symbol itself, and the channel information h. This function also performs ZF equalization by dividing the received symbol through the channel information h.

Implements simthlib::AbsDemodulatorMetric.

virtual void simthlib::ApskDemodulator::print std::ostream &  os  )  const [virtual]
 

Reimplemented from simthlib::AbsDemodulatorMapping.


Friends And Related Function Documentation

propertylist_ApskDemodulator not_a_function   )  [related]
 

These are the properties of class ApskDemodulator . This list is auto-generated from the XML-Devicelist of this device by means of an XSLT transformation script.

Description of this device in the XML file: APSK Demodulator

Note that this class also has the Properties of its base classes. The direct base class is simthlib::AbsDemodulatorMetric ; direct link to its propertylist should be propertylist_AbsDemodulatorMetric(). The list below usually includes the properties that have been inherited from the base classes; the properties which belong only to this class can be found at the end of this list.

The above properties have been inherited from the base class simthlib::AbsDemodulatorMapping .

only_phase_equalisation
<bool>, default "false" -- If true, then the demodulation only performs a phase equalization. If false, then the demodulation performs a full ZF equalization. On the other hand, if the second input interface is unconnected, then the demodulation does not perform any equalization at all.

1 properties in this class. The above properties have been inherited from the base class simthlib::AbsDemodulatorMetric .

detect_type
<enum>, default "coherent" -- FIXME: document me

constellation_explicit_mode
<bool>, default "false" -- If true, then the constellation is specified by-hand. WATCH OUT: This is currently not implemented by the factory function.

bits_per_amplitude
<int>, default "0" -- NOT IMPLEMENTED

bits_per_phase
<int>, default "0" -- NOT IMPLEMENTED

amplitude_factor
<double>, default "0" -- NOT IMPLEMENTED

amplitude_addend
<double>, default "0.0" -- NOT IMPLEMENTED

6 properties in this class.


Generated on Tue Aug 9 14:36:25 2005 for simtheticlib by  doxygen 1.4.1