ITU-Rpy documentation

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

  • A complete overview of the contents of this documentation can be found in the Table of Contents at the bottom of this page.
  • Instructions on how to install ITU-Rpy are located at the Installation page.
  • Results of running ITU-Rpy against the validation examples provided by the ITU (where available) are available at the Validation page.

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/inigodelportillo/ITU-Rpy/}}
}

Usage and examples

The Quick Start guide provides different examples on how to use ITUR-py.

Additional examples can be found in the examples folder, and the snippet of code below.

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.plotting.plot_in_map(Att.value, lat, lon,
                       cbar_text='Atmospheric attenuation [dB]')

which produces

attenuation to single ground station

Atmospheric attenuation worldmap @ 22.5 GHz.

Indices and tables

Other

ITU-Rpy is mainly written in Python 3 and continuously tested with Python 3.5-3.9.

ITU-Rpy has the following dependencies: numpy, scipy, pyproj, and astropy. Installing cartopy and matplotlib is recommended to display results in a map.