uniform-planar-array.h

Go to the documentation of this file.

/*
 *   Copyright (c) 2020 University of Padova, Dep. of Information Engineering, SIGNET lab.
 *
 *   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 UNIFORM_PLANAR_ARRAY_H
#define UNIFORM_PLANAR_ARRAY_H
 
#include "phased-array-model.h"
 
#include <ns3/object.h>
 
namespace ns3
{
 
class UniformPlanarArray : public PhasedArrayModel
{
  public:
    UniformPlanarArray();
 
    ~UniformPlanarArray() override;
 
    static TypeId GetTypeId();
 
    std::pair<double, double> GetElementFieldPattern(Angles a, uint8_t polIndex = 0) const override;
 
    Vector GetElementLocation(uint64_t index) const override;
 
    bool IsDualPol() const override;
 
    double GetPolSlant() const override;
 
    uint8_t GetNumPols() const override;
 
    size_t GetNumElems() const override;
 
    void SetNumColumns(uint32_t n) override;
 
    uint32_t GetNumColumns() const override;
 
    void SetNumRows(uint32_t n) override;
 
    uint32_t GetNumRows() const override;
 
    void SetNumVerticalPorts(uint16_t nPorts) override;
 
    void SetNumHorizontalPorts(uint16_t nPorts) override;
 
    uint16_t GetNumVerticalPorts() const override;
 
    uint16_t GetNumHorizontalPorts() const override;
 
    uint16_t GetNumPorts() const override;
 
    size_t GetVElemsPerPort() const override;
 
    size_t GetHElemsPerPort() const override;
 
    size_t GetNumElemsPerPort() const override;
 
    uint16_t ArrayIndexFromPortIndex(uint16_t portIndex, uint16_t subElementIndex) const override;
 
    void SetAlpha(double alpha);
 
    void SetBeta(double beta);
 
    void SetPolSlant(double polSlant);
 
    void SetAntennaHorizontalSpacing(double s);
 
    double GetAntennaHorizontalSpacing() const;
 
    void SetAntennaVerticalSpacing(double s);
 
    double GetAntennaVerticalSpacing() const;
 
    void SetDualPol(bool isDualPol);
 
    uint8_t GetElemPol(size_t elemIndex) const override;
 
  private:
    uint32_t m_numColumns{1}; 
    uint32_t m_numRows{1};    
    double m_disV{0.5}; 
    double m_disH{0.5}; 
    double m_alpha{0.0};                          
    double m_cosAlpha{1.0};                       
    double m_sinAlpha{0.0};                       
    double m_beta{0.0};                           
    double m_cosBeta{1.0};                        
    double m_sinBeta{0.0};                        
    double m_polSlant{0.0};                       
    bool m_isDualPolarized{false};                
    uint16_t m_numVPorts{1};                      
    uint16_t m_numHPorts{1};                      
    std::vector<double> m_cosPolSlant{1.0, 0.0};  
    std::vector<double> m_sinPolSlant{0.0, -1.0}; 
};
 
} /* namespace ns3 */
 
#endif /* UNIFORM_PLANAR_ARRAY_H */