User Manual, Developers Guide and API Documentation

MI2PER.hpp

Go to the documentation of this file.

/*******************************************************************************
 * This file is part of openWNS (open Wireless Network Simulator)
 * _____________________________________________________________________________
 *
 * Copyright (C) 2004-2007
 * Chair of Communication Networks (ComNets)
 * Kopernikusstr. 5, D-52074 Aachen, Germany
 * phone: ++49-241-80-27910,
 * fax: ++49-241-80-22242
 * email: info@openwns.org
 * www: http://www.openwns.org
 * _____________________________________________________________________________
 *
 * openWNS is free software; you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License version 2 as published by the
 * Free Software Foundation;
 *
 * openWNS 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 program.  If not, see <http://www.gnu.org/licenses/>.
 *
 ******************************************************************************/

#ifndef _MI2PER_HPP
#define _MI2PER_HPP

#include <limits.h>
#include <WNS/PyConfigViewCreator.hpp>
#include <WNS/Enum.hpp>
#include <WNS/logger/Logger.hpp>
#include <WNS/container/Registry.hpp>
#include <WNS/container/Mapping.hpp>
#include <WNS/Singleton.hpp>
#include <WNS/pyconfig/View.hpp>

#include <RISE/plmapping/PhyMode.hpp>
#include <RISE/plmapping/CodeRates.hpp>

namespace rise { namespace plmapping {

    namespace tests {
        class MI2PERTest;
        class CoderFullTests;
    }

    typedef std::vector< int > CodeWordLengths;

    class CoderFullSpecification :
        virtual public wns::service::phy::phymode::CoderFullSpecInterface,
        public CoderSpecification // base class
    {
    public:
        CoderFullSpecification(const wns::pyconfig::View&){}
        virtual ~CoderFullSpecification(){}

        virtual double mapMI2PER(double mi, unsigned int blockLength) const = 0;
        virtual double PER2MIB(double per, unsigned int blockLength) const = 0;
    };

    typedef wns::PyConfigViewCreator<CoderFullSpecification> CoderSpecCreator;
    typedef wns::StaticFactory<CoderSpecCreator> CoderSpecFactory;

    class TableCoder :
        public CoderFullSpecification
    {
        friend class tests::MI2PERTest;
        friend class tests::CoderFullTests;

        typedef std::vector< double > LookupTable;
        //typedef wns::container::Registry< int, LookupTable > SizeRegistry;
        typedef std::vector< LookupTable > VectorOfTablesByCWLSize;
    public:
        TableCoder(const wns::pyconfig::View& config);
        virtual ~TableCoder(){}
        virtual double mapMI2PER(double mi, unsigned int blockLength) const;
        virtual double PER2MIB(double per, unsigned int blockLength) const;
    private:
        virtual unsigned int suitableCWL(unsigned int CWL) const;
        virtual const CodeWordLengths& getCWLvector() const;
        virtual unsigned int suitableCWLposition(unsigned int CWL) const;

        unsigned int numberOfCWLs;
        VectorOfTablesByCWLSize vectorOfTablesByCWLSize;
        CodeWordLengths codeWordLengths;
        wns::logger::Logger logger;
    };

    class FormulaCoder :
        public CoderFullSpecification
    {
    public:
        FormulaCoder(const wns::pyconfig::View& config) :
            CoderFullSpecification(config)
        {}

        virtual ~FormulaCoder(){}

        virtual double mapMI2PER(double mi, unsigned int blockLength) const;
        virtual double PER2MIB(double per, unsigned int blockLength) const;
    };

    class CoderFullMapping :
        virtual public wns::service::phy::phymode::CoderFullMappingInterface,
        public CoderMapping
    {
        friend class tests::MI2PERTest;
        friend class tests::CoderFullTests;
    public:
        CoderFullMapping(const wns::pyconfig::View& config);
        virtual ~CoderFullMapping();

        double mapMI2PER(double mi,
                         unsigned int blockLength,
                         Coding coding) const;

        double PER2MIB(double per, unsigned int blockLength, Coding coding) const;

    private:
        virtual bool isConfigured() const;

        /* @brief get coder full specification */
        virtual const CoderFullSpecification&
        getCoderFullSpecification(Coding c) const;

        typedef std::vector< CoderFullSpecification* > CoderFullSpecVector;
        CoderFullSpecVector coderFullSpecVector;

        wns::logger::Logger logger;
    };


    class GENERICM2P :
        virtual public wns::service::phy::phymode::MI2PERMappingInterface
    {
    public:
        GENERICM2P(const wns::pyconfig::View& config);
        virtual ~GENERICM2P(){}

        virtual double mapMI2PER(double mi,
                                 unsigned int blockLength,
                                 Coding coding) const;

    private:
        wns::service::phy::phymode::MI2PERMappingInterface* coderFullMapping;
    };

    typedef GENERICM2P WINNERM2P;

    class FixedM2P :
        virtual public wns::service::phy::phymode::MI2PERMappingInterface
    {
    public:
        explicit FixedM2P(const wns::pyconfig::View& config) :
            fixedPER(config.get<double>("PER"))
        {}
        virtual ~FixedM2P(){}
        virtual double mapMI2PER(double, unsigned int, Coding) const
            {
                return fixedPER;
            }
    private:
        double fixedPER;
    };

    class FormulaM2P :
        virtual public wns::service::phy::phymode::MI2PERMappingInterface
    {
    public:
        explicit FormulaM2P(const wns::pyconfig::View&){}
        virtual ~FormulaM2P(){}
        virtual double mapMI2PER(double, unsigned int, Coding) const
            {
                return 0.0; // TODO
            }
    };

}} // namespaces

#endif //MI2PER_HPP

---