User Manual, Developers Guide and API Documentation

SignalAveragingStrategy.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 __SIGNALAVERAGINGSTRATEGY_HPP
#define __SIGNALAVERAGINGSTRATEGY_HPP


#include <RISE/transceiver/transmitter.hpp>

#include <WNS/simulator/ISimulator.hpp>
#include <WNS/events/scheduler/Interface.hpp>

#include <WNS/Assure.hpp>
#include <WNS/PowerRatio.hpp>
#include <WNS/TimeWeightedAverage.hpp>
#include <WNS/Birthmark.hpp>

#include <map>

namespace rise { namespace receiver {
    class PathlossCalculationInterface
    {
    public:
        virtual ~PathlossCalculationInterface() {}

    protected:
        virtual wns::Ratio getLoss(Transmitter* t, double frequency) = 0;
    };

    class SignalCalculationInterface
    {
    public:
        virtual wns::Power getRxPower(const TransmissionObjectPtr& t) = 0; // implemented in rise::Receiver
        virtual ~SignalCalculationInterface() {}
    };


    class InterferenceCalculationInterface
    {
    public:
        virtual wns::Power getInterference(const TransmissionObjectPtr& t) = 0;
        virtual ~InterferenceCalculationInterface() {}
    };

    class TransmissionAveragingStrategy :
        virtual public SignalCalculationInterface,
        virtual public InterferenceCalculationInterface
    {
    public:
        virtual ~TransmissionAveragingStrategy()
        {}

        virtual void signalLevelsChange() = 0;

        virtual void endOfTransmission(const TransmissionObjectPtr& t) = 0;

        virtual void add(const TransmissionObjectPtr& t) = 0;

        virtual void remove(const TransmissionObjectPtr& t) = 0;

        virtual void removeAll() = 0;

        virtual wns::Power getAveragedRxPower(const TransmissionObjectPtr& t) = 0;

        virtual wns::Power getAveragedInterference(const TransmissionObjectPtr& t) = 0;

        virtual wns::Ratio getAveragedCIR(const TransmissionObjectPtr& t) = 0;
    };

    class NoTransmissionAveraging :
        virtual public TransmissionAveragingStrategy
    {
        typedef std::map<wns::Birthmark, std::pair<TransmissionObjectPtr, wns::Power> > CurrentSignalMap;
        typedef std::map<wns::Birthmark, std::pair<TransmissionObjectPtr, bool> > CalledEndOfTransmission;
    public:
        NoTransmissionAveraging();
        virtual ~NoTransmissionAveraging();

        // TransmissionAveragingStrategy interface
        virtual void signalLevelsChange();
        virtual void endOfTransmission(const TransmissionObjectPtr& t);
        virtual void add(const TransmissionObjectPtr& t);
        virtual void remove(const TransmissionObjectPtr& t);
        virtual void removeAll();
        virtual wns::Power getAveragedRxPower(const TransmissionObjectPtr& t);
        virtual wns::Power getAveragedInterference(const TransmissionObjectPtr& t);
        virtual wns::Ratio getAveragedCIR(const TransmissionObjectPtr& t);
    private:
        CurrentSignalMap carrier;
        CurrentSignalMap interference;
        CalledEndOfTransmission calledEOT;
        simTimeType lastAveraging;
    };

    class TimeWeightedTransmissionAveraging :
        virtual public TransmissionAveragingStrategy
    {
        typedef wns::TimeWeightedAverage<wns::Power, wns::events::scheduler::Interface> SignalAverage;
        typedef std::map<wns::Birthmark, std::pair<TransmissionObjectPtr, SignalAverage> > AveragedSignalMap;
        typedef std::map<wns::Birthmark, std::pair<TransmissionObjectPtr, bool> > CalledEndOfTransmission;
    public:
        TimeWeightedTransmissionAveraging();
        virtual ~TimeWeightedTransmissionAveraging();

        // TransmissionAveragingStrategy interface
        virtual void signalLevelsChange();
        virtual void endOfTransmission(const TransmissionObjectPtr& t);
        virtual void add(const TransmissionObjectPtr& t);
        virtual void remove(const TransmissionObjectPtr& t);
        virtual void removeAll();
        virtual wns::Power getAveragedRxPower(const TransmissionObjectPtr& t);
        virtual wns::Power getAveragedInterference(const TransmissionObjectPtr& t);
        virtual wns::Ratio getAveragedCIR(const TransmissionObjectPtr& t);

    private:
        AveragedSignalMap carrier;
        AveragedSignalMap interference;
        CalledEndOfTransmission calledEOT;
        simTimeType lastAveraging;
    };
}}
#endif // not defined __SIGNALAVERAGINGSTRATEGY_HPP

---