Metadata-Version: 2.4
Name: extreme-vs-mean-utac
Version: 1.0.0
Summary: Real extreme-event-vs-mean-statistics science (Patterson 2023, Ballester 2023) -- hottest days warming faster than means, no UTAC/CREP bridge
Project-URL: Homepage, https://github.com/GenesisAeon/extreme-vs-mean-utac
Project-URL: Repository, https://github.com/GenesisAeon/extreme-vs-mean-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

# extreme-vs-mean-utac

[![GenesisAeon](https://img.shields.io/badge/GenesisAeon-P94-blue)](https://github.com/GenesisAeon)
[![CI](https://github.com/GenesisAeon/extreme-vs-mean-utac/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/extreme-vs-mean-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)

GenesisAeon Package 94 — real extreme-event-vs-mean-statistics climate
science. **Deliberately has no UTAC/CREP/AFET bridge** — see
[DISCLAIMER.md](DISCLAIMER.md).

## What's real here

- Patterson (2023, *Geophysical Research Letters*): hottest days in
  North-West Europe warm roughly twice as fast (0.58°C/decade) as mean
  summer days (0.26°C/decade).
- Ballester et al. (2023, *Nature Medicine*): 61,672 estimated
  heat-related deaths in Europe, summer 2022 alone.
- Documents a real, quantified gap between mean-based and extreme-based
  climate risk assessment — see [DISCLAIMER.md](DISCLAIMER.md).

## Quickstart

```bash
pip install extreme-vs-mean-utac
```

```python
from extreme_vs_mean_utac import extreme_to_mean_warming_ratio

print(extreme_to_mean_warming_ratio())  # ~2.23
```

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