matlab2019a最新wlan tool box，含802.11ax

classdef (StrictDefaults) wlanTGayChannel < matlab.System %wlanTGayChannel Filter input signal through an IEEE 802.11ay channel % CHAN = wlanTGayChannel creates a System object, CHAN, for the IEEE % 802.11ay millimeter-wave channel model as specified in [1], which % follows the quasi-deterministic (Q-D) modeling approach. This object % filters an input signal through the channel to obtain the impaired % complex signal. % % CHAN = wlanTGayChannel(Name,Value) creates an 802.11ay channel object, % CHAN, with the specified property Name set to the specified Value. % You can specify additional name-value pair arguments in any order as % (Name1,Value1,...,NameN,ValueN). % % Step method syntax: % % Y = step(CHAN,X) filters input signal X through an IEEE 802.11ay % millimeter-wave fading channel and returns the result in Y. The input X % must be a double or single precision, Ns-by-NTS matrix, where Ns is the % number of samples and NTS is the number of input streams to the % channel. The output Y is a Ns-by-NRS channel impaired signal with the % same data type as X, where NRS is the number of output streams from the % channel. NTS and NRS are derived from the channel object's % configuration and available in the object's info method return. % % For SU-MIMO with one transmit and receive array, when NTS = 1, X is the % vertically polarized stream to the array. When NTS/NRS = 2, the first % and second columns in X/Y are the vertically and horizontally polarized % streams to/from the array, respectively. % % For SU-MIMO with two transmit and receive arrays, when NTS = NRS = 2, % the first and second columns in X/Y are the vertically polarized stream % to/from the first array and horizontally polarized stream to/from the % second array, respectively. When NTS = NRS = 4, the first two columns % in X/Y are the vertically and horizontally polarized streams to/from % the first array, respectively, and the last two columns in X/Y are the % vertically and horizontally polarized streams to/from the second array, % respectively. % % [Y,CIR] = step(CHAN,X) returns the channel impulse response (CIR) for % all the simulated rays. CIR is a complex-valued, % Ns-by-Nray-by-NTS-by-NRS array, where Nray is the number of rays. % % System objects may be called directly like a function instead of using % the step method. For example, y = step(obj, x) and y = obj(x) are % equivalent. % % wlanTGayChannel methods: % % step - Filter input signal through an 802.11ay channel (see above) % release - Allow property value and input characteristics changes % clone - Create 802.11ay channel object with same property values % isLocked - Locked status (logical) % <a href="matlab:help matlab.System/reset ">reset</a> - Regenerate R-Rays and intracluster rays when the % RandomStream property is set to 'Global stream'. % Reset channel filter. % <a href="matlab:help matlab.System/info ">info</a> - Return characteristic information about the channel % showEnvironment - Display a 3D map for the specified environment and % D-Rays from ray-tracing. % % wlanTGayChannel properties: % % SampleRate - Sample rate (Hz) % CarrierFrequency - Carrier frequency (Hz) % Environment - Channel model environment % RoadWidth - Street canyon road width (m) % SidewalkWidth - Street canyon sidewalk width (m) % RoomDimensions - Hotel lobby length, width and height (m) % UserConfiguration - User configuration % ArraySeparation - Array separation (m) % ArrayPolarization - Array polarization type % TransmitArray - Transmit antenna array % TransmitArrayPosition - Transmit antenna array position (m) % TransmitArrayOrientation - Transmit antenna array orientation % TransmitArrayPolarization - Transmit antenna array polarization type % ReceiveArray - Receive antenna array % ReceiveArrayPosition - Receive antenna array position (m) % ReceiveArrayOrientation - Receive antenna array orientation % ReceiveArrayPolarization - Receive antenna array polarization type % ReceiveArrayVelocitySource - Receive antenna array velocity source % ReceiveArrayVelocity - Receive antenna array velocity (m/s) % RandomRays - Model random rays (R-Rays) (logical) % IntraClusterRays - Model intra-cluster rays (logical) % OxygenAbsorption - Oxygen absorption (dB/m) % BeamformingMethod - Beamforming method % TransmitBeamformingVectors - Transmit beamforming vectors % ReceiveBeamformingVectors - Receive beamforming vectors % NormalizeImpulseResponses - Normalize channel impulse responses (logical) % NormalizeChannelOutputs - Normalize output by number of output streams (logical) % RandomStream - Source of random number stream % Seed - Initial seed % % % Example 1: % % Filter an 802.11ad single-carrier unpolarized waveform through a % % SU-SISO 802.11ay channel for the large hotel lobby environment. The % % transmit and receive arrays are 4x4 and 3x3 URAs respectively. The % % seed value is set to produce a repeatable channel output. % % % Create packet configuration % cfgDMG = wlanDMGConfig; % % Generate one waveform % psdu = randi([0 1], 8*cfgDMG.PSDULength, 1); % % txWaveform = wlanWaveformGenerator(psdu, cfgDMG); % % Configure an 802.11ay channel object % tgay = wlanTGayChannel( ... % 'SampleRate', wlanSampleRate(cfgDMG), ... % 'Environment', 'Large hotel lobby', ... % 'TransmitArray', wlanURAConfig('Size', [4 4]), ... % 'ReceiveArray', wlanURAConfig('Size', [3 3]), ... % 'RandomStream', 'mt19937ar with seed', ... % 'Seed', 100); % % Pass waveform through the channel % chanOut1 = tgay(txWaveform); % % Reset the channel and pass the same waveform for the 2nd time % reset(tgay); % chanOut2 = tgay(txWaveform); % % Check two channel outputs are identical % isequal(chanOut1, chanOut2) % % % Now update the channel object to use global stream. In this case, the % % reset method will regenerate R-Rays, intracluster rays and receive % % array velocity. % % release(tgay); % tgay.RandomStream = 'Global stream'; % % Save the state of the current global stream % stream = RandStream.getGlobalStream; % s = stream.State; % % Pass the waveform through the channel for the 1st time % chanOut1 = tgay(txWaveform); % % Revert the global stream to where it starts before the step call % stream.State = s; % % Reset the channel and pass the same waveform for the 2nd time % reset(tgay); % chanOut2 = tgay(txWaveform); % % Check two channel outputs are identical % isequal(chanOut1, chanOut2) % % % Example 2: % % Filter a dual polarized signal through a SU-MIMO 2x2 802.11ay % % channel for the street canyon environment. The transmit arrays are % % 2-element ULAs and the receive arrays are single isotropic elements. % % Transmit and receive beamforming vectors are specified on the % % channel object. % % % Configure an 802.11ay channel object % tgay = wlanTGayChannel( ... % 'SampleRate', 20e9, ... % 'Environment', 'Street canyon hotspot', ... % 'UserConfiguration', 'SU-MIMO 2x2', ... % 'ArraySeparation', [0.8 0.8], ... % 'ArrayPolarization', 'Dual, Dual', ... % 'TransmitArray', wlanURAConfig('Size', [1 2]), ... % 'TransmitArrayOrientation', [10; 10; 0], ... % 'ReceiveArray', wlanURAConfig('Size', [1 1]), ... % 'BeamformingMethod', 'Cust