info

R2026b

Return characteristic information about channel filter

collapse all in page

    Syntax

    infostruct = info(chanFilt)

    Description

    infostruct = info(chanFilt) returns a structure containing characteristic information about the comm.ChannelFilter System object™. For more information about the channel filter model, see Channel Filter Model Characteristics.

    example

    Examples

    collapse all

    Open Live Script

    In a distributed MIMO system, send the same signal from geographically separate transmitters and combine the received signals at one single receiver to explore spatial diversity. The transmitters are not co-located and they experience different multipath (path delays) to the receiver. Specify the path delays respectively.

    delay1 = [0 2e-3];
delay2 = [0 1.3e-3];
delay3 = [0 3.7 6.2]*1e-2;

    Configure one channel filter object per Tx.

    chanFilt = comm.ChannelFilter(SampleRate=1000,PathDelays=delay1);

    Use the info object function to get the ChannelFilterDelay and ChannelFilterCoefficients.

    info(chanFilt)
    ans = struct with fields:
    ChannelFilterCoefficients: [2×3 double]
           ChannelFilterDelay: 0


    chanFilt.PathDelays=delay2;
info(chanFilt)
    ans = struct with fields:
    ChannelFilterCoefficients: [2×16 double]
           ChannelFilterDelay: 6


    chanFilt.PathDelays=delay3;
info(chanFilt)
    ans = struct with fields:
    ChannelFilterCoefficients: [3×63 double]
           ChannelFilterDelay: 0

    Input Arguments

    collapse all

    Channel filter, specified as a comm.ChannelFilter System object.

    Output Arguments

    collapse all

    Characteristic information about channel filter, returned as a structure containing these fields:

    Channel filter coefficients, returned as a matrix. The time varying path gains are applied as gains to this non-varying filter to produce the channel output over time for each pair of transmit and receive antennas.

    Data Types: double

    Excess filter delay in samples, returned as a positive integer.

    • If you configure the PathDelays property of your channel object with all integer-valued delays, the implemented channel filter adds no excess delay to the channel output. In this case, the ChannelFilterDelay field reports 0 for the excess path delay.

    • If you configure the PathDelays property of your channel object with any noninteger-valued delays, the implemented channel filter may add excess delay to the channel output. In this case, the ChannelFilterDelay field may report a nonzero value for the excess path delay.

    Data Types: double

    Version History

    Introduced in R2020b

    See Also

    Objects