Skip to main content

A python implementation of the ITU-R P. Recommendations

Project description

GitHub license Build Status PyPI version Coverage Status

A python implementation of the ITU-R P. Recommendations to compute atmospheric attenuation in slant and horizontal paths.

The propagation loss on an Earth-space path and a horizontal-path, relative to the free-space loss, is the sum of different contributions, namely: attenuation by atmospheric gases; attenuation by rain, other precipitation and clouds; scintillation and multipath effects; attenuation by sand and dust storms. Each of these contributions has its own characteristics as a function of frequency, geographic location and elevation angle. ITU-Rpy allows for fast, vectorial computation of the different contributions to the atmospheric attenuation.

Documentation

The documentation can be found at ITU-Rpy documentation in Read the docs.

Examples of use cases can be found in the examples folder.

Installation

ITU-Rpy has the followind dependencies: numpy, scipy, joblib, pyproj, and astropy. Installation of basemap and matplotlib is recommended to display results in a map.

Using pip, you can install all of them by running:

pip install itur

More information about the installation process can be found on the documentation.

ITU-R Recommendations implemented:

The following ITU-R Recommendations are implemented in ITU-Rpy * ITU-R P.453-13: The radio refractive index: its formula and refractivity data * ITU-R P.618-13: Propagation data and prediction methods required for the design of Earth-space telecommunication systems * ITU-R P.676-11: Attenuation by atmospheric gases * ITU-R P.835-6: Reference Standard Atmospheres * ITU-R P.836-6: Water vapour: surface density and total columnar content * ITU-R P.837-7: Characteristics of precipitation for propagation modelling * ITU-R P.838-3: Specific attenuation model for rain for use in prediction methods * ITU-R P.839-4: Rain height model for prediction methods. * ITU-R P.840-7: Attenuation due to clouds and fog * ITU-R P.1144-7: Interpolation methods for the geophysical properties used to compute propagation effects * ITU-R P.1511-1: Topography for Earth-to-space propagation modelling * ITU-R P.1853-1: Tropospheric attenuation time series synthesis

The individual models can be accessed using the itur.models package.

Usage

The following code example shows the usage of ITU-Rpy. More examples can be found in the examples folder.

import itur

f = 22.5 * itur.u.GHz    # Link frequency
D = 1 * itur.u.m         # Size of the receiver antenna
el = 60                  # Elevation angle constant of 60 degrees
p = 3                    # Percentage of time that attenuation values are exceeded.

# Generate a regular grid latitude and longitude points with 1 degrees resolution
lat, lon = itur.utils.regular_lat_lon_grid()

# Comute the atmospheric attenuation
Att = itur.atmospheric_attenuation_slant_path(lat, lon, f, el, p, D)
itur.utils.plot_in_map(Att.value, lat, lon,
                       cbar_text='Atmospheric attenuation [dB]')

which produces: Attenuation worldmap

Citation

If you use ITU-Rpy in one of your research projects, please cite it as:

@misc{iturpy-2017,
      title={ITU-Rpy: A python implementation of the ITU-R P. Recommendations to compute atmospheric
         attenuation in slant and horizontal paths.},
      author={Inigo del Portillo},
      year={2017},
      publisher={GitHub},
      howpublished={\url{https://github.com/iportillo/ITU-Rpy/}}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
itur-0.2.1-py2.py3-none-any.whl (108.7 MB) Copy SHA256 hash SHA256 Wheel py2.py3
itur-0.2.1.tar.gz (106.9 MB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page