Main Content

info

Characteristic information about ray-tracing channel

Since R2020b

    Description

    chanInfo = info(rtchan) returns a structure containing characteristic information about the input ray-tracing channel.

    example

    Examples

    collapse all

    Perform ray tracing between two sites in Hong Kong, China, build a multipath channel model using the ray-tracing result, and view the ray-tracing channel information.

    Create a Site Viewer map display of buildings in Hong Kong. For more information about the OpenStreetMap® file, see [1].

    sv = siteviewer(Buildings="hongkong.osm");

    Site Viewer with buildings

    Create transmitter and receiver sites.

    tx = txsite( ...
        Latitude=22.2789, ...
        Longitude=114.1625, ...
        AntennaAngle=30, ... % azimuth angle
        AntennaHeight=10, ...
        TransmitterFrequency=28e9);
    rx = rxsite( ...
        Latitude=22.2799, ...
        Longitude=114.1617, ...
        AntennaAngle=120, ... % azimuth angle
        AntennaHeight=1);

    Create a ray tracing model that calculates paths with up to 3 reflections. By default, ray tracing models use the shooting and bouncing rays (SBR) method. Then, perform the ray tracing analysis.

    pm = propagationModel("raytracing",MaxNumReflections=3);
    rays = raytrace(tx,rx,pm);

    Create a channel model by using the transmitter site, receiver site, and calculated rays between the sites. Return information from the ray-tracing channel.

    rtchan = comm.RayTracingChannel(rays{1},tx,rx);
    info(rtchan)
    ans = struct with fields:
                 CarrierFrequency: 2.8000e+10
                 CoordinateSystem: 'Geographic'
            TransmitArrayLocation: [3×1 double]
             ReceiveArrayLocation: [3×1 double]
              NumTransmitElements: 1
               NumReceiveElements: 1
               ChannelFilterDelay: 4
        ChannelFilterCoefficients: [11×30 double]
              NumSamplesProcessed: 0
                    LastFrameTime: 0
    
    

    Appendix

    [1] The OpenStreetMap file is downloaded from https://www.openstreetmap.org, which provides access to crowd-sourced map data all over the world. The data is licensed under the Open Data Commons Open Database License (ODbL), https://opendatacommons.org/licenses/odbl/.

    Input Arguments

    collapse all

    Ray-tracing channel, specified as a comm.RayTracingChannel System object.

    Output Arguments

    collapse all

    Ray tracing channel characteristic information, returned as a structure containing these fields. The ray tracing channel is specified by the input rtchan.

    Carrier frequency in Hz, returned as a positive scalar.

    Coordinate system, returned as 'Cartesian' or 'Geographic'. Any comm.Ray objects, specified by the PropagationRays property of the rtchan input, that have their PathSpecification property set to 'Locations', must have the same CoordinateSystem property setting.

    Dependencies

    This property applies when at least one comm.Ray object in the PropagationRays property of the rtchan input has PathSpecification set to 'Locations'.

    Transmit array location, returned as a three element column vector. Any comm.Ray objects, specified by the PropagationRays property of the rtchan input, that have their PathSpecification property set to 'Locations', must have the same TransmitterLocation property setting.

    Dependencies

    This property applies when at least one comm.Ray object in the PropagationRays property of the rtchan input has PathSpecification set to 'Locations'.

    Receive array location, returned as a three element column vector. Any comm.Ray objects, specified by the PropagationRays property of the rtchan input, that have their PathSpecification property set to 'Locations', must have the same ReceiverLocation property setting.

    Dependencies

    This property applies when at least one comm.Ray object in the PropagationRays property of the rtchan input has PathSpecification set to 'Locations'.

    Number of elements in the transmit array, returned as a positive integer.

    Number of elements in the receive array, returned as a positive integer.

    Channel filter delay in samples, returned as a nonnegative integer.

    Channel filter coefficients, returned as an NP-by-NH matrix. This coefficient matrix is used to convert channel impulse responses to channel filter tap gains for each sample, and then for each pair of transmit and receive antenna elements. NP is the number of paths (specifically, the number of rays as indicated by the length of the PropagationRays property of the rtchan input). NH is the number of impulse response samples (specifically, the number of channel filter taps).

    Number of samples processed by the channel object since its last reset, returned as a nonnegative integer.

    End time of last frame in seconds, returned as a nonnegative integer.

    Version History

    Introduced in R2020b