three-gpp-spectrum-propagation-loss-model.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015, NYU WIRELESS, Tandon School of Engineering,
 * New York University
 * Copyright (c) 2019 SIGNET Lab, Department of Information Engineering,
 * University of Padova
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
 
#ifndef THREE_GPP_SPECTRUM_PROPAGATION_LOSS_H
#define THREE_GPP_SPECTRUM_PROPAGATION_LOSS_H
 
#include "matrix-based-channel-model.h"
#include "phased-array-spectrum-propagation-loss-model.h"
 
#include "ns3/random-variable-stream.h"
 
#include <complex.h>
#include <map>
#include <unordered_map>
 
class ThreeGppCalcLongTermMultiPortTest;
class ThreeGppMimoPolarizationTest;
 
namespace ns3
{
 
class NetDevice;
 
class ThreeGppSpectrumPropagationLossModel : public PhasedArraySpectrumPropagationLossModel
{
    friend class ::ThreeGppCalcLongTermMultiPortTest;
    friend class ::ThreeGppMimoPolarizationTest;
 
  public:
    ThreeGppSpectrumPropagationLossModel();
 
    ~ThreeGppSpectrumPropagationLossModel() override;
 
    void DoDispose() override;
 
    static TypeId GetTypeId();
 
    void SetChannelModel(Ptr<MatrixBasedChannelModel> channel);
 
    Ptr<MatrixBasedChannelModel> GetChannelModel() const;
 
    void SetChannelModelAttribute(const std::string& name, const AttributeValue& value);
 
    void GetChannelModelAttribute(const std::string& name, AttributeValue& value) const;
 
    Ptr<SpectrumSignalParameters> DoCalcRxPowerSpectralDensity(
        Ptr<const SpectrumSignalParameters> spectrumSignalParams,
        Ptr<const MobilityModel> a,
        Ptr<const MobilityModel> b,
        Ptr<const PhasedArrayModel> aPhasedArrayModel,
        Ptr<const PhasedArrayModel> bPhasedArrayModel) const override;
 
  protected:
    struct LongTerm : public SimpleRefCount<LongTerm>
    {
        Ptr<const MatrixBasedChannelModel::Complex3DVector>
            m_longTerm; 
        Ptr<const MatrixBasedChannelModel::ChannelMatrix>
            m_channel; 
        PhasedArrayModel::ComplexVector
            m_sW; 
        PhasedArrayModel::ComplexVector
            m_uW; 
    };
 
    Ptr<MatrixBasedChannelModel::Complex3DVector> GenSpectrumChannelMatrix(
        Ptr<SpectrumValue> inPsd,
        Ptr<const MatrixBasedChannelModel::Complex3DVector> longTerm,
        Ptr<const MatrixBasedChannelModel::ChannelMatrix> channelMatrix,
        Ptr<const MatrixBasedChannelModel::ChannelParams> channelParams,
        PhasedArrayModel::ComplexVector doppler,
        uint8_t numTxPorts,
        uint8_t numRxPorts,
        bool isReverse) const;
 
    double GetFrequency() const;
 
    Ptr<const MatrixBasedChannelModel::Complex3DVector> GetLongTerm(
        Ptr<const MatrixBasedChannelModel::ChannelMatrix> channelMatrix,
        Ptr<const PhasedArrayModel> aPhasedArrayModel,
        Ptr<const PhasedArrayModel> bPhasedArrayModel) const;
    Ptr<const MatrixBasedChannelModel::Complex3DVector> CalcLongTerm(
        Ptr<const MatrixBasedChannelModel::ChannelMatrix> channelMatrix,
        Ptr<const PhasedArrayModel> sAnt,
        Ptr<const PhasedArrayModel> uAnt) const;
 
    std::complex<double> CalculateLongTermComponent(
        Ptr<const MatrixBasedChannelModel::ChannelMatrix> params,
        Ptr<const PhasedArrayModel> sAnt,
        Ptr<const PhasedArrayModel> uAnt,
        uint16_t sPortIdx,
        uint16_t uPortIdx,
        uint16_t cIndex) const;
 
    Ptr<SpectrumSignalParameters> CalcBeamformingGain(
        Ptr<const SpectrumSignalParameters> params,
        Ptr<const MatrixBasedChannelModel::Complex3DVector> longTerm,
        Ptr<const MatrixBasedChannelModel::ChannelMatrix> channelMatrix,
        Ptr<const MatrixBasedChannelModel::ChannelParams> channelParams,
        const Vector& sSpeed,
        const Vector& uSpeed,
        uint8_t numTxPorts,
        uint8_t numRxPorts,
        bool isReverse) const;
 
    int64_t DoAssignStreams(int64_t stream) override;
 
    mutable std::unordered_map<uint64_t, Ptr<const LongTerm>>
        m_longTermMap;                           
    Ptr<MatrixBasedChannelModel> m_channelModel; 
};
} // namespace ns3
 
#endif /* THREE_GPP_SPECTRUM_PROPAGATION_LOSS_H */