导航|地址|刷新
GitHub - ARM-DOE/pyart: The Python-ARM R…









Skip to content


Navigation Menu
Toggle navigation










Sign in
Appearance settings









Platform


AI CODE CREATION

GitHub CopilotWrite better code with AI



GitHub Copilot appDirect agents from issue to merge



MCP RegistryIntegrate external tools





DEVELOPER WORKFLOWS

ActionsAutomate any workflow



CodespacesInstant dev environments



IssuesPlan and track work



Code ReviewManage code changes



Code QualityEnforce quality at merge





APPLICATION SECURITY

GitHub Advanced SecurityFind and fix vulnerabilities



Code securitySecure your code as you build



Secret protectionStop leaks before they start





EXPLORE
Why GitHub

Documentation

Blog

Changelog

Marketplace



View all features





Solutions


BY COMPANY SIZE
Enterprises

Small and medium teams

Startups

Nonprofits




BY USE CASE
App Modernization

DevSecOps

DevOps

CI/CD

View all use cases




BY INDUSTRY
Healthcare

Financial services

Manufacturing

Government

View all industries



View all solutions





Resources


EXPLORE BY TOPIC
AI

Software Development

DevOps

Security

View all topics




EXPLORE BY TYPE
Customer stories

Events & webinars

Ebooks & reports

Business insights

GitHub Skills




SUPPORT & SERVICES
Documentation

Customer support

Community forum

Trust center

Partners



View all resources





Open Source


COMMUNITY

GitHub SponsorsFund open source developers





PROGRAMS
Security Lab

Maintainer Community

Accelerator

GitHub Stars

Archive Program




REPOSITORIES
Topics

Trending

Collections







Enterprise


ENTERPRISE SOLUTIONS

Enterprise platformAI-powered developer platform





AVAILABLE ADD-ONS

GitHub Advanced SecurityEnterprise-grade security features



Copilot for BusinessEnterprise-grade AI features



Premium SupportEnterprise-grade 24/7 support







Pricing





Search or jump to...



Search code, repositories, users, issues, pull requests...




Search








Clear








Search syntax tips














Provide feedback







We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted

Cancel Submit feedback




Saved searches

Use saved searches to filter your results more quickly












Name

Query

To see all available qualifiers, see our documentation.







Cancel Create saved search


Sign in
Sign up
Appearance settings


Resetting focus




You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert








{{ message }}











Uh oh!


There was an error while loading. Please reload this page.









ARM-DOE /pyartPublic



Notifications You must be signed in to change notification settings

Fork 286


Star 595






Code

Issues40

Pull requests5

Discussions

Actions

Projects

Wiki

Security and quality0

Insights

Additional navigation options



Code

Issues

Pull requests

Discussions

Actions

Projects

Wiki

Security and quality

Insights

































main





BranchesTags










Go to file

Code
Open more actions menu







Folders and files

Name	Name	Last commit message	Last commit date
Latest commit History 3,251 Commits 3,251 Commits
.github	.github
continuous_integration	continuous_integration
doc	doc
examples	examples
guides	guides
pyart	pyart
roadmaps	roadmaps
scripts	scripts
tests	tests
.coveragerc	.coveragerc
.gitattributes	.gitattributes
.gitignore	.gitignore
.mailmap	.mailmap
.pre-commit-config.yaml	.pre-commit-config.yaml
CODE_OF_CONDUCT.md	CODE_OF_CONDUCT.md
CONTRIBUTING.rst	CONTRIBUTING.rst
INSTALL.rst	INSTALL.rst
LICENSE.txt	LICENSE.txt
MANIFEST.in	MANIFEST.in
README.rst	README.rst
codecov.yml	codecov.yml
environment.yml	environment.yml
pyproject.toml	pyproject.toml
readthedocs.yaml	readthedocs.yaml
setup.py	setup.py
View all files

Repository files navigation



README

Code of conduct

Contributing

License



More items







The Python ARM Radar Toolkit (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.13 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.

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

xradar

xarray

mda-xdrlib

fsspec

s3fs

pandas

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) TRMM RSL is no longer supported by NASA and Py-ART. If using files such as DORADE, please consider using radx instead to convert the files to cfradial.

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.

Basemap. If installed, also gives the ability to plot grids on geographic maps, but Cartopy is recommended over Basemap. Basemap is deprecated in favour of cartopy.

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.

metpy. Required for plotting gridded cross sections.


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
…(内容过长已截断)

------
导航页 打开网址