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.

info

Get characteristic information about link-level MIMO fading channel

Syntax

channelInfo = info(channel)

Description

example

channelInfo = info(channel) returns characteristic information about the link-level multi-input multi-output (MIMO) fading channel channel.

Examples

collapse all

Create an nrTDLChannel System object.

tdl = nrTDLChannel;

To get characteristic information about the channel, call the info function on the object.

channelInfo = info(tdl)
channelInfo = struct with fields:
          ChannelFilterDelay: 7
                  PathDelays: [1x23 double]
            AveragePathGains: [1x23 double]
             KFactorFirstTap: -Inf
         NumTransmitAntennas: 1
          NumReceiveAntennas: 2
    SpatialCorrelationMatrix: [2x2 double]

Input Arguments

collapse all

MIMO fading channel, specified as an nrCDLChannel or nrTDLChannel System object™. The objects implement the link-level MIMO fading channels specified in TR 38.901 Section 7.7.1 and Section 7.7.2, respectively.

Output Arguments

collapse all

Characteristic information of channel model, returned as a structure. The fields of the structure depend on the input channel.

  • If channel is an nrCDLChannel System object, the channelInfo structure has these fields.

    Parameter FieldValueDescription
    PathDelays

    Numeric row vector

    Delays of discrete channel paths for each cluster in seconds, returned as a numeric row vector. These values include the effects of DelaySpread scaling and KFactorScaling (when enabled).

    ClusterTypes

    Cell array of character vectors

    Type of each cluster in the delay profile, returned as a cell array of character vectors. Cluster types can be 'LOS', 'SubclusteredNLOS', or 'NLOS'.

    AveragePathGains

    Numeric row vector

    Average path gains of the discrete path or clusters in dB, returned as a numeric row vector. These values include the effect of KFactorScaling scaling (when enabled).

    AnglesAoD

    Numeric row vector

    Azimuth of departure angles of the clusters in degrees, returned as a numeric row vector. These values include the effect of angle scaling if enabled, see the AngleSpreads property.

    AnglesAoA

    Numeric row vector

    Azimuth of arrival angles of the clusters in degrees, returned as a numeric row vector. These values include the effect of angle scaling if enabled, see the AngleSpreads property.

    AnglesZoD

    Numeric row vector

    Zenith of departure angles of the clusters in degrees, returned as a numeric row vector. These values include the effect of angle scaling if enabled, see the AngleSpreads property.

    AnglesZoA

    Numeric row vector

    Zenith of arrival angles of the clusters in degrees, returned as a numeric row vector. These values include the effect of angle scaling if enabled, see the AngleSpreads property.

    KFactorFirstCluster

    Numeric scalar

    K-factor of first cluster of delay profile in dB, returned as a numeric scalar. If the first cluster of the delay profile follows a Laplacian instead of a Rician distribution, KFactorFirstCluster is -Inf.

    NumTransmitAntennas

    Numeric scalar

    Number of transmit antennas, returned as a numeric scalar.

    NumReceiveAntennas

    Numeric scalar

    Number of receive antennas, returned as a numeric scalar.

    ChannelFilterDelay

    Numeric scalar

    Channel filter delay in samples, returned as a numeric scalar.

    Note

    • The step of splitting the strongest clusters into subclusters, described in TR 38.901 Section 7.5, requires sorting of the clusters by their average power. If the NumStrongestClusters property is nonzero (applies only when DelayProfile is set to 'Custom'), the fields of the information structure are sorted by average power. That is, the AveragePathGains, ClusterTypes, PathDelays, AnglesAoD, AnglesAoA, AnglesZoD, and AnglesZoA fields are presented in descending order of the average gain.

    • If the HasLOSCluster property is set to true, the NLOS (Laplacian) part of that cluster and the LOS cluster are not necessarily next to each other. However, the KFactorFirstCluster field still indicates the appropriate K-factor.

  • If channel is an nrTDLChannel System object, the channelInfo structure has the following fields.

    Parameter FieldValueDescription
    ChannelFilterDelay

    Numeric scalar

    Channel filter delay in samples, returned as a numeric scalar.

    AveragePathGains

    Numeric row vector

    Average path gains of the discrete paths in dB, returned as a numeric row vector. These values include the effect of KFactorScaling (when enabled).

    PathDelays

    Numeric row vector

    Delays of discrete channel paths in seconds, returned as a numeric row vector. These values include the effects of DelaySpread scaling and KFactorScaling (when enabled).

    KFactorFirstTap

    Numeric scalar

    K-factor of first tap of delay profile in dB, returned as a numeric scalar. If the first tap of the delay profile follows a Rayleigh instead of a Rician distribution, KFactorFirstTap is -Inf.

    NumTransmitAntennas

    Numeric scalar

    Number of transmit antennas, returned as a numeric scalar.

    NumReceiveAntennas

    Numeric scalar

    Number of receive antennas, returned as a numeric scalar.

    SpacialCorrelationMatrix

    Numeric matrix

    Combined correlation matrix or 3-D array, returned as a numeric matrix.

References

[1] 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.

Extended Capabilities

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

See Also

System Objects

Introduced in R2018b