displayChannel

This example shows how to visualize 3-D channel characteristics and explore channel information about the antenna element, element pattern, and cluster paths.

Define the channel configuration by using an lte3DChannel System object. Specify the delay profile as CDL-D.

lte3D = lte3DChannel.makeCDL('CDL-D');

Configure the transmit array size as a vector of the form $\left[\mathit{M}\mathit{N}\mathit{P}{\mathit{M}}_{\mathit{g}}{\mathit{N}}_{\mathit{g}}\right]=\left[43212\right]$, which specifies two rectangular panels (${\mathit{M}}_{\mathit{g}}=1$ and ${\mathit{N}}_{\mathit{g}}=2$) of a 4-by-3 antenna array ($\mathit{M}=4$ and $\mathit{N}=3$) and two polarizations ($\mathit{P}=2$). The total number of polarized elements in the array is $\mathit{M}\times \mathit{N}\times \mathit{P}\times {\mathit{M}}_{\mathit{g}}\times {\mathit{N}}_{\mathit{g}}=48$.

txSize = [4 3 2 1 2];
lte3D.TransmitAntennaArray.Size = txSize;

Configure the vertical and horizontal element spacing and the vertical and horizontal panel spacing, in wavelength, as a vector of the form $\left[{\lambda }_{\mathrm{v}}{\lambda }_{\mathrm{h}}{\mathrm{dg}}_{\mathrm{v}}{\mathrm{dg}}_{\mathrm{h}}\right]$. Because panel spacing is measured from the center of the panels, to avoid panel overlapping, set ${\mathrm{dg}}_{\mathrm{h}}$ to a value greater than one wavelength. To ensure uniform antenna element spacing across vertically and horizontally separated panels, configure panel spacings as ${\mathrm{dg}}_{\mathrm{v}}={\lambda }_{\mathrm{v}}\times \mathit{M}$ and ${\mathrm{dg}}_{\mathrm{h}}={\lambda }_{\mathrm{h}}\times \mathit{N}$, respectively.

lambda_v = 0.5;
lambda_h = 0.5;
dg_v = lambda_v*txSize(1); % lambda_v * M
dg_h = lambda_h*txSize(2); % lambda_h * N
lte3D.TransmitAntennaArray.ElementSpacing = [lambda_v lambda_h dg_v dg_h];

Configure the mechanical orientation of the array as $[\alpha \beta \gamma {]}^{\mathit{T}}={\left[0150\right]}^{\mathit{T}}$, which specifies 0 degrees bearing, 15 degrees downtilt, and 0 degrees slant.

lte3D.TransmitAntennaArray.Orientation = [0 15 0]';

For an overview of all transmit antenna array properties, see the TransmitAntennaArray property of the lte3DChannel System object.

Display the channel characteristics at the transmitter end.

figTx = displayChannel(lte3D,'LinkEnd','Tx');

The generated figure supports customized data tips. Add data tips in the current figure by enabling the data cursor mode.

datacursormode on;

With data cursor mode enabled, explore channel characteristics by adding data tips. To create a data tip, click a data point. To create multiple data tips, press the Shift key while clicking the data points.

For example, this figure shows data tips added to the antenna element, element pattern, and cluster paths at the transmitter end.

Visualize and explore channel characteristics at the receiver end. To customize the receive antenna array, use the ReceiveAntennaArray property of the lte3DChannel System object. Then, display the channel characteristics at the receiver end by calling the displayChannel function with the 'LinkEnd','Rx' name-value pair argument.

figRx = displayChannel(lte3D,'LinkEnd','Rx');

Explore channel information about the antenna element, element pattern, and cluster paths at the receiver end by enabling data cursor mode for the current figure.

datacursormode on;