Wideband Two-Ray Channel
Libraries:
Radar Toolbox
Description
The Wideband Two-Ray Channel block propagates wideband signals from one point in space to multiple points or from multiple points back to one point via both the direct path and the ground reflection path. The block propagates wideband signals by (1) decomposing them into subbands, (2) propagating subbands independently, and (3) recombining the propagated subbands. The block models propagation time, propagation loss, and Doppler shift. The block assumes that the propagation speed is much greater than the object's speed in which case the stop-and-hop model is valid.
Ports
Input
X — Wideband input signal
M-by-N complex-valued
matrix | M-by-2N complex-valued
matrix
Wideband nonpolarized scalar signal, specified as an
M-by-N complex-valued matrix. The quantity M is the number of samples in the signal and N is the number of two-ray channels. Each channel corresponds to a source-destination pair. Each column contains an identical signal that is propagated along the line-of-sight and reflected paths.
M-by-2N complex-valued matrix. The quantity M is the number of samples of the signal and N is the number of two-ray channels. Each channel corresponds to a source-destination pair. Each adjacent pair of columns represents a different channel. Within each pair, the first column represents the signal propagated along the line-of-sight path and the second column represents the signal propagated along the reflected path.
The quantity M is the number of samples of the signal and N is the number of two-ray channels. Each channel corresponds to a source-destination pair.
The size of the first dimension of the input matrix can vary to simulate a changing signal length. A size change can occur, for example, in the case of a pulse waveform with variable pulse repetition frequency.
Example: [1,1;j,1;0.5,0]
Data Types: double
Complex Number Support: Yes
Pos1 — Position of signal origin
3-by-1 real-valued column vector | 3-by-N real-valued matrix
Origin of the signal or signals, specified as a 3-by-1 real-valued
column vector or 3-by-N real-valued matrix. The
quantity N is the number of two-ray channels. If Pos1 is
a column vector, it takes the form [x;y;z]
. If Pos1 is
a matrix, each column specifies a different signal origin and has
the form [x;y;z]
. Position units are in meters.
Pos1 and Pos2 cannot both be specified as matrices — at least one must be a 3-by-1 column vector.
Example: [1000;100;500]
Data Types: double
Pos2 — Position of signal destination
3-by-1 real-valued column vector | 3-by-N real-valued matrix
Origin of the signal or signals, specified as a 3-by-1 real-valued
column vector or 3-by-N real-valued matrix. The
quantity N is the number of two-ray channels. If Pos2 is
a column vector, it takes the form [x;y;z]
. If Pos2 is
a matrix, each column specifies a different signal origin and has
the form [x;y;z]
. Position units are in meters.
Pos1 and Pos2 cannot both be specified as matrices — at least one must be a 3-by-1 column vector.
Example: [-100;300;50]
Data Types: double
Vel1 — Velocity of signal origin
3-by-1 real-valued column vector | 3-by-N real-valued matrix
Velocity of signal origin, specified as a 3-by-1 real-valued
column vector or 3-by-N real-valued matrix. The
dimensions of Vel1 must match the dimensions
of Pos1. If Vel1 is a column
vector, it takes the form [Vx;Vy;Vz]
. If Vel1 is
a 3-by-N matrix, each column specifies a different
origin velocity and has the form [Vx;Vy;Vz]
. Velocity
units are in meters per second.
Example: [-10;3;5]
Data Types: double
Vel2 — Velocity of signal destination
3-by-1 real-valued column vector | 3-by-N real-valued matrix
Velocity of signal origin, specified as a 3-by-1 real-valued
column vector or 3-by-N real-valued matrix. The
dimensions of Vel2 must match the dimensions
of Pos2. If Vel2 is a column
vector, it takes the form [Vx;Vy;Vz]
. If Vel2 is
a 3-by-N matrix, each column specifies a different
origin velocity and has the form [Vx;Vy;Vz]
. Velocity
units are in meters per second.
Example: [-1000;300;550]
Data Types: double
Output
Out — Propagated signal
M-by-N complex-valued
matrix | M-by-2N complex-valued
matrix
M-by-N complex-valued matrix. To return this format, set the
CombinedRaysOutput
property totrue
. Each matrix column contains the coherently combined signals from the line-of-sight path and the reflected path.M-by-2N complex-valued matrix. To return this format set the
CombinedRaysOutput
property tofalse
. Alternate columns of the matrix contain the signals from the line-of-sight path and the reflected path.
The output Out contains signal samples arriving at the signal destination within the current input time frame. Whenever it takes longer than the current time frame for the signal to propagate from the origin to the destination, the output may not contain all contributions from the input of the current time frame. The remaining output will appear in the next execution of the block.
Parameters
Signal propagation speed (m/s) — Signal propagation speed
physconst('LightSpeed')
(default) | real-valued positive scalar
Signal propagation speed, specified as a real-valued positive scalar. The default value of the
speed of light is the value returned by physconst('LightSpeed')
.
Units are in meters per second.
Example: 3e8
Data Types: double
Signal carrier frequency (Hz) — Signal carrier frequency
300e6
(default) | positive real-valued scalar
Signal carrier frequency, specified as a positive real-valued scalar. Units are in hertz.
Data Types: double
Number of subbands — Number of processing subbands
64
(default) | positive integer
Number of processing subbands, specified as a positive integer.
Example: 128
Specify atmospheric parameters — Enable atmospheric attenuation model
off (default) | on
Select this parameter to enable to add signal attenuation caused by atmospheric gases, rain, fog, or clouds. When you select this parameter, the Temperature (degrees Celsius), Dry air pressure (Pa), Water vapour density (g/m^3), Liquid water density (g/m^3), and Rain rate (mm/hr) parameters appear in the dialog box.
Data Types: Boolean
Temperature (degrees Celsius) — Ambient temperature
15
(default) | real-valued scalar
Ambient temperature, specified as a real-valued scalar. Units are in degrees Celsius.
Dependencies
To enable this parameter, select the Specify atmospheric parameters check box.
Data Types: double
Dry air pressure (Pa) — Atmospheric dry air pressure
101.325e3
(default) | positive real-valued scalar
Atmospheric dry air pressure, specified as a positive real-valued scalar. Units are in pascals (Pa). The default value of this parameter corresponds to one standard atmosphere.
Dependencies
To enable this parameter, select the Specify atmospheric parameters check box.
Data Types: double
Water vapour density (g/m^3) — Atmospheric water vapor density
7.5
(default) | positive real-valued scalar
Atmospheric water vapor density, specified as a positive real-valued scalar. Units are in g/m3.
Dependencies
To enable this parameter, select the Specify atmospheric parameters check box.
Data Types: double
Liquid water density (g/m^3) — Liquid water density
0.0
(default) | nonnegative real-valued scalar
Liquid water density of fog or clouds, specified as a nonnegative real-valued scalar. Units are in g/m3. Typical values for liquid water density are 0.05 for medium fog and 0.5 for thick fog.
Dependencies
To enable this parameter, select the Specify atmospheric parameters check box.
Data Types: double
Rain rate (mm/hr) — Rainfall rate
0.0
(default) | non-negative real-valued scalar
Rainfall rate, specified as a nonnegative real-valued scalar. Units are in mm/hr.
Dependencies
To enable this parameter, select the Specify atmospheric parameters check box.
Data Types: double
Inherit sample rate — Inherit sample rate from upstream blocks
on (default) | off
Select this parameter to inherit the sample rate from upstream blocks. Otherwise, specify the sample rate using the Sample rate (Hz) parameter.
Data Types: Boolean
Sample rate (Hz) — Sampling rate of signal
1e6
(default) | positive real-valued scalar
Specify the signal sampling rate as a positive scalar. Units are in Hz.
Dependencies
To enable this parameter, clear the Inherit sample rate check box.
Data Types: double
Ground reflection coefficient — Ground reflection coefficient
-1 (default) | complex-valued scalar | complex-valued 1-by-N row vector
Ground reflection coefficient for the field at the reflection point, specified as a complex-valued scalar or a complex-valued 1-by-N row vector. Coefficients have an absolute value less than or equal to one. The quantity N is the number of two-ray channels. Units are dimensionless.
Example: -0.5
Combine two rays at output — Option to combine two rays at output
on (default) | off
Select this parameter to combine the two rays at channel output. Combining the two rays coherently adds the line-of-sight propagated signal and the reflected path signal to form the output signal. You can use this mode when you do not need to include the directional gain of an antenna or array in your simulation.
Example: on
Maximum one-way propagation distance (m) — Maximum one-way propagation distance
10.0e3
(default) | positive real-valued scalar
Maximum one-way propagation distance, specified as a real-valued positive scalar. Units are in meters. Any signal that propagates more than the maximum one-way distance is ignored. The maximum distance must be greater than or equal to the largest position-to-position distance.
Example: 5000.0
Simulate using — Block simulation method
Interpreted Execution
(default) | Code Generation
Block simulation, specified as Interpreted Execution
or Code
Generation
. If you want your block to use the MATLAB® interpreter,
choose Interpreted Execution
. If you want
your block to run as compiled code, choose Code Generation
.
Compiled code requires time to compile but usually runs faster.
Interpreted execution is useful when you are developing and tuning a model. The block runs the
underlying System object™ in MATLAB. You can change and execute your model quickly. When you are satisfied
with your results, you can then run the block using Code
Generation
. Long simulations run faster with generated code than in
interpreted execution. You can run repeated executions without recompiling, but if you
change any block parameters, then the block automatically recompiles before
execution.
This table shows how the Simulate using parameter affects the overall simulation behavior.
When the Simulink® model is in Accelerator
mode, the block mode specified
using Simulate using overrides the simulation mode.
Acceleration Modes
Block Simulation | Simulation Behavior | ||
Normal | Accelerator | Rapid Accelerator | |
Interpreted Execution | The block executes using the MATLAB interpreter. | The block executes using the MATLAB interpreter. | Creates a standalone executable from the model. |
Code Generation | The block is compiled. | All blocks in the model are compiled. |
For more information, see Choosing a Simulation Mode (Simulink).
Algorithms
When the origin and destination are stationary relative to each other, the block output can be written as y(t) = x(t – τ)/L. The quantity τ is the delay and L is the propagation loss. The delay is computed from τ = R/c where R is the propagation distance and c is the propagation speed. The free space path loss is given by
where λ is the signal wavelength.
This formula assumes that the target is in the far-field of the transmitting element or array. In the near-field, the free-space path loss formula is not valid and can result in losses smaller than one, equivalent to a signal gain. For this reason, the loss is set to unity for range values, R ≤ λ/4π.
When there is relative motion between the origin and destination, the processing also introduces a frequency shift. This shift corresponds to the Doppler shift between the origin and destination. The frequency shift is v/λ for one-way propagation and 2v/λ for two-way propagation. The parameter v is the relative speed of the destination with respect to the origin.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Version History
Introduced in R2021a
See Also
Objects
phased.FreeSpace
|phased.LOSChannel
|twoRayChannel
|phased.WidebandFreeSpace
|phased.WidebandLOSChannel
|widebandTwoRayChannel
Functions
fogpl
|fspl
|gaspl
|rangeangle
|rainpl
Blocks
Topics
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)