Skip to main content

pycraf

Project description

PyPI tag License

The pycraf Python package provides functions and procedures for various tasks in spectrum-management compatibility studies. A typical example would be to calculate the interference levels at a radio telescope produced from a radio broadcasting tower.

Releases are registered on PyPI, and development is occurring at the project’s github page.

Project Status

Pycrafs's Travis CI Status Pycrafs's AppVeyor CI Status Pycrafs's Coveralls Status

pycraf is still in the early-development stage. While much of the functionality is already working as intended, the API is not yet stable. Nevertheless, we kindly invite you to use and test the library and we are grateful for feedback. Note, that work on the documentation is still ongoing.

Features

  • Full implementation of ITU-R Rec. P.452-16 that allows to calculate path attenuation for the distance between interferer and victim service. Supports to load NASA’s Shuttle Radar Topography Mission (SRTM) data for height-profile generation.

  • Full implementation of ITU-R Rec. P.676-10, which provides two atmospheric models to calculate the attenuation for paths through Earth’s atmosphere.

  • Provides various antenna patterns necessary for compatibility studies (e.g., RAS, IMT, fixed-service links).

  • Functions to convert power flux densities, field strengths, transmitted and received powers at certain distances and frequencies into each other.

Usage

Examples and Documentation

We provide an online documentation and API reference. Furthermore, you can find tutorials and HowTos in the notebooks directory on the pycraf repository.

Testing

After installation (see below) you can test, if everything works as intended:

import pycraf

pycraf.test()

By default, the test function will skip over tests that require data from the internet. One can include them by:

pycraf.test(remote_data='any')

This will always download SRTM data (few tiles only) to test the auto-download functionality! Do this only, if you can afford the network traffic.

License

Several licenses apply; see the license directory in the repository. The pycraf Python package itself is published under GPL v3, an open-source license.

For some of the functionality provided in pycraf, data files provided by the ITU are necessary. For example, the atmospheric model in the pycraf.atm subpackage implements the algorithm described in ITU-R Recommendation P.676. Annex 1 of this Recommendation makes use of spectroscopic information of the oxygen and water vapour lines given in Tables 1 and 2 of P.676. Another example are the radiometeorological data files that are distributed alongside ITU-R Rec. P.452-16

ITU kindly gave us permission to include data files into pycraf that are distributed with the Recommendations on the ITU servers. This makes it possible to just use pycraf without the need to manually download necessary data files. However, these data files are not free for commercial use. For details, please see the LICENSE.ITU file.

Since pycraf uses the Astropy Package Template for packaging, we also refer to the associated license.

Installation

The easiest way to install pycraf is via pip:

pip install pycraf

The installation is also possible from source. Download the tar.gz-file, extract (or clone from GitHub) and simply execute:

python setup.py install

Dependencies

We kept the dependencies as minimal as possible. The following packages are required:

  • setuptools

  • cython 0.23 or later

  • numpy 1.11 or later

  • astropy 1.3 or later (2.0 recommended)

  • scipy 0.15 or later

  • pytest 2.6 or later

The following packages are optional, and you will need them for certain features and to build the docs:

  • matplotlib 1.2 or later; for some plot helpers

  • pyproj 1.9 or later; for the geospatial subpackage

  • sgp4 1.4 or later; for the satellite subpackage

For further details, we refer to the online documention installation instructions. It also includes some hints for running pycraf on Windows or MacOS.

SRTM data

To make full use of the path attenuation calculations provided by pycraf (implements ITU-R Rec. P.452), we recommend to use NASA’s Shuttle Radar Topography Mission (SRTM) data for height-profile generation. pycraf can work with so-called .hgt files, a very simple binary format. Each .hgt file, a so-called tile, just contains 1201x1201 16-bit integers. From the file naming scheme, one can infer the associated coordinates. Most tiles contain one square-degree.

Unfortunately, we cannot provide SRTM data as part of the package, due to the large file sizes and legal reasons. But once you downloaded the necessary tiles (all or only a subset appropriate for your region), simply define the environment variable SRTMDATA, let it point to the folder containing the tiles, and pycraf will find the files when it is imported from Python.

On windows:

set SRTMDATA=C:\[path-to-srtm]\

On Linux/MacOS (sh-like):

export SRTMDATA=[path-to-srtm]/

There is also the possibility to change the path to the SRTM directory during run-time (see documentation).

Acknowledgments

We are very grateful for the kind support from ITU study groups and ITU’s legal department.

This code is makes use of the excellent work provided by the Astropy community. pycraf uses the Astropy package and also the Astropy Package Template for the packaging.

Who do I talk to?

If you encounter any problems or have questions, do not hesitate to raise an issue or make a pull request. Moreover, you can contact the devs directly:

  • bwinkel@mpifr.de

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

pycraf-0.25.5.tar.gz (5.2 MB view hashes)

Uploaded Source

Built Distributions

pycraf-0.25.5-cp36-cp36m-win_amd64.whl (5.4 MB view hashes)

Uploaded CPython 3.6m Windows x86-64

pycraf-0.25.5-cp36-cp36m-macosx_10_9_x86_64.whl (5.5 MB view hashes)

Uploaded CPython 3.6m macOS 10.9+ x86-64

pycraf-0.25.5-cp35-cp35m-win_amd64.whl (5.4 MB view hashes)

Uploaded CPython 3.5m Windows x86-64

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