Metadata-Version: 2.4
Name: neural-avalanche-utac
Version: 1.0.0
Summary: Brain Criticality & Neuronal Avalanche Threshold — GenesisAeon Package 20
Project-URL: Homepage, https://github.com/GenesisAeon/neural-avalanche-utac
Project-URL: Repository, https://github.com/GenesisAeon/neural-avalanche-utac
Project-URL: Zenodo, https://doi.org/10.5281/zenodo.19645351
Project-URL: Issues, https://github.com/GenesisAeon/neural-avalanche-utac/issues
Author-email: Johann Römer <j.roemer@mor-research.org>
License: MIT
License-File: LICENSE
Keywords: CREP tensor,GenesisAeon,UTAC,brain criticality,branching process,neuronal avalanches,neuroscience,self-organised criticality
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.10
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: numpy>=1.26.0
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: 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'
Description-Content-Type: text/markdown

# neural-avalanche-utac

> GenesisAeon Package 20 (P20) — Brain Criticality & Neuronal Avalanches 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://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>

**Neuronal avalanches at criticality modelled as UTAC system.**

**Key result**: Γ_brain ≈ 0.251 = Γ_AMOC → cross-domain universality at η = 50 %.

## Installation

```bash
pip install neural-avalanche-utac
```

For local development:

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

## Quickstart

```bash
neural-utac run --duration 3600
neural-utac criticality-check
neural-utac gamma-universality
```

## Integration in genesis-os

```python
from genesis_os import GenesisOS
os = GenesisOS()
neural = os.load_package(20)
results = neural.run_cycle(duration_seconds=3600)
```

## Benchmark

Validated against Hengen & Shew (2025).

## Falsifiable Prediction

Any homeostatic system with 50 % efficiency setpoint converges to Γ ≈ 0.251.

## Role in the GenesisAeon Ecosystem

`neural-avalanche-utac` is GenesisAeon Package **P20** (domain: neuroscience
/ cortical criticality). It models neuronal avalanches at criticality as a
UTAC dynamical system and contributes the Γ_brain ≈ 0.251 cross-domain
universality result to the broader GenesisAeon 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. In the meantime, see
`CITATION.cff` for the package citation and the GenesisAeon whitepaper DOI
badge above.

## License

MIT
