Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 76 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,76 @@
# ARM Repository Template
Basic repository template with required security workflows
# RadCLss

**Extracted Radar Columns and In-Situ Sensors**

`radclss` extracts vertical radar columns over user-specified site locations and merges them with co-located in-situ sensor data (sondes, met stations, disdrometers, pluviometers, etc.) into a single xarray dataset / netCDF file. It supports multiple radar systems (e.g. CSAPR2, KASACR, XSACR, NEXRAD) and parallel processing via Dask.

## Installation

From PyPI:

```bash
pip install radclss
```

From source:

```bash
git clone https://github.com/ARM-Development/radclss.git
cd radclss
pip install -e .
```

## Quick Start

```python
import radclss

volumes = {
"date": "20250520",
"radar_csapr2cmac": [...], # list of radar files
"sonde": [...],
"met_M1": [...],
# ... additional radar / in-situ inputs
}

input_site_dict = {
"M1": (34.34525, -87.33842, 293), # (lat, lon, alt_m)
"S4": (34.46451, -87.23598, 197),
}

columns = radclss.core.radclss(
volumes,
input_site_dict,
"radar_csapr2cmac",
serial=False,
verbose=True,
nexrad=True,
)

radclss.io.write_radclss_output(columns, "radclss_example.nc", "radclss.c2")

fig, ax = radclss.vis.create_radclss_columns("radclss_example.nc")
```

See `examples/bnf_example.py` for a full end-to-end script using the BNF (Bankhead National Forest) site, including Dask `LocalCluster` setup and multi-radar / multi-instrument inputs.

## Package Layout

- `radclss.core` — column extraction (`radclss.core.radclss`)
- `radclss.io` — netCDF output (`radclss.io.write_radclss_output`)
- `radclss.vis` — quicklook plots (`radclss.vis.create_radclss_columns`)
- `radclss.config` — default and output configuration
- `radclss.util` — column-processing utilities

## Development

Run tests and pre-commit hooks before committing:

```bash
pytest tests/
pre-commit run --all-files
```

## License

MIT — see `LICENSE`.
5 changes: 2 additions & 3 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,8 @@ dependencies = [
"dask",
]

[tool.setuptools]
package-dir = {"" = "src"}
packages = ["radclss"]
[tool.setuptools.packages.find]
where = ["src"]

[project.urls]
Homepage = "https://www.github.com/ARM-Development/radclss"
Loading