Metadata-Version: 2.5
Name: vegetation-state-utac
Version: 1.0.1
Summary: Real vegetation drought-stress and mortality science (Choat 2012, Adams 2017, Gazol 2025) -- hydraulic-failure tipping parameter, no UTAC/CREP bridge
Project-URL: Homepage, https://github.com/GenesisAeon/vegetation-state-utac
Project-URL: Repository, https://github.com/GenesisAeon/vegetation-state-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

# vegetation-state-utac

[![GenesisAeon](https://img.shields.io/badge/GenesisAeon-P91-blue)](https://github.com/GenesisAeon)
[![CI](https://github.com/GenesisAeon/vegetation-state-utac/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/vegetation-state-utac/actions/workflows/ci.yml)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.21780594.svg)](https://doi.org/10.5281/zenodo.21780594)

GenesisAeon Package 91 — real vegetation drought-stress and hydraulic-failure
mortality science. **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).

## What's real here

- Choat et al. (2012, *Nature*): 70% of 226 tree species worldwide operate
  with narrow (<1 MPa) hydraulic safety margins against drought stress.
- Adams et al. (2017, *Nature Ecology & Evolution*): drought-induced tree
  mortality consistently associated with ≥60% loss of xylem hydraulic
  conductivity.
- Gazol et al. (2025, *Nature Communications*): 96% of 940 documented
  global tree-mortality events were preceded by extreme drought.
- Explicitly **not** framed as a single bistable tipping element — see
  [DISCLAIMER.md](DISCLAIMER.md).

## Quickstart

```bash
pip install vegetation-state-utac
```

```python
from vegetation_state_utac import stress_stage, StressStage

stage = stress_stage(conductivity_loss_fraction=0.65, lai_decline_fraction=0.5)
assert stage == StressStage.LIKELY_MORTALITY
```

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