ITS.ITU.PSeries.P2108 1.0
Part of the NTIA/ITS Propagation Library
Loading...
Searching...
No Matches
HeightGainTerminalCorrectionModel.cpp File Reference

Implements the model from ITU-R P.2108 Section 3.1. More...

Functions

ReturnCode ITS::ITU::PSeries::P2108::HeightGainTerminalCorrectionModel (const double f__ghz, const double h__meter, const double w_s__meter, const double R__meter, const ClutterType clutter_type, double &A_h__db)
 Height gain terminal correction model as described in Section 3.1.
 
ReturnCode ITS::ITU::PSeries::P2108::Section3p1_InputValidation (const double f__ghz, const double h__meter, const double w_s__meter, const double R__meter)
 Input validation for the height gain terminal correction model (Section 3.1).
 
double ITS::ITU::PSeries::P2108::Equation_2a (const double nu)
 Equation (2a) of Section 3.1.
 
double ITS::ITU::PSeries::P2108::Equation_2b (const double K_h2, const double h__meter, const double R__meter)
 Equation (2b) of Section 3.1.
 

Detailed Description

Implements the model from ITU-R P.2108 Section 3.1.

Function Documentation

◆ Equation_2a()

double ITS::ITU::PSeries::P2108::Equation_2a ( const double nu)

Equation (2a) of Section 3.1.

Parameters
[in]nuDimensionless diffraction parameter
Returns
Additional loss (clutter loss), in dB

◆ Equation_2b()

double ITS::ITU::PSeries::P2108::Equation_2b ( const double K_h2,
const double h__meter,
const double R__meter )

Equation (2b) of Section 3.1.

Parameters
[in]K_h2Intermediate parameter
[in]h__meterAntenna height, in meters
[in]R__meterRepresentative clutter height, in meters
Returns
Additional loss (clutter loss), in dB

◆ HeightGainTerminalCorrectionModel()

PROPLIB_API ReturnCode ITS::ITU::PSeries::P2108::HeightGainTerminalCorrectionModel ( const double f__ghz,
const double h__meter,
const double w_s__meter,
const double R__meter,
const ClutterType clutter_type,
double & A_h__db )

Height gain terminal correction model as described in Section 3.1.

This method gives the median loss due to different terminal surroundings. This model can be applied to both transmitting and receiving ends of the path.

Frequency range: \( 0.03 \leq f \leq 3 \) (GHz)
Antenna height range: \( 0 \leq h \) (m)
Street width range: \( 0 < w_s \) (m)
Representative clutter height range: \( 0 < R \) (m)

Parameters
[in]f__ghzFrequency, in GHz
[in]h__meterAntenna height, in meters
[in]w_s__meterStreet width, in meters
[in]R__meterRepresentative clutter height, in meters
[in]clutter_typeClutter type
[out]A_h__dbAdditional loss (clutter loss), in dB
Returns
Return code

◆ Section3p1_InputValidation()

ReturnCode ITS::ITU::PSeries::P2108::Section3p1_InputValidation ( const double f__ghz,
const double h__meter,
const double w_s__meter,
const double R__meter )

Input validation for the height gain terminal correction model (Section 3.1).

Note: Input parameter 'clutter_type' is validated in the main function's switch statement through the use of default to simplify code structure.

Parameters
[in]f__ghzFrequency, in GHz
[in]h__meterAntenna height, in meters
[in]w_s__meterStreet width, in meters
[in]R__meterRepresentative clutter height, in meters
Returns
Return code
Privacy Policy FOIA Accessibility Information Quality