arm-pyart

library2.2.2pypypiunverified

Py-ART is an open-source Python library designed for working with weather radar data. It provides tools for reading, processing, visualizing, and analyzing data from a variety of radar formats, including NEXRAD, UF, and ODIM_H5. Version 2.2.0, released recently, continues to build on its foundation with improvements in data handling and integration with other scientific libraries like xradar and cmweather. The project maintains an active release cadence with minor releases and bug fixes.

data ai-ml http-networking

pip install arm-pyart

github ↗package ↗

INSTALL

IMPORT

SIG · ARM-PYART

arm-pyart

datapythonv2.2.2

Install

26.3s avg

Import

—

Disk

637MB

Pass rate

4/ 10

Env Coverage4 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.2.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 28.78s

py 3.11

✕ build_error

✓ 26.45s

py 3.12

✕ build_error

✓ 24.58s

py 3.13

✕ build_error

✓ 25.53s

py 3.9

✕ timeout

637MB installed

● package 637MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Radar

✓ import pyart; radar = pyart.io.read('file.nc')

✗ from pyart.core import Radar

While `pyart.core.Radar` is the underlying class, `pyart.io.read` is the standard factory function for loading radar data into a Radar object from a file, which is the most common use case.

RadarDisplay

✓ import pyart; display = pyart.graph.RadarDisplay(radar)

✗ from pyart.graph.radardisplay import RadarDisplay

Prefer accessing `RadarDisplay` via the `pyart.graph` module (e.g., `pyart.graph.RadarDisplay`) for better readability and to follow typical Py-ART usage patterns.

read

✓ import pyart; radar = pyart.io.read('file.nc')

The primary function for loading various radar file formats into a Radar object.

This quickstart demonstrates how to create a dummy radar object and plot a basic Plan Position Indicator (PPI) reflectivity slice using Py-ART's `RadarDisplay`. This allows for immediate visualization without needing external data files.

import pyart import matplotlib.pyplot as plt # Create a dummy radar object for demonstration radar = pyart.testing.make_empty_ppi_radar(10, 10, 10) # Initialize a RadarDisplay object display = pyart.graph.RadarDisplay(radar) # Plot a PPI (Plan Position Indicator) slice of reflectivity fig = plt.figure(figsize=(8, 6)) ax = fig.add_subplot(111) display.plot('reflectivity', 0, title='Simulated Reflectivity (PPI)', ax=ax) plt.show()

Debug

Known issues

breakingPy-ART v2.0.0 introduced significant internal changes, primarily adopting `xradar` as the main backend for reading radar datasets and utilizing `cmweather` for colormaps. Code relying on direct internal reader implementations or Py-ART's older colormap handling may break.

fix

Review data loading routines, especially for new formats, and adapt to `xradar`'s approach. For colormaps, import from `cmweather` (e.g., `cmweather.colormaps`) or verify existing colormaps are still available and behave as expected.

affects: >=2.0.0

breakingAs of v1.19.3, Py-ART officially requires Python 3.10 or newer. Installations on older Python versions will fail or result in `ImportError`.

fix

Upgrade your Python environment to version 3.10 or newer. It is recommended to use `conda` or a virtual environment for managing Python versions.

affects: >=1.19.3

gotchaInstallation of geospatial dependencies like `cartopy` and `netCDF4` can be challenging, often requiring system-level libraries (e.g., GEOS, PROJ, HDF5). `pip` installations might fail without these prerequisites.

fix

For `cartopy` or `netCDF4` installation issues, consult their respective documentation for system-level dependencies. Using `conda` (`conda install -c conda-forge pyart`) is strongly recommended, as it often resolves complex binary dependency chains automatically.

affects: all

Upgrade

Version history

2.2.2latest on PyPI · released Jun 1, 2026

Audit

Dependencies

pythonrequiredRequires Python 3.10 or higher.

numpyrequiredFundamental for numerical operations.

scipyrequiredScientific computing routines.

matplotlibrequiredCore plotting functionality.

netCDF4requiredRequired for reading NetCDF-based radar formats.

xarrayrequiredPrimary data model for radar objects.

cartopyrequiredFor geographical plotting; often a complex install.

xradarrequiredUsed as the main backend for reading radar data since v2.0.0.

cmweatherrequiredProvides colormaps and plotting utilities since v2.0.0.

Agent activity

42 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/ARM-DOE/pyart ↗

packagehttps://pypi.org/project/arm-pyart/ ↗