P2108.h

Go to the documentation of this file.

 
#pragma once
 
#include <string>         // for std::string
#include <unordered_map>  // for std::unordered_map
 
namespace ITS {
namespace ITU {
namespace PSeries {
namespace P2108 {
 
// Define cross-platform PROPLIB_API to export functions
#ifndef DOXYGEN_SHOULD_SKIP
    #ifndef PROPLIB_API
        #ifdef _WIN32
            #define PROPLIB_API extern "C" __declspec(dllexport)
        #else
            #define PROPLIB_API extern "C"
        #endif
    #endif
#endif
 
// Enums
 
enum ClutterType {
    WATER_SEA = 1,    
    OPEN_RURAL = 2,   
    SUBURBAN = 3,     
    URBAN = 4,        
    TREES_FOREST = 5, 
    DENSE_URBAN = 6,  
};
 
 
enum RepresentativeClutterHeight {
    R__WATER_SEA = 10,    
    R__OPEN_RURAL = 10,   
    R__SUBURBAN = 10,     
    R__URBAN = 15,        
    R__TREES_FOREST = 15, 
    R__DENSE_URBAN = 20,  
};
 
 
// clang-format off
enum ReturnCode {
    SUCCESS = 0,               
    // Section 3.1 Error Codes
    ERROR31__FREQUENCY = 32,   
    ERROR31__ANTENNA_HEIGHT,   
    ERROR31__STREET_WIDTH,     
    ERROR31__CLUTTER_HEIGHT,   
    ERROR31__CLUTTER_TYPE,     
    // Section 3.2 Error Codes
    ERROR32__FREQUENCY = 48,   
    ERROR32__DISTANCE,         
    ERROR32__PERCENTAGE,       
    // Section 3.3 Error Codes
    ERROR33__FREQUENCY = 64,   
    ERROR33__THETA,            
    ERROR33__PERCENTAGE,       
};
// clang-format on
 
// Constants
constexpr double PI = 3.14159265358979323846;
 
// Public Functions
PROPLIB_API ReturnCode AeronauticalStatisticalModel(
    const double f__ghz,
    const double theta__deg,
    const double p,
    double &L_ces__db
);
PROPLIB_API ReturnCode TerrestrialStatisticalModel(
    const double f__ghz, const double d__km, const double p, double &L_ctt__db
);
PROPLIB_API ReturnCode 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
);
PROPLIB_API char *GetReturnStatusCharArray(const int code);
PROPLIB_API void FreeReturnStatusCharArray(char *c_msg);
 
// Private Functions
std::string GetReturnStatus(const int code);
double cot(const double x);
double InverseComplementaryCumulativeDistribution(const double q);
double Equation_2a(const double nu);
double Equation_2b(
    const double K_h2, const double h__meter, const double R__meter
);
ReturnCode Section3p1_InputValidation(
    const double f__ghz,
    const double h__meter,
    const double w_s__meter,
    const double R__meter
);
ReturnCode Section3p2_InputValidation(
    const double f__ghz, const double d__km, const double p
);
ReturnCode Section3p3_InputValidation(
    const double f__ghz, const double theta__deg, const double p
);
double TerrestrialStatisticalModelHelper(
    const double f__ghz, const double d__km, const double p
);
 
 
}  // namespace P2108
}  // namespace PSeries
}  // namespace ITU
}  // namespace ITS