5G antenna element described in 3GPP TR 38.901 specification
System object™ models an antenna designed to meet the 3GPP TR 38.901 standard .
To compute the response of the antenna element for specified directions:
phased.NRAntennaElement object and set its properties.
Call the object with arguments, as if it were a function.
To learn more about how System objects work, see What Are System Objects?.
NR antenna System object,
antenna = phased.NRAntennaElement
antenna, that follows the standard specified in 3GPP
TR 38.901 .
creates an NR antenna element object,
antenna = phased.NRAntennaElement(
antenna, and sets each
specified property set to the specified value. You can specify additional name-value pair
arguments in any order as
Unless otherwise indicated, properties are nontunable, which means you cannot change their
values after calling the object. Objects lock when you call them, and the
release function unlocks them.
If a property is tunable, you can change its value at any time.
For more information on changing property values, see System Design in MATLAB Using System Objects.
FrequencyRange— Operating frequency range
[0 1e20](default) | nonnegative, real-valued, 1-by-2 row vector
Operating frequency range of the antenna, specified as a nonnegative, real-valued, 1-by-2 row
vector in the form
[LowerBound HigherBound]. The antenna
element has no response outside the specified frequency range. Units are in
PolarizationAngle— Polarization slant angle
0.0(default) | real scalar
Polarization slant angle of the antenna, specified as a scalar. The polarization slant angle is defined in section 7.3.2 of the 3GPP TR 38.901 Release 14 . Units are in degrees.
Polarization Model— Polarization model
2(default) | 1
Polarization model, specify as either 1 or 2. The polarization models are defined in section 7.3.2 of the 3GPP TR 38.901 Release 14 .
The object performs an initialization the first time the object is executed. This
initialization locks nontunable properties
and input specifications, such as dimensions, complexity, and data type of the input data.
If you change a nontunable property or an input specification, the System object issues an error. To change nontunable properties or inputs, you must first
release method to unlock the object.
FREQ— Operating frequency of antenna element
Operating frequency of antenna element, specified as a nonnegative scalar or nonnegative, real-valued, 1-by-L row vector. Frequency units are in Hz.
FREQ must lie within the range of values specified by the
FrequencyRange or the
property of the element. Otherwise, the element produces no response and the response is
–Inf. Most elements objects use the
FrequencyRange property except for
phased.CustomAntennaElement, which uses the
RESP— Voltage response of antenna
Voltage response of the antenna element, returned as a complex-valued
M-by-L matrix. In this matrix,
M represents the number of angles specified in
ANG and L represents the number of
frequencies specified in
To use an object function, specify the
System object as the first input argument. For
example, to release system resources of a System object named
|Compute and display beamwidth of sensor element pattern|
|Directivity of antenna or transducer element|
|Antenna element polarization capability|
|Plot antenna or transducer element directivity and patterns|
|Plot antenna or transducer element directivity and pattern versus azimuth|
|Plot antenna or transducer element directivity and pattern versus elevation|
Construct an antenna based on the 3GPP 38.901 standard and plot its elevation response at 6 MHz.
antenna = phased.NRAntennaElement; fc = 6e9; pattern(antenna,fc,-180:180,0,'CoordinateSystem','polar');
Find the response of the antenna at the boresight.
ang = [0;0]; resp = antenna(fc,ang)
resp = struct with fields: H: 0 V: -2.5119
Construct 3GPP 38.901 antenna and plot its elevation response. Set the polarization model to 1. Compute the antenna response at 6 GHz.
element = phased.NRAntennaElement('PolarizationModel',1); fc = 6e9; ang = [0;0]; resp = element(fc,ang)
resp = struct with fields: H: 0 V: -2.5119
Display the antenna pattern at 0 degrees.
 5G: Study on channel model for frequencies from 0.5 to 100 GHz, 3GPP TR38.901 Version 14.0.0 Release 14.
Usage notes and limitations:
System Objects in MATLAB Code Generation (MATLAB Coder)