TwoRayGroundReflection¶

Package: inet.physicallayer.wireless.common.pathloss

compound module TwoRayGroundReflection

Implements the two-ray ground reflection path loss model for wireless communications. This model accounts for both the direct line-of-sight path and a ground-reflected path between transmitter and receiver. For distances less than the crossover distance, it uses the free space model; beyond that, it applies the two-ray formula which considers transmitter and receiver heights above ground. (The crossover distance is computed from the heights and the frequency.) This model provides more accurate predictions than free space models for medium to long distances in environments with significant ground reflections.

See also: TwoRayInterference

Inheritance diagram¶

Extends¶

Name	Type	Description
FreeSpacePathLoss	compound module	Implements the free space path loss model, which models signal attenuation over distance according to the Friis transmission equation. Calculates signal power loss as a function of distance, wavelength, and configurable parameters. The alpha parameter controls the path loss exponent (default 2), while the systemLoss parameter accounts for hardware inefficiencies. Provides an ideal baseline model for wireless propagation in environments with line-of-sight and no obstacles.

Parameters¶

Name	Type	Default value	Description
displayStringTextFormat	string	“”	Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
alpha	double	2
systemLoss	double	0dB
physicalEnvironmentModule	string	“physicalEnvironment”	The path of the environment model relative to the network

Properties¶

Name	Value	Description
class	TwoRayGroundReflection
display	i=block/control

Source code¶

//
// Implements the two-ray ground reflection path loss model for wireless
// communications. This model accounts for both the direct line-of-sight path and
// a ground-reflected path between transmitter and receiver. For distances less
// than the crossover distance, it uses the free space model; beyond that, it
// applies the two-ray formula which considers transmitter and receiver heights
// above ground. (The crossover distance is computed from the heights and
// the frequency.) This model provides more accurate predictions than free space
// models for medium to long distances in environments with significant ground
// reflections.
//
// @see TwoRayInterference
//
module TwoRayGroundReflection extends FreeSpacePathLoss
{
    parameters:
        @class(TwoRayGroundReflection);
        string physicalEnvironmentModule = default("physicalEnvironment"); // The path of the environment model relative to the network
}

File: src/inet/physicallayer/wireless/common/pathloss/TwoRayGroundReflection.ned