EngeePhased.ShortDipoleAntennaElement
Short Dipole Antenna Element.
Library |
EngeePhased |
Description
The EngeePhased.ShortDipoleAntennaElement system object models a short-dipole antenna element. A short-dipole antenna is a centre-fed wire that is much shorter than one wavelength. This antenna object supports only polarised fields.
To calculate the response of the antenna element for given directions, follow these steps:
-
Create an EngeePhased.ShortDipoleAntennaElement object and set its properties.
-
Call the object with arguments as if it were a function.
Syntax
Creation
-
object = EngeePhased.ShortDipoleAntennaElement
creates a short-dipole antenna element with by default property values. Example:antenna=EngeePhased.ShortDipoleAntennaElement
-
object = EngeePhased.ShortDipoleAntennaElement(Name=Value)
creates a short-dipole antenna element with each specified property Name (name) set to the specified Value (value). You can specify additional arguments as a name-value pair in any order (Name1
=Value1
,…,NameN
=ValueN
). Example:antenna=EngeePhased.ShortDipoleAntennaElement()
Usage
-
RESP = object(H,FREQ,ANG)
returns the antenna’s voltage response, argument RESP, at the operating frequencies specified in argument FREQ and in the directions specified in argument ANG. RESP is a structure containing two fields RESP.H and RESP.V, representing the horizontal and vertical polarisation components of the antenna response. Each field is an M by L matrix containing the antenna response at M angles specified in ANG and at L frequencies specified in FREQ.
Properties
FrequencyRange -
operating frequency range
[0 1e20] (by default)
| non-negative real vector of strings 1 by 2
Details
The operating frequency range of the antenna, specified as a non-negative real vector of 1 by 2 rows in the form [LowerBound HigherBound]
. The antenna element has no response outside the specified frequency range.
The units of measurement are Hz.
Data types: Float64
AxisDirection -
dipole axis direction
Z (by default)
| Y
| X
| Custom
Details
Dipole axis direction specified as X
, Y
, Z
or Custom
.
The dipole axis defines the direction of the dipole current relative to the local coordinate system.
X
defines the dipole along the -axis, Y
defines the dipole along the -axis, and Z
defines the dipole along the -axis. The direction along the or axis is equivalent to a horizontal dipole, and the direction along the axis is equivalent to a vertical dipole.
If you set the AxisDirection property to Custom
, you can manually specify the dipole axis using the CustomAxisDirection property.
Data types: char
CustomAxisDirection -
custom dipole axis direction
[0;0;1] (by default)
| ` real vector-column 1 by 3`
Details
The user-defined direction of the dipole antenna axis, specified as a 1-by-3 real vector-column. Each entry in the vector represents a component of the dipole axis along the axes , , and in the local coordinate system.
Dependencies
To enable this property, set the AxisDirection property to Custom
.
Data types: Float64
Arguments
Input
FREQ -.
antenna element operating frequency
non-negative scalar
| non-negative real vector 1 on L lines
Details
The operating frequency of the antenna element given as a non-negative scalar or a non-negative real vector 1 on L lines.
The units of measurement are Hz.
FREQ must lie within the range of values specified by the FrequencyRange property of the element.
Otherwise, the element does not respond and the response is returned as -Inf
.
*Example: [1e8 2e6]
.
Data types: Float64
ANG -
azimuth and altitude angles of response directions
` real vector of rows 1 on M` | ` real matrix 2 on M`
Details
Azimuthal and altitude angles of the answer directions given as a real vector of lines 1 by M or a real matrix 2 by M, where M is the number of angular directions.
The units of measurement are degrees.
The azimuth angle must lie in the range from -180° to 180° inclusive. Elevation angle shall lie in the range from -90° to 90° inclusive.
If ANG
is a vector 1 on M, each element specifies an azimuthal angle of direction. In this case, the corresponding elevation angle is assumed to be zero.
If ANG
is a matrix 2 on M, each column of the matrix specifies a direction in the form [azimuth;elevation].
The azimuth angle is the angle between the x-axis and the projection of the direction vector onto the xy plane. This angle is positive when measured from the x-axis towards the y-axis. Elevation angle is the angle between the direction vector and the xy plane. This angle is positive when measured in the z-axis direction.
*Example: [110 125; 15 10]
Data types: Float64