Metadata-Version: 2.5
Name: urban-green-infrastructure-utac
Version: 1.0.1
Summary: Urban green infrastructure hydrology -- soil sealing and groundwater recharge (Grischek et al. 1996, replacing an unverifiable statistic caught during verification), green roof stormwater retention (Zheng et al. 2021, Gregoire & Clausen 2011) -- companion to landscape-restoration-hydrology-utac (P107), the urban physical setting, no UTAC/CREP bridge
Project-URL: Homepage, https://github.com/GenesisAeon/urban-green-infrastructure-utac
Project-URL: Repository, https://github.com/GenesisAeon/urban-green-infrastructure-utac
Author: Römer, Johann
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Description-Content-Type: text/markdown

# urban-green-infrastructure-utac

GenesisAeon Package 108 — urban green infrastructure hydrology.
Companion to [landscape-restoration-hydrology-utac](https://github.com/GenesisAeon/landscape-restoration-hydrology-utac)
(P107): the urban physical setting rather than the rural/riparian one.
**Deliberately has no UTAC/CREP/AFET bridge** — see
[DISCLAIMER.md](DISCLAIMER.md).

For a plain-language explanation of the same topic (German, no jargon,
written for general audiences), see [WHITEPAPER.md](WHITEPAPER.md).

## A caught statistic

The source dialogue for this package cited "Nature 2026: sealing "
reduces groundwater recharge 30-50%, r=-0.8971." Despite extensive
searching, **neither figure could be independently verified against
any real paper** — a suspiciously precise, four-decimal correlation
coefficient with no findable source is a classic fabrication/
misattribution signature. The underlying mechanism (sealing reduces
groundwater recharge) is real; this package uses a real, confirmed,
more modest figure instead (Grischek et al. 1996, Dresden: -23%). See
[DISCLAIMER.md](DISCLAIMER.md) for the full story.

## What's real here

- **Grischek et al. (1996)** — surface sealing reduced groundwater
  recharge by **23%** in Dresden, Germany. A real, confirmed, modest
  figure — used deliberately in place of the unverifiable "30-50%,
  r=-0.8971" claim above.
- **Zheng, Zou, Lounsbury, Wang & Wang (2021, *Resources, Conservation
  and Recycling*)** — a real global synthesis: 2,375 samples from 75
  studies across 21 countries (2005–2020), average **62%** per-event
  rainfall retention for green roofs (0–100% range, driven by rainfall
  intensity, substrate depth, coverage, climate, vegetation, season).
- **Gregoire & Clausen (2011)** — an earlier, independent meta-analysis
  of extensive green roofs specifically: 34–69% retention, average
  **56%** — converges closely with Zheng et al.'s later, larger
  synthesis. `independent_sources_agree_roughly()` returns `True`.

## Quickstart

```bash
pip install urban-green-infrastructure-utac
```

```python
from urban_green_infrastructure_utac import (
    dresden_recharge_reduction_pct,
    SEALING_CORRECTION_NOTE,
    GLOBAL_SYNTHESIS,
    EXTENSIVE_ROOF_META_ANALYSIS,
    independent_sources_agree_roughly,
)

print(dresden_recharge_reduction_pct())          # 23.0
print(SEALING_CORRECTION_NOTE)

print(GLOBAL_SYNTHESIS.avg_retention_pct)         # 62.0
print(EXTENSIVE_ROOF_META_ANALYSIS.avg_retention_pct)  # 56.0
print(independent_sources_agree_roughly())        # True
```

## Development

```bash
pip install -e ".[dev]"
pre-commit install
ruff check src tests
mypy src
pytest
```

## Citation

See [CITATION.cff](CITATION.cff) and [.zenodo.json](.zenodo.json).
