User Manual, Developers Guide and API Documentation

Antenna.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_ANTENNA_ANTENNA_HPP
#define RISE_ANTENNA_ANTENNA_HPP

#include <RISE/misc/RISELogger.hpp>
#include <WNS/SmartPtr.hpp>
#include <WNS/Position.hpp>
#include <WNS/PositionObserver.hpp>
#include <WNS/PowerRatio.hpp>
#include <WNS/service/phy/ofdma/Pattern.hpp>
#include <WNS/Observer.hpp>
#include <set>

namespace rise {
    class Station;
}

namespace rise { namespace antenna {

    class Beamforming;

    typedef wns::service::phy::ofdma::PatternPtr PatternPtr;
    typedef wns::service::phy::ofdma::Pattern Pattern;


    class Antenna :
        public wns::Observer<wns::PositionObserver>
    {
    public:

        Antenna();

        Antenna(const wns::pyconfig::View& pyConfigView,
                Station* const station);

        virtual ~Antenna();

        virtual wns::Ratio getGain(const wns::Position& pos,
                                   const PatternPtr pattern) const = 0;

        // inlined for performance
        const wns::Position& getPosition() const
        {
                return position;
        }

        Station* getStation() const;

        void positionWillChange()
        {};

        void positionChanged();

    protected:

        RISELogger log;

        double radius;

        bool drawPattern;

        virtual void drawRadiationPattern() const;

        std::string patternOutputFile;
    private:

        void preparePatternOutputFile();

        Station* pd_station;

        wns::PositionOffset pd_positionOffset;

        wns::Position position;

        unsigned long int id;

        static unsigned long int counter;

        static std::set<std::string> patternOutputFilePrepared;
    };
}
}
#endif  // _ANTENNA_HPP

---