This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

showEnvironment

Display channel environment with D-Rays from ray tracing

Syntax

showEnvironment(tgay)
showEnvironment(tgay,envOnly)

Description

example

showEnvironment(tgay) displays a three-dimensional figure for the IEEE® 802.11ay™ (TGay) channel environment determined by the input wlanTGayChannel object, tgay. The figure shows a schematic depiction of the channel environment, locations of the transmit and receive antenna arrays, and quasi-deterministic strong rays (D-rays) between the arrays determined by ray tracing.

example

showEnvironment(tgay,envOnly) displays the channel environment with the option of turning off ray tracing.

Examples

collapse all

Filter a dual-polarized signal through a WLAN 802.11ay™ channel, specifying a street canyon environment.

Configure a TGay channel System object for a street canyon environment, specifying a user configuration of single-user multiple-input/multiple-output (SU-MIMO) with two transmit antenna arrays and two receive antenna arrays. Specify the transmit antenna arrays as two-element uniform linear arrays (ULAs) and the receive antenna arrays as single isotropic elements. Use a custom beamforming method to specify the transmit and receive beamforming vectors, and specify the source of the random number stream.

tgay = wlanTGayChannel('SampleRate',2e9,'Environment','Street canyon hotspot', ...
    'UserConfiguration','SU-MIMO 2x2','ArraySeparation',[0.8 0.8],'ArrayPolarization','Dual, Dual', ...
    'TransmitArray',wlanURAConfig('Size',[1 2]),'TransmitArrayOrientation',[10; 10; 10], ...
    'ReceiveArray',wlanURAConfig('Size',[1 1]),'BeamformingMethod','Custom','NormalizeImpulseResponses',false, ...
    'RandomStream','mt19937ar with seed','Seed',100);

Display the environment of the TGay channel.

showEnvironment(tgay);
title('Street Canyon Hotspot with Antenna Arrays and D-Rays');

Retrieve channel characteristics by using the info object function.

tgayInfo = tgay.info;

Formulate the beamforming vectors in terms of the number of transmit elements, receive elements, transmit streams, and receive streams obtained from tgayInfo.

NTE = tgayInfo.NumTxElements;
NTS = tgayInfo.NumTxStreams;
NRE = tgayInfo.NumRxElements;
NRS = tgayInfo.NumRxStreams;
tgay.TransmitBeamformingVectors = ones(NTE,NTS)/sqrt(NTE);
tgay.ReceiveBeamformingVectors = ones(NRE,NRS)/sqrt(NRE);

Create a random input signal and filter it through the TGay channel.

txSignal = complex(rand(100,NTS),rand(100,NTS));
rxSignal = tgay(txSignal);

Display the open area hotspot environment for a WLAN TGay channel model.

Configure a TGay channel System object for an open area hotspot environment, specifying a user configuration of single-user multiple-input/multiple-output (SU-MIMO) with two transmit antenna arrays and two receive antenna arrays. Specify the transmit antenna array as a 2x2 uniform rectangular array (URA) and the receive antenna arrays as single isotropic elements. Use a custom beamforming method to specify the transmit and receive beamforming vectors, and specify the source of the random number stream.

tgay = wlanTGayChannel('SampleRate',1e9,'Environment','Open area hotspot', ... 
    'UserConfiguration','SU-MIMO 2x2','ArraySeparation',[0.6 0.6],'ArrayPolarization','Dual, Dual', ...
    'TransmitArray',wlanURAConfig('Size',[2 2]),'TransmitArrayOrientation',[20; 10; 10], ... 
    'ReceiveArray',wlanURAConfig('Size',[1 1]),'BeamformingMethod','Custom', ...
    'NormalizeImpulseResponses',false,'RandomStream','mt19937ar with seed','Seed',150);

Display the environment of the TGay channel.

envOnly = false;
showEnvironment(tgay,envOnly);
title('Open Area Hotspot with Antenna Arrays and D-Rays');

Input Arguments

collapse all

TGay multipath fading channel, specified as a wlanTGayChannel System object.

Display environment without D-Rays, specified as a logical value of true or false. To display a schematic of the channel environment without D-Rays, set this property to true. To display a schematic of the channel environment with D-Rays, set this property to false.

Data Types: logical

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

See Also

Objects

Introduced in R2019a