p618SiteDiversityConfig

Create P.618 site diversity configuration object

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

Syntax

cfgSD = p618SiteDiversityConfig

cfgSD = p618SiteDiversityConfig(Name,Value)

Description

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

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

Frequency — Signal frequency

14.25e9 (default) | scalar in the range [1e9, 55e9]

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

Data Types: double | single

ElevationAngle — Elevation angle of two sites

[52.4099 52.4852] (default) | two-element vector of values in the range [0, 90]

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 — Latitude of two sites

[25.768 25.463] (default) | two-element vector of values in the range [-90, 90]

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 — Longitude of two sites

[-80.205 -80.486] (default) | two-element vector of values in the range [-180, 180]

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

PolarizationTiltAngle — Polarization tilt angle for two sites

[0 0] (default) | two-element vector of values in the range [-90, 90]

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

SiteDistance — Separation between two sites

44.0256 (default) | positive scalar

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

Data Types: double | single

AttenuationThreshold — Attenuation threshold on two links

[9 3] (default) | two-element vector

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

Specific to This Object

p618SiteDiversityOutage

Calculate outage probability due to rain attenuation with site diversity

Examples

Create P.618 Site Diversity Configuration Object

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]

   Read-only properties:
    No properties.

Calculate Outage Probability due to Rain Attenuation with Site Diversity

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.

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');
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™.