Models a hypotetical antenna with a cosine-based radiation pattern. This antenna model is commonly used in the real world to approximate various directional antennas.

Gain is computed from the angle as follows:

  exponent = -3 / (20 * log10(cos(beamWidth) / 4))
  gain = maxGain * abs(cos(angle / 2)) ^ exponent

This module represents the cosine antenna model found in

Li Chunjian, "Efficient Antenna Patterns for Three-Sector WCDMA Systems", eq. B.1 and B.2

Inheritance diagram

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Extends

Name	Type	Description
AntennaBase	compound module	This module servces as the base module for antenna models.

Parameters

Name	Type	Default value	Description
mobilityModule	string		the path to the mobility module relative to this module, only used if no mobility submodule is present
numAntennas	int	1	the number of antennas in the antenna array
maxGain	double		gain at the antenna boresight
beamWidth	double		3dB beam width

Properties

Name	Value	Description
display	i=device/antennatower
class	CosineAntenna

Source code

//
// Models a hypotetical antenna with a cosine-based radiation pattern.
// This antenna model is commonly used in the real world to approximate
// various directional antennas.
//
// Gain is computed from the angle as follows:
// <pre>
//   exponent = -3 / (20 * log10(cos(beamWidth) / 4))
//   gain = maxGain * abs(cos(angle / 2)) ^ exponent
// </pre>
// This module represents the cosine antenna model found in
//
// Li Chunjian, "Efficient Antenna Patterns for Three-Sector WCDMA Systems",
// eq. B.1 and B.2
//
module CosineAntenna extends AntennaBase
{
    parameters:
        double maxGain @unit(dB);    // gain at the antenna boresight
        double beamWidth @unit(deg); // 3dB beam width
        @class(CosineAntenna);
}

File: src/inet/physicallayer/wireless/common/antenna/CosineAntenna.ned

---

This documentation is released under the Creative Commons license