three-gpp-antenna-model.cc

Go to the documentation of this file.

/*
 * Copyright (c) 2020 University of Padova, Dep. of Information Engineering, SIGNET lab.
 *
 * SPDX-License-Identifier: GPL-2.0-only
 */
 
#include "three-gpp-antenna-model.h"
 
#include "antenna-model.h"
 
#include "ns3/double.h"
#include "ns3/enum.h"
#include "ns3/log.h"
 
#include <cmath>
 
namespace ns3
{
 
NS_LOG_COMPONENT_DEFINE("ThreeGppAntennaModel");
 
NS_OBJECT_ENSURE_REGISTERED(ThreeGppAntennaModel);
 
TypeId
ThreeGppAntennaModel::GetTypeId()
{
    static TypeId tid =
        TypeId("ns3::ThreeGppAntennaModel")
            .SetParent<AntennaModel>()
            .SetGroupName("Antenna")
            .AddConstructor<ThreeGppAntennaModel>()
            .AddAttribute(
                "RadiationPattern",
                "Radiation pattern of 3GPP antenna model",
                EnumValue<RadiationPattern>(RadiationPattern::OUTDOOR),
                MakeEnumAccessor<RadiationPattern>(&ThreeGppAntennaModel::SetRadiationPattern,
                                                   &ThreeGppAntennaModel::GetRadiationPattern),
                MakeEnumChecker<RadiationPattern>(RadiationPattern::OUTDOOR,
                                                  "Outdoor",
                                                  RadiationPattern::INDOOR,
                                                  "Indoor"));
    return tid;
}
 
ThreeGppAntennaModel::ThreeGppAntennaModel()
{
    SetRadiationPattern(RadiationPattern::OUTDOOR);
}
 
void
ThreeGppAntennaModel::DoInitialize()
{
    NS_LOG_FUNCTION(this);
    SetRadiationPattern(m_radiationPattern);
}
 
ThreeGppAntennaModel::~ThreeGppAntennaModel()
{
}
 
double
ThreeGppAntennaModel::GetVerticalBeamwidth() const
{
    return m_verticalBeamwidthDegrees;
}
 
double
ThreeGppAntennaModel::GetHorizontalBeamwidth() const
{
    return m_horizontalBeamwidthDegrees;
}
 
void
ThreeGppAntennaModel::SetRadiationPattern(RadiationPattern pattern)
{
    m_radiationPattern = pattern;
    switch (pattern)
    {
    case RadiationPattern::OUTDOOR:
        SetOutdoorAntennaPattern();
        break;
    case RadiationPattern::INDOOR:
        SetIndoorAntennaPattern();
        break;
    default:
        NS_ABORT_MSG("Unknown radiation pattern");
    }
}
 
ThreeGppAntennaModel::RadiationPattern
ThreeGppAntennaModel::GetRadiationPattern() const
{
    return m_radiationPattern;
}
 
void
ThreeGppAntennaModel::SetOutdoorAntennaPattern()
{
    m_verticalBeamwidthDegrees = 65;
    m_horizontalBeamwidthDegrees = 65;
    m_aMax = 30;
    m_slaV = 30;
    m_geMax = 8;
}
 
void
ThreeGppAntennaModel::SetIndoorAntennaPattern()
{
    m_verticalBeamwidthDegrees = 90;
    m_horizontalBeamwidthDegrees = 90;
    m_aMax = 25;
    m_slaV = 25;
    m_geMax = 5;
}
 
double
ThreeGppAntennaModel::GetSlaV() const
{
    return m_slaV;
}
 
double
ThreeGppAntennaModel::GetMaxAttenuation() const
{
    return m_aMax;
}
 
double
ThreeGppAntennaModel::GetAntennaElementGain() const
{
    return m_geMax;
}
 
double
ThreeGppAntennaModel::GetGainDb(Angles a)
{
    NS_LOG_FUNCTION(this << a);
 
    double phiDeg = RadiansToDegrees(a.GetAzimuth());
    double thetaDeg = RadiansToDegrees(a.GetInclination());
 
    NS_ASSERT_MSG(-180.0 <= phiDeg && phiDeg <= 180.0, "Out of boundaries: phiDeg=" << phiDeg);
    NS_ASSERT_MSG(0.0 <= thetaDeg && thetaDeg <= 180.0, "Out of boundaries: thetaDeg=" << thetaDeg);
 
    // compute the radiation power pattern using equations in table 7.3-1 in
    // 3GPP TR 38.901
    double vertGain = -std::min(m_slaV,
                                12 * pow((thetaDeg - 90) / m_verticalBeamwidthDegrees,
                                         2)); // vertical cut of the radiation power pattern (dB)
    double horizGain = -std::min(m_aMax,
                                 12 * pow(phiDeg / m_horizontalBeamwidthDegrees,
                                          2)); // horizontal cut of the radiation power pattern (dB)
 
    double gainDb =
        m_geMax - std::min(m_aMax, -(vertGain + horizGain)); // 3D radiation power pattern (dB)
 
    NS_LOG_DEBUG("gain=" << gainDb << " dB");
    return gainDb;
}
 
} // namespace ns3