p618Config
Description
The p618Config
object sets the P.618 configuration parameters
required for the calculation of the Earth-space propagation losses, cross-polarization
discrimination, and sky noise temperature, as defined in the ITU-R P.618 recommendation [1].
Creation
Description
creates a P.618
configuration object with default property values.cfgP618
= p618Config
specifies Properties using one or more name-value
pair arguments. Enclose each property name in quotes. For example,
p618Config(cfgP618
= p618Config(Name,Value
)'GasAnnualExceedance',10,'AntennaEfficiency',0.65
)
configures a P.618 configuration object with 10% average annual time percentage of excess
for gaseous attenuation and 0.65 antenna efficiency.
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
31.0769
(default) | scalar in the range [5, 90]
Elevation angle in degrees, specified as a scalar in the range [5, 90].
Data Types: double
| single
Latitude
— Earth station latitude
51.5000
(default) | scalar in the range [-90, 90]
Earth station latitude in degrees, specified as a scalar 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
— Earth station longitude
-0.1400
(default) | scalar in the range [-180, 180]
Earth station longitude in degrees, specified as a scalar in the range [-180, 180]. A positive value corresponds to East longitude, and a negative value corresponds to West longitude.
Data Types: double
| single
GasAnnualExceedance
— Average annual time percentage of excess for gaseous attenuation
1
(default) | scalar in the range [0.1, 99]
Average annual time percentage of excess for the gaseous attenuation, specified as a scalar in the range [0.1, 99]. This property calculates the gaseous attenuation, which satisfies the exceedance condition, in terms of the percentage of an average year.
Note
The fraction of time during which a preselected threshold is exceeded in an average year is referred to as the annual time percentage of excess.
Data Types: double
| single
CloudAnnualExceedance
— Average annual time percentage of excess for cloud attenuation
1
(default) | scalar in the range [0.1, 99]
Average annual time percentage of excess for the cloud attenuation, specified as a scalar in the range [0.1, 99]. This property calculates the cloud attenuation, which satisfies the exceedance condition, in terms of the percentage of an average year.
Data Types: double
| single
RainAnnualExceedance
— Average annual time percentage of excess for rain attenuation
1
(default) | scalar in the range [0.001, 5]
Average annual time percentage of excess for the rain attenuation, specified as a scalar in the range [0.001, 5]. This property calculates the rain attenuation, which satisfies the exceedance condition, in terms of the percentage of an average year.
Data Types: double
| single
ScintillationAnnualExceedance
— Average annual time percentage of excess for tropospheric scintillation
1
(default) | scalar in the range [0.01, 50]
Average annual time percentage of excess for the tropospheric scintillation, specified as a scalar in the range [0.01, 50]. This property calculates the tropospheric scintillation, which satisfies the exceedance condition, in terms of the percentage of an average year.
Data Types: double
| single
TotalAnnualExceedance
— Average annual time percentage of excess for total attenuation
1
(default) | scalar in the range [0.001, 50]
Average annual time percentage of excess for the total attenuation, specified as a scalar in the range [0.001, 50]. This property calculates the total attenuation, which satisfies the exceedance condition, in terms of the percentage of an average year.
Data Types: double
| single
PolarizationTiltAngle
— Polarization tilt angle
0
(default) | scalar in the range [-90, 90]
Polarization tilt angle in degrees, specified as a scalar in the range [-90, 90].
Data Types: double
| single
AntennaDiameter
— Physical diameter of earth station antenna
1
(default) | positive scalar
Physical diameter of the earth station antenna in meters, specified as a positive scalar.
Data Types: double
| single
AntennaEfficiency
— Antenna efficiency of earth station antenna
0.5
(default) | positive scalar
Antenna efficiency of the earth station antenna, specified as a positive scalar.
Data Types: double
| single
Object Functions
Specific to This Object
p618PropagationLosses | Calculate Earth-space propagation losses, cross-polarization discrimination, and sky noise temperature |
Examples
Create P.618 Configuration Object
Create a default P.618 configuration object.
cfg = p618Config;
Specify the signal frequency as 25 GHz, elevation angle as 45 degrees, and antenna efficiency as 0.65. Set the time percentage of excess for the total attenuation per annum as 0.001.
cfg.Frequency = 25e9; cfg.ElevationAngle = 45; cfg.AntennaEfficiency = 0.65; cfg.TotalAnnualExceedance = 0.001;
Set the earth station direction.
cfg.Latitude = 30; % North direction cfg.Longitude = 120; % East direction
Display the properties of the configuration object.
disp(cfg)
p618Config with properties: Frequency: 2.5000e+10 ElevationAngle: 45 Latitude: 30 Longitude: 120 GasAnnualExceedance: 1 CloudAnnualExceedance: 1 RainAnnualExceedance: 1 ScintillationAnnualExceedance: 1 TotalAnnualExceedance: 1.0000e-03 PolarizationTiltAngle: 0 AntennaDiameter: 1 AntennaEfficiency: 0.6500
Calculate Propagation Losses, Cross-Polarization Discrimination, and Sky Noise Temperature
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 unzip 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 default P.618 configuration object.
cfg = p618Config;
Specify the time percentage of excess for the rain attenuation per annum as 0.01 and the time percentage of excess for the total attenuation per annum as 0.001.
cfg.RainAnnualExceedance = 0.01; cfg.TotalAnnualExceedance = 0.001;
Calculate the propagation losses, cross-polarization discrimination, and sky noise temperature.
[pl,xpd,tsky] = p618PropagationLosses(cfg)
pl = struct with fields:
Ag: 0.2269
Ac: 0.4552
Ar: 6.7981
As: 0.2633
At: 15.6091
xpd = 32.8876
tsky = 267.4689
Calculate Propagation Losses in Light Rainfall
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 unzip 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 configuration object that occupies a signal frequency of 20 GHz.
cfg = p618Config('Frequency',20e9);
Calculate the propagation losses in a light rainfall of 1 mm/hr with an earth station height of 0.75 km.
pl = p618PropagationLosses(cfg,'RainRate',1,'StationHeight',0.75)
pl = struct with fields:
Ag: 0.7996
Ac: 0.8793
Ar: 0.0177
As: 0.3187
At: 1.7514
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
MATLAB-Befehl
Sie haben auf einen Link geklickt, der diesem MATLAB-Befehl entspricht:
Führen Sie den Befehl durch Eingabe in das MATLAB-Befehlsfenster aus. Webbrowser unterstützen keine MATLAB-Befehle.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)