User Manual, Developers Guide and API Documentation

PhyModeMapper.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 RISE_PLMAPPING_PHYMODEMAPPER_HPP
#define RISE_PLMAPPING_PHYMODEMAPPER_HPP

#include <string>
#include <vector>
#include <WNS/PowerRatio.hpp>
#include <WNS/Interval.hpp>
#include <WNS/container/Registry.hpp>
#include <WNS/container/RangeMap.hpp>
#include <WNS/StaticFactory.hpp>
#include <WNS/pyconfig/View.hpp>
#include <WNS/service/phy/phymode/PhyModeInterface.hpp>
#include <WNS/service/phy/phymode/PhyModeMapperInterface.hpp>

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

//namespace wns { namespace service { namespace phy { namespace phymode {
namespace rise { namespace plmapping {

        class PhyModeMapper :
            public virtual wns::service::phy::phymode::PhyModeMapperInterface // in libwns
        {
        public:
            typedef wns::SmartPtr<PhyMode> PhyModePtr;
            typedef std::vector< PhyModePtr > PhyModeVector;

        private:
            unsigned int subCarriersPerSubChannel;
            simTimeType symbolDuration;
            unsigned int phyModeCount;
            double minimumSINR;

            PhyModeVector phyModeVector;

            typedef wns::container::RangeMap<double, unsigned int> PhyModeRangeMap;

            PhyModeRangeMap phyModeRangeMap;

            typedef wns::container::Registry< PhyMode, wns::service::phy::phymode::SINRRange > PhyModeSINRRangeRegistry;

            PhyModeSINRRangeRegistry phyModeSINRRangeRegistry;

            wns::service::phy::phymode::MI2PERMappingInterface* mi2perMapper;
            wns::service::phy::phymode::SNR2MIInterface* SNR2MImapper;
            wns::logger::Logger logger;

        public:
            // Constructor
            PhyModeMapper(const wns::pyconfig::View& config);

            virtual ~PhyModeMapper() {}

            virtual wns::service::phy::phymode::PhyModeInterfacePtr
            getBestPhyMode(const wns::Ratio& sinr) const;

            //virtual wns::SmartPtr<const wns::service::phy::phymode::PhyModeInterface>
            virtual wns::service::phy::phymode::PhyModeInterfacePtr
            getBestPhyMode(double sinr /* dB */) const;

            int
            getBestPhyModeIndex(double sinr /* dB */) const;

            virtual wns::Ratio
            getMinSINRRatio(const wns::service::phy::phymode::PhyModeInterfacePtr phyMode) const;

            virtual double
            getMinSINR(const wns::service::phy::phymode::PhyModeInterfacePtr phyMode) const;

            virtual wns::service::phy::phymode::SINRRange
            getSINRRange(const wns::service::phy::phymode::PhyModeInterfacePtr phyMode) const;

            //virtual wns::SmartPtr<const wns::service::phy::phymode::PhyModeInterface>
            virtual const wns::service::phy::phymode::PhyModeInterfacePtr
            getHighestPhyMode() const;

            //virtual wns::SmartPtr<const wns::service::phy::phymode::PhyModeInterface>
            virtual const wns::service::phy::phymode::PhyModeInterfacePtr
            getLowestPhyMode() const;

            virtual int
            getPhyModeCount() const;

            virtual PhyModeVector
            getListOfPhyModes() const;

            virtual const std::vector< wns::service::phy::phymode::PhyModeInterfacePtr >
            getListOfPhyModePtr() const;

            virtual wns::service::phy::phymode::PhyModeInterfacePtr
            getPhyModeForIndex(int index) const;

            virtual int
            getIndexForPhyMode(const wns::service::phy::phymode::PhyModeInterface& phyMode) const;

            virtual double getMinimumSINR() const { return minimumSINR; };

            virtual bool sinrIsAboveLimit(double sinr /* dB */) const { return (sinr>=minimumSINR); };
            virtual bool sinrIsAboveLimit(const wns::Ratio& sinr) const { return (sinr.get_dB()>=minimumSINR); };

            virtual void
            calculateSINRRanges(double targetPER, unsigned int bl);

            std::string
            printSwitchingPoints() const;

            std::string
            printPhyModeNames() const;

        protected:
            virtual void setMinimumSINR(double sinr) { minimumSINR=sinr; }
            //virtual const rise::plmapping::PhyModeSINRRangeRegistry&
            //getPhyModeSINRRangeRegistry() const;
        };

}}
//}}}}

#endif // RISE_PLMAPPING_PHYMODEMAPPER_HPP

---