Catalog PyPI
Back to packageRELEASE DETAILS

1.0.0

PyPI

advanced-weighting-systems

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

aeoncrepentropymandalamirror-machineneural-networksresonancesigillinweighting
Published28 Jun 2026
Direct dependencies21
Transitive dependenciesNot calculated

README

Version 1.0.0 documentation

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) $$

SymbolMeaning
$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 keyResonance Signal
TransformerAdaptertransmean(tanh(activations))
CNNAdaptercnnmax(abs(activations))
RNNAdapterrnnstd(activations)
GraphNNAdaptergraphmean(activations^2)
SpikeAdapterspikespike 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.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 21

Native requirements
21 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
numpy
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
numpy>=1.26.0runtime
pydantic
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pydantic>=2.5.0runtime
rich
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
rich>=13.0.0runtime
scipy
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
scipy>=1.11.0runtime
torch
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
torch>=2.1.0runtime
typer
Environment
{
  "extras": "all",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
typer[all]>=0.9.0runtime
mkdocs-autorefs
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mkdocs-autorefs>=0.5.0; extra == "dev"runtime
mkdocs-material
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mkdocs-material>=9.4.0; extra == "dev"runtime
mkdocs
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mkdocs>=1.5.3; extra == "dev"runtime
mkdocstrings
Environment
{
  "extras": "python",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mkdocstrings[python]>=0.24.0; extra == "dev"runtime
mypy
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mypy>=1.7.0; extra == "dev"runtime
pytest-cov
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pytest-cov>=4.1.0; extra == "dev"runtime
pytest-mock
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pytest-mock>=3.12.0; extra == "dev"runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pytest>=7.4.0; extra == "dev"runtime
ruff
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
ruff>=0.1.8; extra == "dev"runtime
cosmic-web
Environment
{
  "extras": "",
  "marker": "extra == \"stack\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
cosmic-web>=1.0.0; extra == "stack"runtime
entropy-governance
Environment
{
  "extras": "",
  "marker": "extra == \"stack\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
entropy-governance>=1.0.0; extra == "stack"runtime
mandala-visualizer
Environment
{
  "extras": "",
  "marker": "extra == \"stack\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mandala-visualizer>=1.0.0; extra == "stack"runtime
mirror-machine
Environment
{
  "extras": "",
  "marker": "extra == \"stack\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mirror-machine>=1.0.0; extra == "stack"runtime
sigillin
Environment
{
  "extras": "",
  "marker": "extra == \"stack\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
sigillin>=1.0.0; extra == "stack"runtime
utac-core
Environment
{
  "extras": "",
  "marker": "extra == \"stack\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
utac-core>=1.0.0; extra == "stack"runtime

Distribution files

2 collected
advanced_weighting_systems-1.0.0-py3-none-any.whl

bdist_wheel · 22.21 KB · Python py3

Source file
advanced_weighting_systems-1.0.0.tar.gz

sdist · 22,133.41 KB · Python source

Source file

Repository

PENDING
genesisaeon/advancedweightingsystems

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 19:59 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:2ca60e5cd3baa613fcd8fa520ed82f235e563493d4a2f0ac0fc082c27eb32d93

Other collected versions

View all collected versions →