Skip to content

ARM-DOE/Adapt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

193 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Adapt is under active development

Components are continuously being redesigned, validated, stress-tested, and integrated for real-time adaptive radar operations.

Expect frequent breaking changes in APIs, configuration files, database schemas, NetCDF/Parquet outputs, workflows, and CLI behavior until the first stable release.


Adapt

CI Codecov CodeFactor Security Virus
Docs PyPI Release Downloads License ARM


Overview

Real-time processing for informed adaptive scanning of ARM weather radar operations and field campaigns.

Adapt is a configuration-driven modular framework for near real-time analysis of convective systems designed to support adaptive sampling and study of convective storms and their life cycles. The system implements a modular pipeline that ingests radar observations, performs gridding and segmentation to identify convective cells, and maintains their identity through time using tracking. It further derives cell-level properties and motion to characterize storm evolution and generate candidate targets for adaptive radar scanning.

Adapt operates in both real-time and archival modes, producing standardized data products in the form of gridded fields, tabular summaries, and relational tracking records. Its design emphasizes reproducibility, extensibility, and consistency, allowing new analysis methods and data sources to be integrated without altering core workflows.

Currently, it ingests NEXRAD Level-II data, performs gridding, segmentation, and analysis, and writes results for downstream visualization and scientific workflows.


Installation

Create a fresh conda environment (Python 3.13) and install from PyPI:

conda create -n adapt_env python=3.13 -y
conda activate adapt_env
python -m pip install --upgrade pip
pip install arm-adapt
adapt --help

Quickstart

adapt run-nexrad --radar KLOT --base-dir ~/adapt_output
adapt dashboard --repo ~/adapt_output

Open the dashboard in a second terminal for live viewing.


Documentation

Detailed usage, configuration, outputs, and troubleshooting: docs/USAGE.md


Status and Compatibility

  • Status: Alpha. Adapt is under active development and provided for early testing and evaluation.
  • No backward compatibility is guaranteed for code, APIs, configuration, or generated data products (e.g., SQLite, Parquet, NetCDF).
  • Expect breaking changes between commits and releases.

Funding

Adapt is supported by the U.S. Department of Energy as part of the Atmospheric Radiation Measurement (ARM) User Facility within the Office of Science.


License

Copyright © 2026, UChicago Argonne, LLC
See LICENSE for terms and disclaimer.

About

Adapt is a real-time weather radar data analysis framework for informed adaptive scanning of ARM radars.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages