Metadata-Version: 2.4
Name: sandpile-utac
Version: 1.0.0
Summary: BTW/Manna sandpile SOC as UTAC continuous phase transition — GenesisAeon Package 22
Project-URL: Homepage, https://github.com/GenesisAeon/sandpile-utac
Project-URL: Repository, https://github.com/GenesisAeon/sandpile-utac
Project-URL: Documentation, https://genesisaeon.github.io/sandpile-utac
Project-URL: Issues, https://github.com/GenesisAeon/sandpile-utac/issues
Project-URL: Zenodo, https://doi.org/10.5281/zenodo.19645351
Author-email: Johann Römer <contact@mor-research.org>
License: MIT
License-File: LICENSE
Keywords: CREP,SOC,UTAC,criticality,genesis-aeon,phase-transition,sandpile
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
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 :: Physics
Requires-Python: >=3.10
Requires-Dist: numpy>=1.26.0
Requires-Dist: pydantic>=2.7
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.7.0
Requires-Dist: scipy>=1.12.0
Requires-Dist: typer>=0.12.0
Provides-Extra: dev
Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
Requires-Dist: mkdocs>=1.6.0; 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: plot
Requires-Dist: matplotlib>=3.8.0; extra == 'plot'
Description-Content-Type: text/markdown

# sandpile-utac

> GenesisAeon Package 22 — BTW & Manna Sandpile as Continuous Phase Transition

<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-GPLv3-blue.svg" alt="GPLv3 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%2020-orange" alt="Package 20"/>
</p>

**Bak–Tang–Wiesenfeld & Manna sandpiles as UTAC phase transitions.**

**Key result**: BTW Γ ≈ 0.296, Manna Γ ≈ 0.376 — anchors the CREP criticality spectrum.

## Installation

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

## Quickstart

```bash
sandpile-utac run --model btw --L 256
sandpile-utac phase-diagram
sandpile-utac crep-spectrum
```

## Integration in genesis-os

```python
from genesis_os import GenesisOS
os = GenesisOS()
sandpile = os.load_package(22)
results = sandpile.run_cycle(n_grains=10_000_000)
```

## Benchmark

Validated against Phys. Rev. E (2025).

## Falsifiable Prediction

Systems with η = 50 % converge to Γ ≈ 0.25 across all domains.

## Role in the GenesisAeon Ecosystem

`sandpile-utac` is GenesisAeon Package **P22**, in the **statistical
mechanics / self-organized criticality** domain. It validates the UTAC
(Universal Threshold Activation Criticality) methodology against the
canonical Bak–Tang–Wiesenfeld and Manna sandpile models — the
prototypical self-organized-criticality benchmark — anchoring the CREP
Criticality Spectrum at Γ ≈ 0.296 (BTW) and Γ ≈ 0.376 (Manna).

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

## License

Code: MIT • Docs & Data: CC BY 4.0
