Metadata-Version: 2.4
Name: medium-modulation
Version: 1.0.0
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: GPL-3.0-or-later
License-File: LICENSE
License-File: LICENSE-CODE
License-File: LICENSE-DOCS
Requires-Python: >=3.11
Requires-Dist: entropy-governance>=1.0.0
Requires-Dist: entropy-table>=2.0.0
Requires-Dist: implosive-genesis>=1.0.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: mypy>=1.13; 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: GPL v3 (code) / CC BY 4.0 (docs)](https://img.shields.io/badge/License-GPLv3%20%2B%20CC%20BY%204.0-blue.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.

---

## Installation

```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 |

## Role in the GenesisAeon Ecosystem

`medium-modulation` (P-MEDIUM) is the resonant coupling layer of the
GenesisAeon framework: it sits between action-governed entropy production
(S∝A) and volume-governed informational expansion (S∝V), turning their
tension into coherent emergence via fractal modulation operators and
tunable interference fields.

## License

This repository is dual-licensed:

- **Source code** — GNU General Public License v3.0 or later (GPL-3.0-or-later). See [LICENSE-CODE](LICENSE-CODE).
- **Documentation** — Creative Commons Attribution 4.0 International (CC BY 4.0). See [LICENSE-DOCS](LICENSE-DOCS).

See [LICENSE](LICENSE) for details.

## Citation

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

DOI will be assigned automatically on first GitHub Release once
Zenodo–GitHub integration is enabled for this repo.

**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/)
