antenna::H5Antenna Class Reference

Represents an antenna whose gain pattern is loaded from a HDF5 file. More...

#include "antenna_factory.h"

Inheritance diagram for antenna::H5Antenna:

Collaboration diagram for antenna::H5Antenna:

Public Member Functions
	H5Antenna (const std::string_view name, const std::string &filename)
	Constructs a H5Antenna with the specified name and gain pattern file.
	~H5Antenna () override=default
	H5Antenna (const H5Antenna &)=delete
H5Antenna &	operator= (const H5Antenna &)=delete
	H5Antenna (H5Antenna &&)=delete
H5Antenna &	operator= (H5Antenna &&)=delete
RealType	getGain (const math::SVec3 &angle, const math::SVec3 &refangle, RealType) const override
	Computes the gain of the antenna based on the input angle and reference angle.
const std::string &	getFilename () const noexcept
	Gets the filename of the antenna description.
const std::vector< std::vector< RealType > > &	getPattern () const noexcept
	Gets the gain pattern object.
RealType	getEfficiencyFactor () const noexcept
	Retrieves the efficiency factor of the antenna.
std::string	getName () const noexcept
	Retrieves the name of the antenna.
virtual RealType	getNoiseTemperature (const math::SVec3 &) const noexcept
	Computes the noise temperature of the antenna based on the angle.
void	setEfficiencyFactor (RealType loss) noexcept
	Sets the efficiency factor of the antenna.

Static Protected Member Functions
static RealType	getAngle (const math::SVec3 &angle, const math::SVec3 &refangle) noexcept
	Computes the angle between the input and reference angles.

Detailed Description

Represents an antenna whose gain pattern is loaded from a HDF5 file.

This class models an antenna with a gain pattern defined in an HDF5 file. The gain pattern is stored in a Pattern object, which is used to compute the antenna's gain based on the input angle and reference angle.

Definition at line 436 of file antenna_factory.h.

Constructor & Destructor Documentation

H5Antenna() [1/3]

antenna::H5Antenna::H5Antenna	(	const std::string_view	name,
		const std::string &	filename
	)

Constructs a H5Antenna with the specified name and gain pattern file.

Parameters

name	The name of the antenna.
filename	The path to the file containing the antenna's gain pattern.

Definition at line 445 of file antenna_factory.h.

                                                                        :
            Antenna(name.data()), _pattern(serial::readPattern(filename, "antenna")), _filename(filename)
        {
        }

~H5Antenna()

antenna::H5Antenna::~H5Antenna ( )

overridedefault

H5Antenna() [2/3]

antenna::H5Antenna::H5Antenna ( const H5Antenna &  )

delete

H5Antenna() [3/3]

antenna::H5Antenna::H5Antenna ( H5Antenna &&  )

delete

Member Function Documentation

getAngle()

RealType antenna::Antenna::getAngle ( const math::SVec3 &  angle, const math::SVec3 &  refangle  )

staticprotectednoexceptinherited

Computes the angle between the input and reference angles.

Parameters

angle	The input angle.
refangle	The reference angle.

Returns

The computed angle.

Definition at line 93 of file antenna_factory.cpp.

    {
        SVec3 normangle(angle);
        normangle.length = 1;
        return std::acos(dotProduct(Vec3(normangle), Vec3(refangle)));
    }

References math::SVec3::length.

getEfficiencyFactor()

RealType antenna::Antenna::getEfficiencyFactor ( ) const

noexceptinherited

Retrieves the efficiency factor of the antenna.

Returns

The efficiency factor of the antenna.

Definition at line 73 of file antenna_factory.h.

{ return _loss_factor; }

Referenced by antenna::Isotropic::getGain(), antenna::XmlAntenna::getGain(), getGain(), and antenna::to_json().

Here is the caller graph for this function:

getFilename()

const std::string & antenna::H5Antenna::getFilename ( ) const

noexcept

Gets the filename of the antenna description.

Definition at line 471 of file antenna_factory.h.

{ return _filename; }

getGain()

RealType antenna::H5Antenna::getGain ( const math::SVec3 &  angle, const math::SVec3 &  refangle, RealType    ) const

overridevirtual

Computes the gain of the antenna based on the input angle and reference angle.

Parameters

angle	The angle at which the gain is to be computed.
refangle	The reference angle.

Returns

The gain of the antenna at the specified angle.

Implements antenna::Antenna.

Definition at line 163 of file antenna_factory.cpp.

    {
        constexpr RealType two_pi = 2.0 * PI;
 
        const SVec3& pattern_angle = angle - refangle;
 
        const double ex1 = (pattern_angle.azimuth + PI) / two_pi;
        const double ey1 = (pattern_angle.elevation + PI) / two_pi;
 
        const auto calc_grid_point = [](const double value, const unsigned size)
        {
            const double x1 = std::floor(value * (size - 1)) / (size - 1);
            const double x2 = std::min(x1 + 1.0 / size, 1.0);
            return std::pair{x1, x2};
        };
 
        unsigned size_azi = _pattern.size();
        unsigned size_elev = _pattern[0].size();
 
        LOG(logging::Level::TRACE, "Size of pattern: {} x {}", size_azi, size_elev);
 
        const auto [x1, x2] = calc_grid_point(ex1, size_azi);
        const auto [y1, y2] = calc_grid_point(ey1, size_elev);
 
        const double t = (ex1 - x1) / (x2 - x1);
        const double u = (ey1 - y1) / (y2 - y1);
 
        const auto calc_array_index = [](const double value, const unsigned size)
        { return std::min(static_cast<unsigned>(std::floor(value * size)), size - 1); };
 
        const unsigned arr_x = calc_array_index(x1, size_azi);
        const unsigned arr_y = calc_array_index(y1, size_elev);
 
        const RealType interp = (1.0 - t) * (1.0 - u) * _pattern[arr_x][arr_y] +
            t * (1.0 - u) * _pattern[(arr_x + 1) % size_azi][arr_y] +
            t * u * _pattern[(arr_x + 1) % size_azi][(arr_y + 1) % size_elev] +
            (1.0 - t) * u * _pattern[arr_x][(arr_y + 1) % size_elev];
 
        return interp * getEfficiencyFactor();
    }

References math::SVec3::azimuth, math::SVec3::elevation, antenna::Antenna::getEfficiencyFactor(), LOG, PI, and logging::TRACE.

Here is the call graph for this function:

getName()

std::string antenna::Antenna::getName ( ) const

noexceptinherited

Retrieves the name of the antenna.

Returns

The name of the antenna.

Definition at line 80 of file antenna_factory.h.

{ return _name; }

Referenced by antenna::to_json(), radar::to_json(), and radar::to_json().

Here is the caller graph for this function:

getNoiseTemperature()

virtual RealType antenna::Antenna::getNoiseTemperature ( const math::SVec3 &  ) const

virtualnoexceptinherited

Computes the noise temperature of the antenna based on the angle.

Parameters

angle

The angle at which the noise temperature is to be computed.

Returns

The noise temperature of the antenna.

Definition at line 89 of file antenna_factory.h.

{ return 0; }

getPattern()

const std::vector< std::vector< RealType > > & antenna::H5Antenna::getPattern ( ) const

noexcept

Gets the gain pattern object.

Definition at line 474 of file antenna_factory.h.

{ return _pattern; }

operator=() [1/2]

H5Antenna & antenna::H5Antenna::operator= ( const H5Antenna &  )

delete

operator=() [2/2]

H5Antenna & antenna::H5Antenna::operator= ( H5Antenna &&  )

delete

setEfficiencyFactor()

void antenna::Antenna::setEfficiencyFactor ( RealType  loss )

noexceptinherited

Sets the efficiency factor of the antenna.

Parameters

loss	The new efficiency factor.

Definition at line 84 of file antenna_factory.cpp.

    {
        if (loss > 1)
        {
            LOG(Level::INFO, "Using greater than unity antenna efficiency.");
        }
        _loss_factor = loss;
    }

References LOG.

---

The documentation for this class was generated from the following files:

• packages/libfers/src/antenna/antenna_factory.h
• packages/libfers/src/antenna/antenna_factory.cpp