Metadata-Version: 2.4
Name: utac-core
Version: 1.0.0
Summary: The mathematical UTAC logistic core - sigma(beta(R-Theta)), beta-Fitting, Frame-Principle and v_RIG for the GenesisAeon stack.
Project-URL: Repository, https://github.com/GenesisAeon/utac-core
Project-URL: Issues, https://github.com/GenesisAeon/utac-core/issues
Author-email: GenesisAeon Team <team@genesisaeon.org>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
License-File: LICENSE-DOCS.md
Keywords: field-theory,frame-principle,logistic,mathematics,physics,utac
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.11
Requires-Dist: numpy>=2.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: sympy>=1.13.0
Requires-Dist: typer>=0.15.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.9; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.6; extra == 'docs'
Requires-Dist: mkdocs>=1.6; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.27; extra == 'docs'
Provides-Extra: stack
Requires-Dist: cosmic-moment>=1.0.0; extra == 'stack'
Requires-Dist: entropy-governance>=1.0.0; extra == 'stack'
Requires-Dist: entropy-table>=2.0.0; extra == 'stack'
Requires-Dist: field-theory>=0.1.0; extra == 'stack'
Requires-Dist: implosive-genesis>=1.0.0; extra == 'stack'
Requires-Dist: medium-modulation>=1.0.0; extra == 'stack'
Requires-Dist: sigillin>=1.0.0; extra == 'stack'
Description-Content-Type: text/markdown

# utac-core

**The mathematical UTAC logistic core** — σ(β(R−Θ)), β-Fitting, Frame-Principle (σ_Φ ≈ 0.0625) and v_RIG for unified field emergence.

[![CI](https://github.com/GenesisAeon/utac-core/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/utac-core/actions/workflows/ci.yml)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
[![License: GPL-3.0-or-later](https://img.shields.io/badge/Code-GPLv3--or--later-blue.svg)](LICENSE)
[![Docs License: CC BY 4.0](https://img.shields.io/badge/Docs-CC%20BY%204.0-lightgrey.svg)](LICENSE-DOCS.md)
[![PyPI](https://img.shields.io/pypi/v/utac-core)](https://pypi.org/project/utac-core/)

---

## Installation

```bash
pip install utac-core
# with full GenesisAeon stack integration:
pip install "utac-core[stack]"
```

## Quick start

```bash
utac fit --beta 0.0625
utac frame-principle
utac rig 10.0
utac logistic 1.618 --beta 0.0625 --theta 1.0
```

## Python API

```python
from utac_core import beta_fit, v_rig, frame_principle
from utac_core.core import utac_logistic, SIGMA_PHI

# Fit β from field data
beta = beta_fit([1.0, 1.618, 2.718], [0.618, 1.0, 1.618])

# Evaluate UTAC logistic σ(β(x − Θ))
sigma = utac_logistic(1.618, beta=SIGMA_PHI, theta=1.0)

# Recursive implosive growth
growth = v_rig(t=10.0)

# Symbolic Frame-Principle equation
print(frame_principle())   # sigma(beta*(R - Theta)) = 0.0625
```

## Mathematics

| Symbol | Meaning |
|--------|---------|
| σ(β(R−Θ)) | UTAC logistic function |
| σ_Φ ≈ 0.0625 | Frame-Principle constant (1/16) |
| β | Logistic steepness / fitting parameter |
| R | Field resonance value |
| Θ | Logistic threshold |
| v_RIG | Recursive implosive growth: β·ln(t+1)·σ_Φ |

## Structure

```
utac-core/
├── src/utac_core/
│   ├── __init__.py
│   ├── core.py                  # σ(β(R−Θ)), β-Fit, Frame-Principle, v_RIG
│   ├── cli.py                   # utac CLI (Typer + Rich)
│   └── entropy_table_bridge.py  # optional [stack] bridge
├── tests/
│   ├── test_core.py
│   └── test_cli.py
├── domains.yaml
└── pyproject.toml
```

## Citation

If you use utac-core in research, please cite it via its Zenodo DOI:

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

**DOI**: [10.5281/zenodo.19057365](https://doi.org/10.5281/zenodo.19057365)
**PyPI**: `pip install utac-core` (or `pip install "utac-core[stack]"` for the full GenesisAeon stack)

## Role in the GenesisAeon Ecosystem

utac-core (P-CORE) is the UTAC base engine of the GenesisAeon ecosystem,
providing the logistic ODE / CREP tensor core that downstream packages
(`sigillin`, `mandala-visualize`, `sonification`, `aeon-ai`, and others)
build on.

## License

Source code is licensed under [GPL-3.0-or-later](LICENSE). Documentation
is licensed under [CC BY 4.0](LICENSE-DOCS.md).

---

Built with [SymPy](https://www.sympy.org/) · [NumPy](https://numpy.org/) · [Typer](https://typer.tiangolo.com/) · [Rich](https://rich.readthedocs.io/)
