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

Dual-licensed:

  • Code (src/, tests/, scripts, configuration) — GPL-3.0-or-later
  • Documentation (README, docs/, RELEASE_GUIDE.md, CONTRIBUTING.md, CHANGELOG.md, templates) — CC BY 4.0

See LICENSE for the full split. — 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-1.0.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-1.0.0-py3-none-any.whl (22.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: advanced_weighting_systems-1.0.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-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ebc800053681f01e05075c0f0fea62bbbc126ca07349716b4a2838b30cb813b3
MD5 20c2526c386525e2a7533f8ad570cc37
BLAKE2b-256 7770db83c1c39bb661779eb986ffb043ffcf8400b486e2d8f59ce5332f52dddb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: advanced_weighting_systems-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 22.7 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-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6d635db42cdad7a9b1017829985c6514e44f6eac1bd0c56e64982f1f563b0c6b
MD5 bd63dc1230dba5d8c09d37c77f154c05
BLAKE2b-256 686520b4dc6e5e6e7ac03023264333d2682e7fee0b1c7db96568ce3d07292ba1

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