Cosine antenna element
The CosineAntennaElement object models an antenna with a cosine response in both azimuth and elevation.
To compute the response of the antenna element for specified directions:
Define and set up your cosine antenna element. See Construction.
Call step to compute the antenna response according to the properties of phased.CosineAntennaElement. The behavior of step is specific to each object in the toolbox.
This antenna element is not capable of supporting polarization.
H = phased.CosineAntennaElement creates a cosine antenna system object, H, that models an antenna element whose response is cosine raised to a specified power greater than or equal to one in both the azimuth and elevation directions.
H = phased.CosineAntennaElement(Name,Value) creates a cosine antenna object, H, with each specified property set to the specified value. You can specify additional name-value pair arguments in any order as (Name1,Value1,...,NameN,ValueN).
Operating frequency range
Specify the operating frequency range (in Hz) of the antenna element as a 1-by-2 row vector in the form [LowerBound HigherBound]. The antenna element has no response outside the specified frequency range.
Default: [0 1e20]
Exponent of cosine pattern
Specify the exponent of cosine pattern as a scalar or a 1-by-2 vector. All specified values must be real numbers greater than or equal to 1. When you set CosinePower to a scalar, both the azimuth direction cosine pattern and the elevation direction cosine pattern are raised to the specified value. When you set CosinePower to a 1-by-2 vector, the first element is the exponent for the azimuth direction cosine pattern and the second element is the exponent for the elevation direction cosine pattern.
Default: [1.5 1.5]
|clone||Create cosine antenna object with same property values|
|getNumInputs||Number of expected inputs to step method|
|getNumOutputs||Number of outputs from step method|
|isLocked||Locked status for input attributes and nontunable properties|
|plotResponse||Plot response pattern of antenna|
|release||Allow property value and input characteristics changes|
|step||Output response of antenna element|
The cosine response, or cosine pattern, is given by:
In this expression:
az is the azimuth angle.
el is the elevation angle.
The exponents m and n are real numbers greater than or equal to 1.
The response is defined for azimuth and elevation angles between –90 and 90 degrees, inclusive. There is no response at the back of a cosine antenna. The cosine response pattern achieves a maximum value of 1 at 0 degrees azimuth and elevation. Raising the response pattern to powers greater than one concentrates the response in azimuth or elevation.
This example shows how to construct a cosine pattern antenna and calculate its response at boresight (0 degrees azimuth and 0 degrees elevation). Assume the antenna works between 800 MHz and 1.2 GHz and its operating frequency is 1 GHz.
ha = phased.CosineAntennaElement('FrequencyRange',... [800e6 1.2e9]); resp = step(ha,1e9,[0; 0]); plotResponse(ha,1e9,'RespCut','El','Format','Polar');