Characteristic information about ray-tracing channel
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 osm file, see [1].
sv = siteviewer("Buildings","hongkong.osm");
Create transmitter and receiver sites.
tx = txsite("Latitude",22.2789,"Longitude",114.1625, ... "AntennaAngle",30, ... % azimuth "AntennaHeight",10,"TransmitterFrequency",28e9); rx = rxsite("Latitude",22.2799,"Longitude",114.1617, ... "AntennaAngle",120, ... % azimuth "AntennaHeight",1);
Perform ray tracing to find rays with up to 2 reflections.
rays = raytrace(tx,rx,"NumReflections",[0 1 2]);
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: [7×20 double]
NumSamplesProcessed: 0
Appendix
[1] The osm 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/.
rtchan
— Ray-tracing channelcomm.RayTracingChannel
System object™
Ray-tracing channel, specified as a comm.RayTracingChannel
System object.
chanInfo
— Ray tracing channel characteristic informationRay tracing channel characteristic information, returned as a structure containing
these fields. The ray tracing channel is specified by the input
rtchan
.
CarrierFrequency
— Carrier frequencyCarrier frequency in Hz, returned as a positive scalar.
CoordinateSystem
— Coordinate system'Cartesian'
| 'Geographic'
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.
This property applies when at least one comm.Ray
object in the PropagationRays
property
of the rtchan
input has
PathSpecification
set to
'Locations'
.
TransmitArrayLocation
— Transmit array locationTransmit 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.
This property applies when at least one comm.Ray
object in the PropagationRays
property
of the rtchan
input has
PathSpecification
set to
'Locations'
.
ReceiveArrayLocation
— Receive array locationReceive 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.
This property applies when at least one comm.Ray
object in the PropagationRays
property
of the rtchan
input has
PathSpecification
set to
'Locations'
.
NumTransmitElements
— Number of elements in transmit arrayNumber of elements in the transmit array, returned as a positive integer.
NumReceiveElements
— Number of elements in receive arrayNumber of elements in the receive array, returned as a positive integer.
ChannelFilterDelay
— Channel filter delayChannel filter delay in samples, returned as a nonnegative integer.
ChannelFilterCoefficients
— Channel filter coefficientsChannel 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).
NumSamplesProcessed
— Number of samples processed by channel objectNumber of samples processed by the channel object since its last reset, returned as a nonnegative integer.
You have a modified version of this example. Do you want to open this example with your edits?