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
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
Release history Release notifications | RSS feed
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)
Built Distribution
itur-0.1.5-py2.py3-none-any.whl
(43.3 MB
view hashes)