Metadata-Version: 2.5
Name: neural-avalanche-utac
Version: 1.0.1
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.20807445
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.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.11
Requires-Dist: diamond-setup>=2.2.0
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, a rescaling of the η = 50% homeostatic
setpoint through the shared GenesisAeon σ=2.2 default. Its numeric match
to amoc-utac's Γ_AMOC is a verified construction artifact of that shared
constant (both packages use the identical formula and coincidentally
equal η), not an independent cross-domain physics finding — see
`constants.py`'s `GAMMA_BRAIN` docstring for the full derivation.

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

## On the "50% setpoint → Γ ≈ 0.251" claim

This is NOT a falsifiable prediction as stated: for ANY system with an
η = 50% efficiency/homeostatic setpoint, `arctanh(0.50)/σ` gives exactly
this value at σ=2.2 by pure algebra — the formula guarantees the match
regardless of the underlying domain's physics. A genuine test of
cross-domain universality would need σ independently derived per domain
against real dose-response data, which has not been done here or in any
other GenesisAeon UTAC package sharing this default. See
`constants.py`'s `GAMMA_BRAIN` docstring for the full reasoning.

## 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, giving Γ_brain ≈ 0.251 — a rescaling of the η=50%
homeostatic setpoint through the shared σ=2.2 default (see above for why
this is not independent cross-domain evidence).

## Citation

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

See `CITATION.cff` for the package citation and the GenesisAeon whitepaper
DOI badge above.

## License

MIT
