# displayChannel

Visualize and explore 3-D MIMO fading channel model characteristics

## Syntax

``fig = displayChannel(lte3D)``
``fig = displayChannel(lte3D,Name,Value)``

## Description

````fig = displayChannel(lte3D)` displays geometric and electromagnetic characteristics of the specified 3-D multiple-input/multiple-output (MIMO) channel model at the transmitter and receiver ends. The visualization includes the position, polarization, and directivity radiation pattern of the antenna elements, cluster paths directions, and average path gains. Because all antenna elements are equal, the visualization shows the radiation pattern of the first antenna element only and displays the cluster paths directions centered also at the first antenna element. By adding customized data tips to the visualization windows, you can explore antenna element, element pattern, and cluster paths characteristics. The function also returns an array of figure objects that correspond to the displayed visualization windows.```

example

````fig = displayChannel(lte3D,Name,Value)` specifies visualization options of the displayed channel characteristics by using one or more name-value pair arguments. For example, `'LinkEnd','Tx'` specifies visualization at the transmitter end only.```

## Examples

collapse all

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}\text{\hspace{0.17em}}\mathit{N}\text{\hspace{0.17em}}\mathit{P}\text{\hspace{0.17em}}{\mathit{M}}_{\mathit{g}}\text{\hspace{0.17em}}{\mathit{N}}_{\mathit{g}}\right]=\left[4\text{\hspace{0.17em}}3\text{\hspace{0.17em}}2\text{\hspace{0.17em}}1\text{\hspace{0.17em}}2\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}×\mathit{N}×\mathit{P}×{\mathit{M}}_{\mathit{g}}×{\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}}\text{\hspace{0.17em}}{\lambda }_{\mathrm{h}}\text{\hspace{0.17em}}{\mathrm{dg}}_{\mathrm{v}}\text{\hspace{0.17em}}{\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}}=\text{\hspace{0.17em}}{\lambda }_{\mathrm{v}}×\mathit{M}$ and ${\mathrm{dg}}_{\mathrm{h}}={\lambda }_{\mathrm{h}}×\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 $\left[\alpha \text{\hspace{0.17em}}\beta \text{\hspace{0.17em}}\gamma {\right]}^{\mathit{T}}={\left[0\text{\hspace{0.17em}}15\text{\hspace{0.17em}}0\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.

• Antenna element data tips include information about the position, polarization angle, and element number of each antenna element. The element numbers indicate the order in which the channel model maps input signals column-wise to antenna elements. For more details, see the `TransmitAntennaArray.Size` property of the `lte3DChannel` System object.

• Element pattern data tips include the directivity corresponding to any azimuth and zenith angles.

• Cluster path data tips include the average path gain and azimuth and zenith angles of the cluster path.

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;`

## Input Arguments

collapse all

3-D channel model, specified as an `lte3DChannel` System object. This object implements the link-level MIMO fading channel specified in section 7.3 of TR 36.867 [1] with the optional cluster delay line (CDL) profile from section 7.7.1 of TR 38.901 [2].

### Name-Value Arguments

Specify optional comma-separated pairs of `Name,Value` arguments. `Name` is the argument name and `Value` is the corresponding value. `Name` must appear inside quotes. You can specify several name and value pair arguments in any order as `Name1,Value1,...,NameN,ValueN`.

Example: `'LinkEnd','Tx'` specifies visualization for the transmitter end only.

Link-level channel end, specified as the comma-separated pair consisting of `'LinkEnd'` and one of these values.

• `'Both'` — Display channel characteristics at both ends: the transmitter and receiver ends.

• `'Tx'` — Display channel characteristics only at the transmitter end.

• `'Rx'` — Display channel characteristics only at the receiver end.

Data Types: `char` | `string`

Polarization angle of antenna elements, specified as the comma-separated pair consisting of `'Polarization'` and `'on'` or `'off'`. To display the polarization angle of the antenna elements, specify this input as `'on'`.

Data Types: `char` | `string`

Directivity radiation pattern of antenna, specified as the comma-separated pair consisting of `'ElementPattern'` and `'on'` or `'off'`. To display the directivity radiation pattern of the antenna elements, specify this input as `'on'`.

Note

In the specified channel model, `lte3D`, the antenna element pattern is the same for all antenna elements. To orient the array with respect to the cluster paths, the function displays the element pattern centered at the first element of the array.

Data Types: `char` | `string`

Direction and average gain of cluster paths, specified as the comma-separated pair consisting of `'ClusterPaths'` and `'on'` or `'off'`. To display the direction and average gain of the cluster paths, specify this input as `'on'`.

Note

In the specified channel model, `lte3D`, the cluster path directions are the same for all antenna elements. To orient the array with respect to the cluster paths, the function displays the path directions centered at the first element of the array.

Data Types: `char` | `string`

## Output Arguments

collapse all

Visualization windows, returned as a 1-by-2 array of `figure` objects.

## References

[1] 3GPP TR 36.873. “Study on 3D channel model for LTE.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network; Evolved Universal Terrestrial Radio Access (E-UTRA). URL: https://www.3gpp.org.

[2] 3GPP TR 38.901. “Study on channel model for frequencies from 0.5 to 100 GHz.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network. URL: https://www.3gpp.org.

### Objects

Introduced in R2020b