PyREx Documentation¶
PyREx - (Python package for Radio Experiments)¶
PyREx (Python package for Radio Experiments) is a Python package designed to simulate the measurement of Askaryan pulses via in-ice radio antenna arrays. The code was written for the ARA collaboration with considerations for future radio arrays. As such, the package is designed to be highly modular so that it can easily be used for other radio projects (e.g. ARIANNA, RNO, and IceCube Gen2).
Useful Links¶
Source (GitHub): https://github.com/bhokansonfasig/pyrex/
Documentation: https://bhokansonfasig.github.io/pyrex/
Release notes: https://bhokansonfasig.github.io/pyrex/build/html/versions.html
Getting Started¶
Requirements¶
PyREx requires python version 3.6+ as well as numpy version 1.17+, scipy version 1.4+, and h5py version 3.0+.
After installing python from https://www.python.org/downloads/, the required packages can be installed with pip as follows, or they will be installed automatically by simply installing PyREx as specified in the next section.
pip install numpy>=1.17
pip install scipy>=1.4
pip install h5py>=3.0
Installing¶
The easiest way to get the PyREx package is using pip as follows:
pip install git+https://github.com/bhokansonfasig/pyrex#egg=pyrex
Note that since PyREx is not currently available on PyPI, a simple pip install pyrex will not have the intended effect.
Optional Dependencies¶
The following packages are not required for running PyREx by default, but may be useful or required for running some specific parts of the code:
matplotlib¶
Recommended version: 3.0+
Used for creating plots in example code and auxiliary scripts.
Examples¶
For examples of how to use PyREx, see the usage page and the examples page in the documentation, or the python notebooks and scripts in the examples directory.
Contributing¶
Contributions to the code base are mostly handled through pull requests on GitHub. Before contributing, please read the contribution page in the documentation for more information.
Authors¶
Ben Hokanson-Fasig