mimo-decoder.h

Go to the documentation of this file.

/*-*-c++-*-*****************************************************************
                          mimo-decoder.h  -  description
                             -------------------
    begin                : Mon Feb 23, 2004
    copyright            : (C) 2004 by Christian Stimming
    email                : stimming@tuhh.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 _MIMO_DECODER_H
#define _MIMO_DECODER_H

// libstdc++ includes
#include <iostream>
#include <complex>

// Simthetic includes
#include <simthetic/basicdevice.h>
#include <simthetic/signals.h>
#include <simthetic/misc.h>

// Mimolib includes
#include "matrixseq.h"

namespace mimo
{


class Decoder;
std::ostream& operator<<(std::ostream &os, const Decoder &enc);


class Decoder : public simth::Device
{
  protected:
    unsigned nr_rx;
    unsigned nr_tx;

  public:

    Decoder(int deviceID, simth::DeviceSystemIntf* system,
        const simth::PropertyList& pl);

    virtual ~Decoder();

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

    virtual int getDataLength(int codedLength) const =0;

    virtual int getCodeLength(int rawLength) const =0;

    virtual void Decode(const CVectorSeq& input_vectors,
            const MatrixFreqSignal& channel_estimation,
            simth::ModSeq& output_symbols,
            simth::LlrSeq* output_softout) = 0;


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

    // The factory method init() has been removed because now the
    // object generation is done by the direct factory functions
    // inside DeviceFactory.
};


class SpatialMuxDecZF : public Decoder
{
  public:
    SpatialMuxDecZF(int deviceID, simth::DeviceSystemIntf* system,
            const simth::PropertyList& pl);
    int getDataLength(int codedLength) const 
    { return codedLength*nr_tx; }

    int getCodeLength(int rawLength) const
    { return rawLength/nr_tx; }

    void Decode(const CVectorSeq& input_vectors,
        const MatrixFreqSignal& channel_estimation,
        simth::ModSeq& output_symbols,
        simth::LlrSeq* output_softout);

    static void vectors_to_values(const CVectorSeq& vseq,
                  simth::ModSeq& oseq);
    static void vectors_to_llrvalues(const CVectorSeq& vseq,
                     simth::LlrSeq& oseq);
};

class SpatialMuxDecMMSE : public SpatialMuxDecZF
{
  private:
    double noise;
      
  public:
    SpatialMuxDecMMSE(int deviceID, simth::DeviceSystemIntf* system,
            const simth::PropertyList& pl);

    void Decode(const CVectorSeq& input_vectors,
        const MatrixFreqSignal& channel_estimation,
        simth::ModSeq& output_symbols,
        simth::LlrSeq* output_softout);

    void setSNR(double snr);
};

// ////////////////////////////////////////////////////////////

class STBCAlamoutiDec : public Decoder
{
  private:
    unsigned num_carrier;

  public:
    STBCAlamoutiDec(int deviceID, simth::DeviceSystemIntf* system,
            const simth::PropertyList& pl);
    int getDataLength(int codedLength) const;
    int getCodeLength(int rawLength) const;

    void Decode(const CVectorSeq& input_vectors,
        const MatrixFreqSignal& channel_estimation,
        simth::ModSeq& output_symbols,
        simth::LlrSeq* output_softout);

    void startOfSimulation();
    void updateOutputLengths();
    void updateInputLengths();
};

// ////////////////////////////////////////

class SVDDec : public Decoder
{
  private:
    unsigned nr_dim;
  public:
      
    SVDDec(int deviceID, simth::DeviceSystemIntf* system,
       const simth::PropertyList& pl);
    int getDataLength(int codedLength) const;
    
    int getCodeLength(int rawLength) const;
    
    void Decode(const CVectorSeq& input_vectors,
        const MatrixFreqSignal& channel_estimation,
        simth::ModSeq& output_symbols,
        simth::LlrSeq* output_softout);
};

} // namespace

#endif // _MIMO_DECODER_H

---