Recommendation ITU-R P.528-5 - U.S. Reference Implementation
This code repository contains the U.S. Reference Software Implementation of Recommendation ITU-R P.528. This Recommendation contains a method for predicting basic transmission loss in the frequency range 100-30 000 MHz for aeronautical services. The software implements Annex 2 of Rec P.528, the Step-by-Step method to computing propagation loss for air-to-ground paths.
Companion software (p528-gui) provides a Graphical User Interface (GUI) that can be used with this software implementation.
||Great circle path distance between terminals|
||Height of the low terminal|
||Height of the high terminal|
Outputs to P.528 are contained within a defined
||double||km||Great circle path distance. Could be slightly different than specified in input variable if within LOS region|
||double||dB||Basic transmission loss|
||double||dB||Free space basic transmission loss|
||double||dB||Median atmospheric absorption loss|
||double||rad||Elevation angle of the ray at the low terminal|
||int||Mode of propagation
Possible return codes, including the corresponding defined constant name as defined in
||Path distance must be >= 0 km|
||Low terminal height must be >= 1.5 meters|
||High terminal height must be >= 1.5 meters|
||Low terminal must be <= high terminal height|
||Frequency must be >= 100 MHz|
||Frequency must be <= 30 000 MHz|
||Time percentage must be >= 1|
||Time percentage must be <= 99|
||Terminals are occupying the same point in space (they are the same height and 0 km apart)|
||Warning that the diffraction and troposcatter model may not be physically consistent with each other. Caution should be taken when using the result|
Note: Return codes over 0xFF0 signify warnings occured in the calculation. Use bitwise OR operations to diagnosis, as more than one warning could be possible.
The below table includes a select set of example inputs and outputs for testing purposes. The P.528 CSV data files contain an extensive set of validation example values.
|100||100||15 000||3 600||0||90||151.6|
|1 500||15||10 000||5 700||0||10||293.4|
|30||8||20 000||22 000||1||50||151.1|
Notes on Code Style
- In general, variables follow the naming convention in which a single underscore denotes a subscript (pseudo-LaTeX format), where a double underscore is followed by the units, i.e. h_1__meter.
- Variables are named to match their corresponding mathematical variables in the underlying Recommendation text.
- Wherever possible, equation numbers are provided. It is assumed that a user reviewing this source code would have a copy of the Recommendation's text available as a primary reference.
Configure and Build
The software is designed to be built into a DLL (or corresponding library for non-Windows systems). The source code can be built for any OS that supports the standard C++ libraries. A Visual Studio 2019 project file is provided for Windows users to support the build process and configuration.
C#/.NET Wrapper Software
The .NET support of P.528 consists of a simple pass-through wrapper around the native DLL. It is compiled to target .NET Framework 4.7.2. Distribution and updates are provided through the published NuGet package.
For questions, contact Billy Kozma, (303) 497-6082, email@example.com