demodulator.h

Go to the documentation of this file.

/***************************************************************************
                          demodulator.h  -  description
                             -------------------
    begin                : Mit Mai 22 2002
    copyright            : (C) 2002 by Peter Haase
    email                : mail@p-haase.de
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This library is free software; you can redistribute it and/or         *
 *   modify it under the terms of the GNU Lesser General Public            *
 *   License as published by the Free Software Foundation; either          *
 *   version 2.1 of the License, or (at your option) any later version.    *
 *                                                                         *
 *   This library is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU     *
 *   Lesser General Public License for more details.                       *
 *                                                                         *
 *   You should have received a copy of the GNU Lesser General Public      *
 *   License along with this library; if not, write to the Free Software   *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef DEMODULATION_HEADER
#define DEMODULATION_HEADER

#include <iostream>
#include <fstream>
#include <complex>
#include <vector>
#include <cmath>

#include "signals.h"
#include "misc.h"
#include "phbib.h"
#include "basicdevice.h"
#include "interfaces.h"

#include "modulationschemes.h"
#include "bitmapping.h"

namespace simthlib
{

using simth::Complex;

class Demodulator;


std::ostream& operator<<(std::ostream &os, const Demodulator& demod);



class Demodulator : public simth::Device
{

    simth::SequenceType outputType_;

    //the current snr:
    double snr;

    virtual int getInputLength(int outputLength) const = 0;

  protected:

    simth::SequenceType outputType() const {return outputType_;}

    virtual Complex getComplSymbol(int symbolIndex) const = 0;


    virtual double SNR() const {return snr;}
    virtual void setSNR(double newSNR){snr = newSNR;}

  public:
    Demodulator(int deviceID, simth::DeviceSystemIntf* system, 
        const simth::PropertyList& pl,
        simth::SequenceType outType);

    virtual void updateInputLengths();
    virtual void updateOutputLengths();


    virtual void demodulate(const simth::ModSeq &receivedSym, simth::LlrSeq *correspondingLlrValues,
                            double noise = 0, const simth::ModSeq* trans = NULL) = 0;

    virtual void demodulate(const simth::ModSeq &receivedSym, simth::LlvSeq *correspondingLlvValues,
                            double noise = 0, const simth::ModSeq* trans = NULL ) = 0;

    virtual int getBitsPerSymbol() const = 0;

    virtual int getNumStates() const = 0;

    virtual void process();

    virtual void print(std::ostream &os) const;

    virtual void startOfSimulation();

    static void init(const std::string fileName, simth::Device** dev, simth::DeviceSystemIntf* sysPtr, int ID,
                     const std::string& regionQualifier = "");
};


} // namespace simthlib

#endif

---