From e28282d5d38b11bdb61511c444f490cf248ba646 Mon Sep 17 00:00:00 2001
From: Robert Jackson <rjackson@anlvpn043.evs.anl.gov>
Date: Mon, 11 May 2026 11:30:23 -0500
Subject: [PATCH] ADD: Updated readme and fixed pyproject.toml

---
 README.md      | 78 ++++++++++++++++++++++++++++++++++++++++++++++++--
 pyproject.toml |  5 ++--
 2 files changed, 78 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index d8c8445..2153065 100644
--- a/README.md
+++ b/README.md
@@ -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`.
diff --git a/pyproject.toml b/pyproject.toml
index bbc16c1..0156c45 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -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"