Main Content

p618SiteDiversityConfig

Create P.618 site diversity configuration object

Since R2021a

    Description

    The p618SiteDiversityConfig object sets P.618 site diversity configuration parameters required for the calculation of outage probability due to rain attenuation, as defined in the ITU-R P.618 recommendation [1].

    Creation

    Description

    cfgSD = p618SiteDiversityConfig creates a P.618 site diversity configuration object with default property values.

    example

    cfgSD = p618SiteDiversityConfig(Name,Value) specifies Properties using one or more name-value pair arguments. Enclose each property name in quotes. For example, p618SiteDiversityConfig('Frequency',14.25e9,'ElevationAngle',[52.4099 52.4852]) configures a P.618 site diversity configuration object with a 14.25 GHz signal frequency and an elevation angle for two sites as [52.4099 52.4852].

    Properties

    expand all

    Signal frequency in Hz, specified as a scalar in the range [1e9, 55e9].

    Data Types: double | single

    Elevation angle of the two sites in degrees, specified as a two-element vector of values in the range [0, 90].

    Data Types: double | single

    Latitude of the two sites in degrees, specified as a two-element vector of values in the range [-90, 90]. A positive value corresponds to a North latitude, and a negative value corresponds to a South latitude.

    Data Types: double | single

    Longitude of the two sites in degrees, specified as a two-element vector of values in the range [-180, 180]. A positive value corresponds to East longitude, and a negative value corresponds to West longitude.

    Data Types: double | single

    Polarization tilt angle for the two sites in degrees, specified as a two-element vector of values in the range [-90, 90].

    Data Types: double | single

    Separation between the two sites in km, specified as a positive scalar.

    Data Types: double | single

    Attenuation threshold on the two links in dB, specified as a two-element vector. The attenuation threshold on an earth space link is the maximum allowed attenuation on the path. Any attenuation value above this property value is considered an outage in the link.

    Data Types: double | single

    Object Functions

    expand all

    p618SiteDiversityOutageCalculate outage probability due to rain attenuation with site diversity

    Examples

    collapse all

    Create a default P.618 site diversity configuration object.

    cfg = p618SiteDiversityConfig;

    Specify the polarization tilt angles for two sites as [-90 90] degrees, separation between the two sites as 50 km, and attenuation threshold on the two links as [9 9] dB.

    cfg.PolarizationTiltAngle = [-90 90];
    cfg.SiteDistance = 50;
    cfg.AttenuationThreshold = [9 9];

    Set the direction of each earth station.

    cfg.Latitude = [30 60];    % North direction
    cfg.Longitude = [120 150]; % East direction

    Display the properties of the configuration object.

    disp(cfg);
      p618SiteDiversityConfig with properties:
    
                    Frequency: 1.4500e+10
               ElevationAngle: [52.4099 52.4852]
                     Latitude: [30 60]
                    Longitude: [120 150]
        PolarizationTiltAngle: [-90 90]
                 SiteDistance: 50
         AttenuationThreshold: [9 9]
    

    This example requires MAT-files with digital maps from ITU documents. If they are not available on the path, execute the following commands to download and untar the MAT-files.

    maps = exist('maps.mat','file');
    p836 = exist('p836.mat','file');
    p837 = exist('p837.mat','file');
    p840 = exist('p840.mat','file');
    matFiles = [maps p836 p837 p840];
    if ~all(matFiles)
        if ~exist('ITURDigitalMaps.tar.gz','file')
            url = 'https://www.mathworks.com/supportfiles/spc/P618/ITURDigitalMaps.tar.gz';
            websave('ITURDigitalMaps.tar.gz',url);
            untar('ITURDigitalMaps.tar.gz');
        else
            untar('ITURDigitalMaps.tar.gz');
        end
        addpath(cd);
    end

    Create a P.618 site diversity configuration object with a signal frequency of 25 GHz.

    cfgsd = p618SiteDiversityConfig;
    cfgsd.Frequency = 25e9;

    Specify the polarization tilt angles for two sites as [-90 90] degrees, separation between the two sites as 50 km, and attenuation threshold on the two links as [9 9] dB.

    cfgsd.PolarizationTiltAngle = [-90 90];
    cfgsd.SiteDistance = 50;
    cfgsd.AttenuationThreshold = [9 9];

    Calculate the outage probability due to rain attenuation with site diversity.

    outage = p618SiteDiversityOutage(cfgsd)
    outage = 0.0338
    

    References

    [1] International Telecommunication Union, ITU-R Recommendation P.618 (12/2017).

    Extended Capabilities

    C/C++ Code Generation
    Generate C and C++ code using MATLAB® Coder™.

    Version History

    Introduced in R2021a