Metadata-Version: 2.5
Name: climate-landuse-biodiversity-nexus-utac
Version: 1.0.0
Summary: Real biodiversity-driver ranking science, connecting amazon-utac/freshwater-ecosystem-stressors-utac/mixed-forest-resilience-utac/biodiversity-utac to the official IPBES driver framework -- no UTAC/CREP/AFET bridge
Project-URL: Homepage, https://github.com/GenesisAeon/climate-landuse-biodiversity-nexus-utac
Project-URL: Repository, https://github.com/GenesisAeon/climate-landuse-biodiversity-nexus-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

# climate-landuse-biodiversity-nexus-utac

GenesisAeon Package 126 — real biodiversity-driver ranking science,
connecting existing GenesisAeon packages to the official IPBES driver
framework. **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).

## Where this package came from

Surfaced via a six-document multi-AI gap-analysis of the GenesisAeon
climate/ecology portfolio (`KlimaAktuell/`, 2026-09-01), then
independently deep-dive verified before building — the last of a
five-package batch alongside `ocean-acidification-utac` (P122),
`tropical-glacier-ecosystem-rle-utac` (P123),
`marine-compound-stressors-utac` (P124), and
`assisted-gene-flow-utac` (P125). Deliberately a **relation package**:
it documents which existing GenesisAeon package —
[amazon-utac](https://github.com/GenesisAeon/amazon-utac) (P19),
[freshwater-ecosystem-stressors-utac](https://github.com/GenesisAeon/freshwater-ecosystem-stressors-utac)
(P106),
[mixed-forest-resilience-utac](https://github.com/GenesisAeon/mixed-forest-resilience-utac)
(P113), and
[biodiversity-utac](https://github.com/GenesisAeon/biodiversity-utac)
(P115) — is actually about which official IPBES direct biodiversity
driver, something none of those packages currently states explicitly.

## What's real here

- **IPBES Nexus Assessment** (approved 2024-12, Windhoek, Namibia, 165
  experts + 70 contributing authors) — the official list of five
  direct biodiversity drivers: land/sea-use change, direct
  exploitation, climate change, pollution, invasive alien species.
- **Jaureguiberry et al. (2022, *Science Advances*)** — a real,
  quantitative systematic synthesis: on land and in freshwater,
  land/sea-use change is the **dominant** driver, direct exploitation
  ranks second, pollution third — climate change and invasive species
  are **significantly less important** overall in these realms.

## Deliberately not one-sided

`is_land_use_dominant_in_every_realm()` returns `False` — in the
**ocean** realm, the ranking reverses: direct exploitation and climate
change dominate instead, a real, documented realm-specific reversal of
the land/freshwater ranking. There is no single global driver ranking
that applies everywhere.

## Quickstart

```bash
pip install climate-landuse-biodiversity-nexus-utac
```

```python
from climate_landuse_biodiversity_nexus_utac import (
    land_freshwater_driver_ranking,
    ocean_dominant_drivers,
    primary_driver_for_package,
    is_land_use_dominant_in_every_realm,
)

print(land_freshwater_driver_ranking())
# ('land/sea-use change', 'direct exploitation', 'pollution')
print(ocean_dominant_drivers())
# ('direct exploitation', 'climate change')
print(primary_driver_for_package("amazon-utac"))  # 'land/sea-use change'
print(is_land_use_dominant_in_every_realm())  # False
```

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