Skip to main content

Resonance-based, symbolically mirrored coupling of heterogeneous NN models in the AeonLayer for AeonAI (GenesisAeon project, CREP + Sigillin from unified-mandala)

Project description

DOI PyPI version Tests

advanced-weighting-systems

Resonance-based symbolic coupling of heterogeneous neural network models in the AeonLayer

Version 0.1.0 – GenesisAeon Project DOI: 10.5281/zenodo.19110330 Zenodo Record: https://zenodo.org/records/19110330

Resonance-based, symbolically mirrored coupling of heterogeneous neural network models (Transformer, CNN, RNN, GraphNN, Spiking) in the AeonLayer for AeonAI. Built on CREP + Sigillin from unified-mandala.


Mathematical Foundation

AeonLayer Aggregation

The central formula of the GenesisAeon stack:

$$ L_{\text{Aeon}} = \sum_i w_i \cdot M_i \cdot \sigma!\left(\beta(R_i - \Theta)\right) $$

Symbol Meaning
$w_i$ Dynamic resonance weight for model $i$ (from WeightingEngine)
$M_i$ Mirror-Matrix $M_i = P_i \Phi_{\text{sigil}} P_i^\top$ (from SymbolicMirror)
$R_i$ Raw resonance signal for model $i$ (adapter-specific)
$\Theta$ Global resonance threshold
$\beta$ Sharpness / inverse temperature
$\sigma$ Logistic sigmoid

WeightingEngine — Entropy-Governance

Area regime ($S \propto A$):

$$ w_i^{(A)} = \frac{\exp(-\lambda H_i)}{\sum_j \exp(-\lambda H_j)} $$

Volume regime ($S \propto V$, dimension $d$):

$$ w_i^{(V)} = \frac{\exp!\left(-\lambda H_i^{d/2}\right)}{\sum_j \exp!\left(-\lambda H_j^{d/2}\right)} $$

UTAC-Logistic Gate

$$ u_i = \sigma!\left(\kappa(C_i - \tau)\right) $$

CREP — Coherence-Resonance-Entropy Product

$$ \mathrm{CREP}i = \left(1 - \frac{H_i}{H{\max}}\right) \cdot \rho_i \cdot u_i $$

Sigillin Phase Matrix and Mirror-Matrix

$$ M_i = P_i , \Phi_{\text{sigil}} , P_i^\top, \qquad [\Phi_{\text{sigil}}]_{jk} \propto e^{-\frac{1}{2}|j-k|} $$

Resonance Energy

$$ E = | L_{\text{Aeon}} |_F $$


Installation

pip install advanced-weighting-systems

Full GenesisAeon Stack

pip install "advanced-weighting-systems[stack]"

Installs: mirror-machine, entropy-governance, sigillin, mandala-visualizer, utac-core, cosmic-web.

Development

git clone https://github.com/GenesisAeon/AdvancedWeightingSystems
cd AdvancedWeightingSystems
pip install -e ".[dev]"

Quick Start

import numpy as np
from advanced_weighting_systems.aeon_layer import AeonLayerConfig
from advanced_weighting_systems.symbolic_mirror import (
    TransformerAdapter, CNNAdapter, RNNAdapter, GraphNNAdapter
)
from advanced_weighting_systems.weighting_engine import WeightingConfig
from advanced_weighting_systems.models.coupling import ResonanceCoupling

DIM = 16

coupling = ResonanceCoupling(
    adapters=[
        TransformerAdapter(dim=DIM),
        CNNAdapter(dim=DIM),
        RNNAdapter(dim=DIM),
        GraphNNAdapter(dim=DIM),
    ],
    dim=DIM,
    aeon_config=AeonLayerConfig(beta=1.5, theta=0.0, n_models=4),
    weighting_config=WeightingConfig(lam=1.0),
)

rng = np.random.default_rng(0)
activations = [rng.standard_normal(DIM) for _ in range(4)]
entropies   = rng.uniform(0.1, 0.9, size=4)
coherences  = rng.uniform(0.3, 0.8, size=4)
rho         = rng.uniform(0.4, 1.0, size=4)

output = coupling.step(activations, entropies, coherences, rho)

print(f"L_Aeon shape          : {output.aeon_state.layer_output.shape}")
print(f"Resonance energy      : {output.energy:.6f}")
print(f"CREP scores           : {output.weighting_result.crep_scores}")

CLI

# Couple four adapter types with AeonLayer + mandala ASCII visualisation
aws couple --models trans,cnn,rnn,graph --aeon-layer --entropy 0.4 --visualize

# Compute resonance weights for named models with CREP bar chart
aws weight --model-ids model_a,model_b,model_c --regime volume --lam 2.0 --visualize

Architecture

advanced_weighting_systems/
├── aeon_layer.py        # L_Aeon aggregation (AeonLayer, AeonLayerConfig)
├── weighting_engine.py  # Entropy-governance, UTAC, CREP (WeightingEngine)
├── symbolic_mirror.py   # Sigillin + MandalaMap -> M_i (SymbolicMirror, adapters)
├── cli.py               # Typer CLI (aws couple / aws weight)
├── models/
│   ├── __init__.py      # Re-exports all adapters
│   └── coupling.py      # ResonanceCoupling end-to-end pipeline
└── utils/
    ├── __init__.py
    └── entropy.py       # Shannon entropy, EntropyTable, governance weights

Supported NN Adapters

Adapter --models key Resonance Signal
TransformerAdapter trans mean(tanh(activations))
CNNAdapter cnn max(abs(activations))
RNNAdapter rnn std(activations)
GraphNNAdapter graph mean(activations^2)
SpikeAdapter spike spike rate above threshold

Testing

pytest                          # run all tests with coverage
pytest --cov-report=html        # HTML coverage report

Coverage target: 99 %+ (enforced via --cov-fail-under=99).

Contract tests verify interface compatibility with:

  • mirror-machine — Mirror-Matrix shape and finite-value contracts
  • entropy-governance — monotonicity of weights w.r.t. entropy
  • utac-core — UTAC gate range and monotonicity w.r.t. coherence

Documentation

mkdocs serve          # local preview
mkdocs build --strict # production build (zero warnings)

Published at: https://genesisaeon.github.io/AdvancedWeightingSystems


Citation

@software{genesisaeon_aws_2026,
  author    = {GenesisAeon},
  title     = {Advanced Weighting Systems: Resonance-based Coupling of Heterogeneous NN Models},
  year      = {2026},
  version   = {0.1.0},
  doi       = {10.5281/zenodo.19110330},
  url       = {https://github.com/GenesisAeon/AdvancedWeightingSystems}
}

License

MIT — GenesisAeon Project, 2026.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

advanced_weighting_systems-0.1.0.tar.gz (22.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

advanced_weighting_systems-0.1.0-py3-none-any.whl (20.0 kB view details)

Uploaded Python 3

File details

Details for the file advanced_weighting_systems-0.1.0.tar.gz.

File metadata

  • Download URL: advanced_weighting_systems-0.1.0.tar.gz
  • Upload date:
  • Size: 22.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for advanced_weighting_systems-0.1.0.tar.gz
Algorithm Hash digest
SHA256 2455bbaa17b29b5c557e76c6e96597875813a201f226fd99ada7dfbf6ea725f2
MD5 f58d429daac32e95a701aa25f843130b
BLAKE2b-256 63d6356610c41cd81c9b71bd7eef0ebbb2ae78665242efcf0eb270fe7f4436e3

See more details on using hashes here.

File details

Details for the file advanced_weighting_systems-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: advanced_weighting_systems-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 20.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for advanced_weighting_systems-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ab8c54d645c468aac957842cd5cdc80774f36c831c555e2ef457466f0bbab92a
MD5 323c38c8022a2d2df17321d49eea138d
BLAKE2b-256 abd4a61cf0898d7e454b48694167d8190ad8873de6200007302c90759758d8cf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page