Metadata-Version: 2.4
Name: medium-modulation
Version: 0.3.1
Summary: Resonant medium between SâˆA and SâˆV â€“ fractal modulation operators, resonance spectra and tunable interference for controlled information propagation.
Project-URL: Repository, https://github.com/GenesisAeon/medium-modulation
Project-URL: Issues, https://github.com/GenesisAeon/medium-modulation/issues
Author-email: GenesisAeon Team <team@genesisaeon.org>
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: entropy-governance>=0.1.0
Requires-Dist: entropy-table>=1.0.1
Requires-Dist: implosive-genesis>=0.4.0
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: 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.5.0; extra == 'docs'
Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
Description-Content-Type: text/markdown

# medium-modulation

**The resonant medium between action and expanse.**

[![CI](https://github.com/GenesisAeon/medium-modulation/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/medium-modulation/actions/workflows/ci.yml)
[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

medium-modulation serves as the dynamic coupling layer that modulates the fundamental duality of the GenesisAeon framework: action-governed entropy production (S ∝ A) versus volume-governed informational expansion (S ∝ V).

Through fractal modulation operators, resonance spectra, and tunable interference fields, it turns raw tension into coherent emergence.

---

## Install

```bash
pip install medium-modulation
```

## Usage

```bash
mm modulate --depth 0.7 --freq 2.3
mm spectrum
```

## API

```python
from medium_modulation.core import modulated_entropy, resonance_spectrum, coupling_factor
import numpy as np

# Fractal medium modulation
S_mod = modulated_entropy(S_A=1.0, S_V=1.618, depth=0.5, freq=1.0, t=0.0)

# Resonance spectrum over frequency range
freqs = np.linspace(0.1, 10, 50)
spec = resonance_spectrum(freqs, depth=0.5)

# Dynamic coupling strength
kappa = coupling_factor(A=1.0, V=1.618, modulation_depth=0.5)
```

## Architecture

```
medium-modulation/
├── src/medium_modulation/
│   ├── core.py                  # Modulation operator + fractal coupling
│   ├── cli.py                   # CLI mm
│   └── entropy_table_bridge.py  # entropy-table integration
├── tests/
│   ├── test_core.py
│   └── test_cli.py
└── domains.yaml                 # Domain configuration
```

## Integrations

| Package | Role |
|---------|------|
| `entropy-governance` | Duality factor α·S_A + (1-α)·S_V |
| `entropy-table` | Domain relation registry |
| `implosive-genesis` | Fractal emergence substrate |

**DOI** (after Zenodo release): 10.5281/zenodo.XXXXXXX
**PyPI**: https://pypi.org/project/medium-modulation/

---

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