Py-ART

A data model driven interactive toolkit for working with weather radar data.
https://github.com/arm-doe/pyart

Category: Atmosphere
Sub Category: Meteorological Observation and Forecast

Keywords

closember data-visualization hacktoberfest pyart python radar-processing weather-radars

Keywords from Contributors

meteorology atmospheric-science weather radar measur scattering retrieval meteorological-data precipitation corrections

Last synced: about 5 hours ago
JSON representation

Repository metadata

The Python-ARM Radar Toolkit. A data model driven interactive toolkit for working with weather radar data.

• Host: GitHub
• URL: https://github.com/arm-doe/pyart
• Owner: ARM-DOE
• License: other
• Created: 2012-10-16T17:51:30.000Z (over 12 years ago)
• Default Branch: main
• Last Pushed: 2025-04-21T16:12:40.000Z (5 days ago)
• Last Synced: 2025-04-22T19:44:18.514Z (4 days ago)
• Topics: closember, data-visualization, hacktoberfest, pyart, python, radar-processing, weather-radars
• Language: Python
• Homepage: https://arm-doe.github.io/pyart/
• Size: 571 MB
• Stars: 547
• Watchers: 60
• Forks: 273
• Open Issues: 48
• Releases: 64
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE.txt
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Roadmap: roadmaps/pyart-roadmap-rc1.0.pdf

README.rst

          .. -*- mode: rst -*-
The Python ARM Radar Toolkit (Py-ART)
=====================================

|GithubCI| |CodeCovStatus|

|AnacondaCloud| |PyPiDownloads| |CondaDownloads|

|DocsUsers| |DocsGuides|

|ARM| |Tweet|

.. |GithubCI| image:: https://github.com/ARM-DOE/pyart/actions/workflows/ci.yml/badge.svg
    :target: https://github.com/ARM-DOE/pyart/actions?query=workflow%3ACI

.. |CodeCovStatus| image:: https://img.shields.io/codecov/c/github/ARM-DOE/pyart.svg?logo=codecov
    :target: https://codecov.io/gh/ARM-DOE/pyart

.. |AnacondaCloud| image:: https://anaconda.org/conda-forge/arm_pyart/badges/version.svg
    :target: https://anaconda.org/conda-forge/arm_pyart

.. |PyPiDownloads| image:: https://img.shields.io/pypi/dm/arm_pyart.svg
    :target: https://pypi.org/project/arm-pyart/

.. |CondaDownloads| image:: https://anaconda.org/conda-forge/arm_pyart/badges/downloads.svg
    :target: https://anaconda.org/conda-forge/arm_pyart/files

.. |DocsUsers| image:: https://img.shields.io/badge/docs-users-4088b8.svg
    :target: http://arm-doe.github.io/pyart/API/index.html

.. |DocsGuides| image:: https://img.shields.io/badge/docs-guides-4088b8.svg
    :target: https://github.com/ARM-DOE/pyart/tree/main/guides/

.. |ARM| image:: https://img.shields.io/badge/Sponsor-ARM-blue.svg?colorA=00c1de&colorB=00539c
    :target: https://www.arm.gov/

.. |Tweet| image:: https://img.shields.io/twitter/url/http/shields.io.svg?style=social
    :target: https://twitter.com/Py_ART

The Python ARM Radar Toolkit, Py-ART, is an open source Python module
containing a growing collection of weather radar algorithms and utilities
build on top of the Scientific Python stack and distributed under the
3-Clause BSD license. Py-ART is used by the
`Atmospheric Radiation Measurement (ARM) User Facility
`_ for working with data from a number of precipitation
and cloud radars, but has been designed so that it can be used by others in
the radar and atmospheric communities to examine, processes, and analyze
data from many types of weather radars.


Important Links
===============

- Official source code repository: https://github.com/ARM-DOE/pyart
- HTML documentation: https://arm-doe.github.io/pyart/
- Examples: https://arm-doe.github.io/pyart/examples
- Mailing List: https://openradar.discourse.group/tag/py-art
- Issue Tracker: https://github.com/ARM-DOE/pyart/issues


Citing
======

If you use the Python ARM Radar Toolkit (Py-ART) to prepare a publication
please cite:

    Helmus, J.J. & Collis, S.M., (2016). The Python ARM Radar Toolkit
    (Py-ART), a Library for Working with Weather Radar Data in the Python
    Programming Language. Journal of Open Research Software. 4(1), p.e25.
    DOI: http://doi.org/10.5334/jors.119

Py-ART implements many published scientific methods which should *also* be
cited if you make use of them. Refer to the **References** section in the
documentation of the functions used for information on these citations.


Install
=======

The easiest method for installing Py-ART is to use the conda packages from
the latest release and use Python 3, as Python 2 support ended January 1st,
2020 and many packages including Py-ART no longer support Python 2.
To do this you must download and install
`Anaconda `_ or
`Miniconda `_.
With Anaconda or Miniconda install, it is recommended to create a new conda
environment when using Py-ART or even other packages. To create a new
environment based on the `environment.yml `_::

    conda env create -f environment.yml

Or for a basic environment and downloading optional dependencies as needed::

    conda create -n pyart_env -c conda-forge python=3.9 arm_pyart

Basic command in a terminal or command prompt to install the latest version of
Py-ART::

    conda install -c conda-forge arm_pyart

To update an older version of Py-ART to the latest release use::

    conda update -c conda-forge arm_pyart

If you are using mamba::

    mamba install -c conda-forge arm_pyart

If you do not wish to use Anaconda or Miniconda as a Python environment or want
to use the latest, unreleased version of Py-ART see the section below on
**Installing from source**.


Configuration
=============

The configuration file in Py-ART specifies the default metadata, field names,
colormaps and plot limits. A custom configuration can be loaded
automatically be setting the environmental variable **PYART_CONFIG** to point
to a custom configuration file. For additional details on this process see the
documentation on the `pyart.load_config` function.


Extensions and related software
===============================

A number of projects are available which extend the functionality of Py-ART.
These include:

* `ARTView `_ :
  Interactive radar viewing browser.

* `pyrad `_ :
  A real-time data processing framework developed by MeteoSwiss and MeteoFrance.

* `PyTDA `_ :
  Python Turbulence Detection Algorithm.

* `SingleDop `_ :
  Single Doppler Retrieval Toolkit.

* `DualPol `_ :
  Python Interface to Dual-Pol Radar Algorithms.

* `PyBlock `_:
  Python Polarimetric Radar Beam Blockage Calculation


Other related open source software for working with weather radar data:

* `wradlib `_ :
  An open source library for weather radar data processing.

* `BALTRAD `_ : Community-based weather radar networking.

* `MMM-Py `_ :
  Marshall MRMS Mosaic Python Toolkit.

* `CSU_RadarTools `_ :
  Colorado State University Radar Tools.

* `TRMM RSL `_ :
  TRMM Radar Software Library.

* `RadX `_ :
  Radx C++ Software Package for Radial Radar Data.

* `PyDDA `_ :
  Software designed to retrieve wind kinematics in precipitation storm systems
  from one or more Doppler weather radars.


Dependencies
============

Py-ART is tested to work under Python 3.11, 3.12, and 3.13.

The required dependencies to install Py-ART in addition to Python are:

* `NumPy `_
* `SciPy `_
* `matplotlib `_
* `netCDF4 `_
* `pooch `_
* `Cython `_
* `setuptools `_
* `cartopy `_
* `cmweather `_

A working C/C++ compiler is required for some optional modules. An easy method
to install these dependencies is by using a
`Scientific Python distributions `_.
`Anaconda `_ will install all of
the above packages by default on Windows, Linux and Mac computers and is
provided free of charge by Anaconda. Anaconda also has their own compilers,
which may be required for optional dependencies such as CyLP. These compilers
can be found here:
https://docs.conda.io/projects/conda-build/en/latest/resources/compiler-tools.html


Optional Dependences
====================

The above Python modules are require before installing Py-ART, additional
functionality is available of the following modules are installed.

* `TRMM Radar Software Library (RSL)
  `_.
  If installed Py-ART will be able to read in radar data in a number of
  additional formats (Lassen, McGill, Universal Format, and RADTEC) and
  perform automatic dealiasing of Doppler velocities.  RSL should be
  install prior to installing Py-ART. The environmental variable `RSL_PATH`
  should point to the location where RSL was installed if RSL was not
  installed in the default location (/usr/local/trmm), such as a anaconda path
  (/usr/anaconda3/envs/pyart_env/.

* In order to read files which are stored in HDF5 files the
  `h5py `_ package and related libraries must be
  installed.

* A linear programming solver and Python wrapper to use the LP phase
  processing method. `CyLP `_ is recommended as
  it gives the fastest results, but
  `PyGLPK `_ and
  `CVXOPT `_ are also supported. The underlying LP
  solvers `CBC `_ or
  `GLPK `_ will also be required depending
  on which wrapper is used. When using `CyLP `_
  a path to coincbc is needed by setting the `COIN_INSTALL_DIR` path, such as
  (/usr/anaconda3/envs/pyart_env/).

* `Cartopy `_. If installed,
  the ability to plot grids on geographic maps is available.

* `xarray `_. If installed, gives the
  ability to work with the grid dataset used in grid plotting.

* `Basemap `_. If installed, also gives the
  ability to plot grids on geographic maps, but Cartopy is recommended over
  Basemap.

* `wradlib `_.  Needed to calculate the texture
  of a differential phase field.

* `pytest `_.
  Required to run the Py-ART unit tests.

* `gdal `_.
  Required to output GeoTIFFs from `Grid` objects.

Installing from source
======================

Installing Py-ART from source is the only way to get the latest updates and
enhancement to the software that have not yet made it into a release.
The latest source code for Py-ART can be obtained from the GitHub repository,
https://github.com/ARM-DOE/pyart. Either download and unpack the
`zip file `_ of
the source code or use git to checkout the repository::

    git clone https://github.com/ARM-DOE/pyart.git

To install in your home directory, use::

    python setup.py install --user

To install for all users on Unix/Linux::

    python setup.py build
    sudo python setup.py install

Development install using pip from within Py-ART directory::

    pip install -e .


Development
===========

Py-ART is an open source, community software project. Contributions to
the package are welcomed from all users.

Code
----
The latest source code can be obtained with the command::

    git clone https://github.com/ARM-DOE/pyart.git

If you are planning on making changes that you would like included in Py-ART,
forking the repository is highly recommended.

Getting help
------------
Py-ART has a `Discussion Forum `_ where you can ask questions and request help.

Contributing
-------------

We welcome contributions for all uses of Py-ART, provided the code can be
distributed under the BSD 3-clause license. A copy of this license is
available in the **LICENSE.txt** file in this directory. For more on
contributing, see the `contributor's guide. `_

Testing
-------

For testing, we use pytest for running the unit tests and open-test-data for
test files that are used for Py-ART's example gallery. To install pytest::

   $ conda install -c conda-forge pytest

To install open-radar-data::

   $ conda install -c conda-forge open-radar-data

After installation of pytest you can launch the test
suite from outside the source directory (you will need to have pytest
installed)::

   $ pytest --pyargs pyart

In-place installs can be tested using the `pytest` command from within
the source directory.

        

---

Owner metadata

• Name: ARM User Facility
• Login: ARM-DOE
• Email:
• Kind: organization
• Description:
• Website:
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/2540600?v=4
• Repositories: 16
• Last ynced at: 2024-03-26T19:49:16.170Z
• Profile URL: https://github.com/ARM-DOE

---

GitHub Events

Total

• Create event: 21
• Release event: 6
• Issues event: 24
• Watch event: 40
• Delete event: 14
• Issue comment event: 95
• Push event: 123
• Pull request review comment event: 15
• Pull request event: 90
• Pull request review event: 65
• Fork event: 11

Last Year

• Create event: 21
• Release event: 6
• Issues event: 24
• Watch event: 40
• Delete event: 14
• Issue comment event: 95
• Push event: 123
• Pull request review comment event: 15
• Pull request event: 90
• Pull request review event: 65
• Fork event: 11

---

Committers metadata

Last synced: 6 days ago

Name	Email	Commits
Jonathan J. Helmus	j****s@g****m	1062
Zachary Sherman	z****n@a****v	404
Max Grover	m****2@g****m	229
Scott Collis	s****f@g****m	214
Robert Jackson	r****n@a****v	45
Kirk North	k****h@g****m	45
Gama Anderson	g****2@g****m	36
Anderson Gama	a****a@s****r	35
dependabot[bot]	4****]	32
jhemedin	j****r@g****m	28
Nick Guy	n****r@g****m	27
Timothy Lang	t****g@n****v	19
lauratomkins	l****n@n****u	17
Jordi Figueras	f****j@z****h	15
Joseph C. Hardin	j****e@g****m	15
Cory C Weber	c****r@a****v	13
dcedgren	d****n@g****m	13
Kai Muehlbauer	k****r@u****e	13
Israel Silber	5****r	11
Valentin Louf	v****f@b****u	10
Joe O'Brien	o****j@a****v	10
Steve Nesbitt	s****t@i****u	9
Julia Signell	j****l@g****m	8
Quba1	j****d@g****m	6
Hamid Ali Syed	3****i	6
Daniel Wolfensberger	d****r@e****h	5
freemansw1	f****1@g****m	4
Marco Aurelio da Costa	c****a@g****m	4
Rish Shadra	w****0	4
Daniel Wolfensberger	d****r@m****h	4
and 54 more...

Committer domains:

• anl.gov: 6
• illinois.edu: 3
• noaa.gov: 2
• fmi.fi: 2
• ou.edu: 2
• or-condo-login01.ornl.gov: 2
• bom.gov.au: 2
• uni-bonn.de: 1
• zueub222.meteoswiss.ch: 1
• epfl.ch: 1
• gamic.com: 1
• meteoswiss.ch: 1
• purdue.edu: 1
• ncsu.edu: 1
• nasa.gov: 1
• simepar.br: 1
• or-condo-c215.ornl.gov: 1
• c356061l.evs.anl.gov: 1
• keeling.earth.illinois.edu: 1
• climate.com: 1
• anlvpn091.evs.anl.gov: 1
• anlvpn104.evs.anl.gov: 1
• ufl.edu: 1
• itsc.uah.edu: 1
• anlvpn121.evs.anl.gov: 1
• vpnpool-130-126-153-201.near.illinois.edu: 1
• ssec.wisc.edu: 1
• weatherwary.com: 1
• thielen.science: 1
• helsinki.fi: 1
• ucar.edu: 1
• cades-extlogin01.ornl.gov: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/arm-doe/pyart

---

---

---

Package metadata

• Total packages: 4
• Total downloads:
  • pypi: 196,835 last-month
• Total docker downloads: 1,117
• Total dependent packages: 13 (may contain duplicates)
• Total dependent repositories: 29 (may contain duplicates)
• Total versions: 102
• Total maintainers: 5

---

Dependencies

Score: 23.015471218636698