EngeePhased.ShortDipoleAntennaElement
A dipole antenna.
| Library |
|
Description
System object EngeePhased.ShortDipoleAntennaElement simulates an element of a dipole antenna. A dipole antenna is a centrally powered wire that is much shorter than one wavelength. This antenna object supports only polarized fields.
To create and use a dipole antenna, follow these steps:
-
Create an object EngeePhased.ShortDipoleAntennaElement and set its properties.
-
Call the object with arguments as if it were a function.
To learn more about how to work with system objects, see Engee System Objects.
Syntax
Creation
-
antenna = EngeePhased.ShortDipoleAntennaElement()— creates a dipole antenna with default property values. -
antenna = EngeePhased.ShortDipoleAntennaElement(Name=Value)— creates a dipole antenna with specified properties in the form of a pairName=Value, whereName— the name of the property, andValue— the appropriate value. You can specify multiple pairs «name-value» the order of the pairs does not matter. Unspecified properties retain their default values.
Using
-
RESP = antenna(FREQ,ANG)— returns the antenna radiation pattern RESP. The RESP tuple contains two RESP fields.H and RESP.V, representing the antenna pattern in horizontal and vertical polarization, respectively. Each field is a matrix on , containing a radiation pattern of the antenna at the operating frequencies FREQ in the directions ANG.
Arguments
Input arguments
FREQ — the operating frequencies of the antenna element
+
scalar | vector is a string of length L
Details
The antenna’s operating frequencies, specified as a real positive scalar or a real vector, are strings of length containing positive numbers.
Typical values are in the range FrequencyRange.
Otherwise, the element does not have a directional pattern and returns it as −Inf.
The units of measurement are Hz.
| Типы данных |
|
ANG — azimuth angle and angle of the radiation pattern location
+
vector is a string of length M | the 2 by M matrix
Details
The directions of the radiation pattern, specified as a real vector, are strings of length or a real matrix on .
If ANG is a matrix, then each column defines a direction in the form [azimuth; elevation]. The azimuth angle should be in the range of −180° before 180° inclusive. The angle of the seat should be in the range of −180° before 180° inclusive.
If ANG is a string vector, each element sets the azimuth angle of the direction. In this case, the corresponding seat angle is assumed to be 0°.
The units of measurement are degrees.
For more information about the azimuth angle and the location angle, see Azimuthal angles and location angles.
| Типы данных |
|
Features
# FrequencyRange — operating frequency range
+
[0.0 1.0e20] (by default) | A non-negative real vector is a 1 by 2 row
Details
The operating frequency range of the antenna, set as a non-negative real vector on in the format [LowerBound HigherBound]. The antenna element does not have a radiation pattern outside the specified frequency range.
The units of measurement are Hz.
# AxisDirection — direction of the dipole axis
+
"Z" (by default) | "Y" | "X" | "Custom"
Details
The direction of the dipole axis, given as "X", "Y", "Z" or "Custom".
The dipole axis determines the direction of the dipole current relative to the local coordinate system: "X" sets the dipole along the axis , Y — along the axis , and "Z" — along the axis . Direction along the axis or is equivalent to a horizontal dipole, and the direction along the axis is — vertical dipole.
If you set the AxisDirection property to "Custom", then you can manually specify the dipole axis using the CustomAxisDirection property.
# CustomAxisDirection — custom dipole axis direction
+
[0;0;1] (by default) | The real vector is a 1 by 3 column
Details
The user-defined direction of the dipole antenna axis, defined as a real column vector on . Each entry in the vector represents a component of the dipole axis along the axes , , and in the local coordinate system.
Dependencies
To use this property, set the AxisDirection property to "Custom".