Free space environment
The FreeSpace object models a free space environment.
To compute the propagated signal in free space:
H = phased.FreeSpace creates a free space environment System object™, H. The object simulates narrowband signal propagation in free space, by applying range-dependent time delay, gain and phase shift to the input signal.
H = phased.FreeSpace(Name,Value) creates a free space environment object, H, with each specified property Name set to the specified Value. You can specify additional name-value pair arguments in any order as (Name1,Value1,...,NameN,ValueN).
Signal propagation speed
Specify the wave propagation speed (in meters per second) in free space as a scalar.
Default: Speed of light
Signal carrier frequency
A scalar containing the carrier frequency in hertz of the narrowband signal. The default value of this property corresponds to 300 MHz.
Perform two-way propagation
Set this property to true to perform round-trip propagation between the origin and destination that you specify in the step command. Set this property to false to perform one-way propagation from the origin to the destination.
A scalar containing the sample rate (in hertz). The algorithm uses this value to determine the propagation delay in samples. The default value of this property corresponds to 1 MHz.
|clone||Create free space object with same property values|
|getNumInputs||Number of expected inputs to step method|
|getNumOutputs||Number of outputs from step method|
|isLocked||Locked status for input attributes and nontunable properties|
|release||Allow property value and input characteristics changes|
|reset||Reset internal states of propagation channel|
|step||Propagate signal from one location to another|
Calculate the result of propagating a signal in a free space environment from a radar at (1000, 0, 0) to a target at (300, 200, 50). Assume both the radar and the target are stationary.
henv = phased.FreeSpace('SampleRate',8e3); y = step(henv,ones(10,1),[1000; 0; 0],[300; 200; 50],... [0;0;0],[0;0;0]);
Calculate the result of propagating a signal in a free space environment from a radar at (1000, 0, 0) to a target at (300, 200, 50). Assume the radar moves at 10 m/s in the direction of the x-axis, while the target moves at 15 m/s in the direction of the y-axis.
henv = phased.FreeSpace('SampleRate',8e3); origin_pos = [1000; 0; 0]; dest_pos = [300; 200; 50]; origin_vel = [10; 0; 0]; dest_vel = [0; 15; 0]; y = step(henv,ones(10,1),origin_pos,dest_pos,... origin_vel,dest_vel);
When the origin and destination are stationary relative to each other, the output Y of step can be written as Y(t)=x(t–tau)/L. In this case, tau is the delay and L is the propagation loss. The delay tau is 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.
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. In this case, v is the relative speed from the origin to the destination.
For further details, see .
 Proakis, J. Digital Communications. New York: McGraw-Hill, 2001.
 Skolnik, M. Introduction to Radar Systems, 3rd Ed. New York: McGraw-Hill, 2001.