Metadata-Version: 2.5
Name: landscape-restoration-hydrology-utac
Version: 1.0.0
Summary: Landscape restoration hydrology -- the Murg/Rastatt floodplain reconnection case study, Umer et al. 2025's Kitwe NbS modeling, German drained-peatland emissions, and Pavlidis & Tsihrintzis 2018's agroforestry/hedgerow water-quality review -- extends glacier-buffer-utac's distributed-buffer series with real restoration-effectiveness evidence, no UTAC/CREP bridge
Project-URL: Homepage, https://github.com/GenesisAeon/landscape-restoration-hydrology-utac
Project-URL: Repository, https://github.com/GenesisAeon/landscape-restoration-hydrology-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

# landscape-restoration-hydrology-utac

GenesisAeon Package 107 — landscape restoration hydrology. Extends
[glacier-buffer-utac](https://github.com/GenesisAeon/glacier-buffer-utac)
(P99)/[distributed-buffer-resilience-utac](https://github.com/GenesisAeon/distributed-buffer-resilience-utac)
(P103)'s distributed-buffer idea with real, quantified evidence for
what specific restoration measures actually do. **Deliberately has no
UTAC/CREP/AFET bridge** — see [DISCLAIMER.md](DISCLAIMER.md).

## What this is, and what it deliberately excludes

Built on independently re-verified science only: a real, completed
German case study, a real hydraulic modeling study, real German
national emissions data, and a real large systematic review.

German funding-program mechanics, cost-per-meter/hectare tables, legal
frameworks (BauGB, Wasserhaushaltsgesetz), and communication strategy
from the source dialogue are **deliberately excluded** — real and
useful for advocacy/project-planning purposes, but not the kind of
durable, citable science this ecosystem's packages are built on. Same
precedent as [mountain-governance-adaptation-utac](https://github.com/GenesisAeon/mountain-governance-adaptation-utac)
(P104)'s governance-content scope decision.

## What's real here

- **Murg River floodplain reconnection, Rastatt** — a real, completed,
  officially documented German project: dike setback 500m (left bank) /
  100m (right bank), 57 ha of floodplain reclaimed, 1 million m³
  additional retention volume, and a measured **45cm reduction** in the
  100-year flood water level at Rastatt.
- **Umer, Debele, Mvula, Amarnath, Chisola & Marti-Cardona (2025)** —
  a real hydraulic modeling study (Kitwe, Zambia) separating retention
  ponds (flood depth ↓0.09–0.18m, velocity ↓0.11 m/s avg) from
  woodland reforestation (↓0.06–0.11m, ↓0.07 m/s avg) — kept as two
  distinct interventions, never merged.
- **UBA/Thünen Institute** — German agriculturally drained peat soils
  emit **~42.5 Mt CO₂-eq/year** (corrected from the source dialogue's
  slightly overstated 43.3 Mt figure).
- **Pavlidis & Tsihrintzis (2018, *Water Resources Management*)** — a
  real systematic review of >2,000 papers: agroforestry/hedgerow
  systems reduce N/P losses by 20–100% and pesticide losses by up to
  90%, with effects localized near the woody vegetation itself.

## Quickstart

```bash
pip install landscape-restoration-hydrology-utac
```

```python
from landscape_restoration_hydrology_utac import (
    MURG_RASTATT,
    RETENTION_PONDS,
    WOODLAND_REFORESTATION,
    german_drained_peatland_emissions_mt_co2e_per_yr,
    np_loss_reduction_pct_range,
    pesticide_loss_reduction_pct_max,
)

print(MURG_RASTATT.hq100_reduction_cm)                # 45.0
print(RETENTION_PONDS.flow_velocity_reduction_mps_avg) # 0.11
print(WOODLAND_REFORESTATION.flow_velocity_reduction_mps_avg)  # 0.07
print(german_drained_peatland_emissions_mt_co2e_per_yr())      # 42.5
print(np_loss_reduction_pct_range())                    # (20.0, 100.0)
print(pesticide_loss_reduction_pct_max())               # 90.0
```

## 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).
