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).
- Source (GitHub): https://github.com/bhokansonfasig/pyrex/
- Documentation: https://bhokansonfasig.github.io/pyrex/
- Release notes: https://bhokansonfasig.github.io/pyrex/build/html/versions.html
PyREx requires python version 3.6+ as well as numpy version 1.13+, scipy version 0.19+, and h5py version 2.7+. 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.13
pip install scipy>=0.19
pip install h5py>=2.7The easiest way to get the PyREx package is using pip as follows:
pip install git+https://github.com/bhokansonfasig/pyrex#egg=pyrexNote that since PyREx is not currently available on PyPI, a simple pip install pyrex will not have the intended effect.
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:
Recommended version: 2.1+
Used for creating plots in example code and auxiliary scripts.
Recommended version: 2.1+, 0.9+
Required for building documentation. Only needed by documentation maintainers and release handlers.
Recommended version: 1.1
Used by IREX sub-package for some complex front-end circuits. Not needed for default front-ends.
For examples of how to use PyREx, see the usage page and the examples page in the documentation, or the python notebooks in the examples directory.
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.
- Ben Hokanson-Fasig
Copyright (c) 2019 Ben Hokanson-Fasig