Skip to main content

ITU-Rpy |GitHub license|

Project description

========================



A python implementation of the ITU-P R 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 <http://itu-rpy.readthedocs.io/en/latest/index.html>`__ in

Read the docs.



Examples of use cases can be found in the `examples <https://github.com/iportillo/ITU-Rpy/tree/master/examples>`__

folder.



Installation

------------



ITU-Rpy has the followind dependencies: ``numpy``, ``scipy``, ``joblib``, 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:



..code :: bash



pip install itur



More information about the installation process can be found on the `documentation <https://github.com/iportillo/ITU-Rpy/blob/master/docs/installation.rst>`__.



ITU-P Recommendations implemented:

----------------------------------



The following ITU-P Recommendations are implemented in ITU-Rpy

* **ITU-P R.453-12:** The radio refractive index: its formula and refractivity data

* **ITU-P R.618-12:** Propagation data and prediction methods required for the design of Earth-space telecommunication systems

* **ITU-P R.676-11:** Attenuation by atmospheric gases

* **ITU-P R.835-12:** Reference Standard Atmospheres

* **ITU-P R.836-5:** Water vapour: surface density and total columnar content

* **ITU-P R.837-6:** Characteristics of precipitation for propagation modelling

* **ITU-P R.838-3:** Specific attenuation model for rain for use in prediction methods

* **ITU-P R.839-4:** Rain height model for prediction methods.

* **ITU-P R.840-6:** Attenuation due to clouds and fog

* **ITU-P R.1144-7:** Interpolation methods for the geophysical properties used to compute propagation effects

* **ITU-P R.1511-1:** Topography for Earth-to-space propagation modelling

* **ITU-P R.1853-1:** Tropospheric attenuation time series synthesis



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



Usage

-----



The following code examples shows the usage of ITU-Rpy



.. code:: python



import itur

from astropy import units as u



f = 22.5 * u.GHz # Link frequency

D = 1 * 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|



.. |GitHub license| image:: https://img.shields.io/badge/license-MIT-lightgrey.svg

:target: https://raw.githubusercontent.com/Carthage/Carthage/master/LICENSE.md

.. |Attenuation worldmap| image:: https://raw.githubusercontent.com/iportillo/ITU-Rpy/master/docs/images/att_world.png




Home-page: https://github.com/iportillo/ITU-Rpy
Author: Inigo del Portillo
Author-email: portillo@mit.edu
License: MIT
Description: UNKNOWN
Keywords: atmopheric-propagation attenuation communications
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Telecommunications Industry
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6

Project details


Download files

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

Source Distribution

itur-0.1.5.tar.gz (42.9 MB view hashes)

Uploaded Source

Built Distribution

itur-0.1.5-py2.py3-none-any.whl (43.3 MB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page