towerpy-rd 1.0.0

Towerpy: an open-source toolbox for processing polarimetric radar data

:satellite: TOWERPY

Towerpy is an open-source toolbox designed for reading, processing and displaying polarimetric weather radar data.

:books: Documentation

You can find more details about Towerpy here.

:speech_balloon: Citing

If you find towerpy useful for a scientific publication, please consider citing the towerpy paper:

@article{sanchezrivas2023, title = {{Towerpy: An open-source toolbox for processing polarimetric weather radar data}}, journal = {Environmental Modelling & Software}, pages = {105746}, year = {2023}, issn = {1364-8152}, doi = {https://doi.org/10.1016/j.envsoft.2023.105746}, author = {Daniel Sanchez-Rivas and Miguel Angel Rico-Ramirez}, keywords = {Weather radar, Polarimetry, Radar QPE, Radar research applications, Open source} }

:hammer: Installing towerpy

To ensure a smooth installation of towerpy, we strongly recommend using conda, the open-source Python package management system. Download and install Anaconda to get conda and other essential data science and machine learning packages.

Once Anaconda is installed and working, create a new environment to install towerpy:

conda create -n towerpy python=3.10

Activate the new environment:

conda activate towerpy

Then install the required dependencies and additional dependencies helpful for scientific computing:

conda install -c conda-forge numpy matplotlib scipy ipython jupyter pandas netcdf4 sympy nose spyder cartopy metpy scikit-learn

Finally, install the latest version of towerpy using:

python -m pip install --upgrade git+https://github.com/uobwatergroup/towerpy.git@main

Installing from source

Optionally, you can get the towerpy source code from the GitHub repository.

Either download and unpack the zip file of the source code or use git to clone the repository:

git clone https://github.com/uobwatergroup/towerpy.git

Once inside the folder where towerpy was downloaded, it can be installed by using pip:

python -m pip install .

Or install Towerpy in “editable” mode.

python -m pip install -e .

:snake: Dependencies

The following dependencies are required to work with towerpy:

Package	Required
NumPy	v1.21+
SciPy	v1.7.1+
Matplotlib	v3.5.2+
Cartopy	v0.19+
netCDF4	vv1.5.8+

*Some modules within towerpy run using shared objects/dynamic link libraries (.so, .dll). These libraries are automatically installed during the towerpy installation.

:thought_balloon: Missing a specific feature? Found a bug?

Feel free to post a message to our discussions page or have a look at our contribution guidelines to find out about our coding standards.

:construction_worker: Team

Towerpy is created and maintained by Daniel Sanchez-Rivas and Miguel A Rico-Ramirez