Metadata-Version: 2.4
Name: amazon-utac
Version: 1.0.0
Summary: GenesisAeon Package 19: UTAC dynamical model of the Amazon rainforest savannisation tipping point. Bundles the diamond-setup project scaffold CLI.
Project-URL: Homepage, https://github.com/GenesisAeon/amazon-utac
Project-URL: Repository, https://github.com/GenesisAeon/amazon-utac
Project-URL: Documentation, https://genesisaeon.github.io/amazon-utac
Project-URL: Issues, https://github.com/GenesisAeon/amazon-utac/issues
Project-URL: Zenodo, https://doi.org/10.5281/zenodo.19645351
Author: GenesisAeon / MOR Research Collective
License: MIT
License-File: LICENSE
Keywords: amazon,cli,crep,project-generator,scaffold,skeleton,template,tipping-point,utac
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Requires-Dist: numpy>=1.26
Requires-Dist: pydantic>=2.7
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.7.0
Requires-Dist: scipy>=1.12
Requires-Dist: typer>=0.12.0
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'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
Provides-Extra: notebooks
Requires-Dist: ipykernel>=6.0; extra == 'notebooks'
Requires-Dist: jupyter>=1.0; extra == 'notebooks'
Requires-Dist: matplotlib>=3.8; extra == 'notebooks'
Description-Content-Type: text/markdown

# amazon-utac

> GenesisAeon Package 19 — Amazon Rainforest Savannisation as UTAC System

<p align="center">
  <a href="https://doi.org/10.5281/zenodo.19645351"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.19645351.svg" alt="DOI (GenesisAeon Whitepaper)"/></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"/></a>
  <a href="https://creativecommons.org/licenses/by/4.0/"><img src="https://img.shields.io/badge/docs-CC%20BY%204.0-lightblue.svg" alt="CC BY 4.0"/></a>
  <a href="https://github.com/GenesisAeon/genesis-os"><img src="https://img.shields.io/badge/part%20of-genesis--os-blueviolet" alt="Part of genesis-os"/></a>
  <img src="https://img.shields.io/badge/UTAC-package%2019-orange" alt="Package 19"/>
</p>

**Amazon rainforest → savanna transition modelled as reversed UTAC system.**

**Key result**: Γ_Amazon ≈ 0.116 (low-CREP, fragile regime).

## Installation

```bash
pip install amazon-utac
```

For development (running tests, linting):

```bash
pip install -e ".[dev]"
```

## Quickstart

```bash
amazon-utac run --scenario current-rate
amazon-utac threshold --deforestation-rate 0.01
```

## Integration in genesis-os

```python
from genesis_os import GenesisOS
os = GenesisOS()
amazon = os.load_package(19)
results = amazon.run_cycle(duration_years=80)
```

## Benchmark

Validated against Lovejoy & Nobre (2019) and Boulton et al. (2022).

## Falsifiable Prediction

With 1 % annual deforestation, tipping threshold crossed in 2038 ± 5 years.

## Role in the GenesisAeon Ecosystem

`amazon-utac` is **GenesisAeon Package 19 (P19)**, in the **ecology /
rainforest savannisation** domain. It applies the GenesisAeon UTAC
(Universal Threshold Activation Criticality) framework and CREP tensor to
model the Amazon forest–savanna tipping point, contributing the
cross-domain Γ_Amazon ≈ 0.116 data point to the ecosystem-wide CREP
Criticality Spectrum.

## Citation

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.PLACEHOLDER.svg)](https://doi.org/10.5281/zenodo.PLACEHOLDER)

DOI will be assigned automatically on first GitHub Release once
Zenodo–GitHub integration is enabled for this repo. Until then, please cite
the GenesisAeon whitepaper DOI above, or `CITATION.cff` in this repository.

## License

Code: MIT • Docs & Data: CC BY 4.0
