Metadata-Version: 2.4
Name: mandala-visualizer
Version: 1.0.0
Summary: The visual mandala renderer for the GenesisAeon stack – Climate Dashboard, Cosmic-Web, Mermaid/Grafana integration and fraktal MandalaMap visuals.
Project-URL: Repository, https://github.com/GenesisAeon/mandala-visualizer
Project-URL: Issues, https://github.com/GenesisAeon/mandala-visualizer/issues
Author-email: GenesisAeon Team <team@genesisaeon.org>
License-Expression: GPL-3.0-or-later
License-File: LICENSE-CODE
Keywords: climate,cosmic-web,dashboard,fractal,mandala,visualization
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.11
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: networkx>=3.3
Requires-Dist: numpy>=1.26.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.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'
Requires-Dist: types-networkx>=3.3; extra == 'dev'
Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.6; extra == 'docs'
Requires-Dist: mkdocs>=1.6; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.27; extra == 'docs'
Provides-Extra: stack
Requires-Dist: cosmic-moment>=0.1.0; extra == 'stack'
Requires-Dist: entropy-governance>=0.1.0; extra == 'stack'
Requires-Dist: entropy-table>=2.0.0; extra == 'stack'
Requires-Dist: field-theory>=0.1.0; extra == 'stack'
Requires-Dist: implosive-genesis>=1.0.0; extra == 'stack'
Requires-Dist: medium-modulation>=0.1.0; extra == 'stack'
Requires-Dist: sigillin>=0.1.0; extra == 'stack'
Requires-Dist: utac-core>=0.1.0; extra == 'stack'
Description-Content-Type: text/markdown

# mandala-visualizer

**The visual mandala renderer** for the GenesisAeon stack – Climate Dashboard, Cosmic-Web, Mermaid/Grafana integration and fraktal MandalaMap visuals.

[![CI](https://github.com/GenesisAeon/mandala-visualizer/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/mandala-visualizer/actions/workflows/ci.yml)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
[![License: GPL v3+](https://img.shields.io/badge/Code%20License-GPLv3--or--later-blue.svg)](LICENSE-CODE)
[![Docs License: CC BY 4.0](https://img.shields.io/badge/Docs%20License-CC%20BY%204.0-lightgrey.svg)](LICENSE-DOCS)
[![PyPI](https://img.shields.io/pypi/v/mandala-visualizer)](https://pypi.org/project/mandala-visualizer/)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19076281.svg)](https://doi.org/10.5281/zenodo.19076281)

---

## Installation

```bash
pip install mandala-visualizer
# with full GenesisAeon stack integration:
pip install mandala-visualizer[stack]
```

## Usage

### CLI

```bash
# Render a Cosmic-Web mandala (saves cosmic-web.png)
mviz render --type cosmic-web

# Render an Entropy-Gate mandala
mviz render --type entropy-gate --output entropy-gate.png

# Render the Climate Entropy Dashboard
mviz dashboard

# Generate Mermaid graph for Grafana
mviz bridge
```

### Python API

```python
from mandala_visualizer import render_mandala, climate_dashboard, mermaid_grafana_bridge

# Render a fractal mandala
fig = render_mandala("cosmic-web")
fig.savefig("mandala.png", dpi=150)

# Climate Dashboard
fig = climate_dashboard()
fig.savefig("dashboard.png", dpi=150)

# Mermaid/Grafana bridge
print(mermaid_grafana_bridge({}))
```

## Project Structure

```
mandala-visualizer/
├── pyproject.toml
├── README.md
├── domains.yaml
├── src/
│   └── mandala_visualizer/
│       ├── __init__.py
│       ├── core.py                  # MandalaMap rendering, Climate Dashboard, Mermaid bridge
│       ├── cli.py                   # mviz CLI (Typer + Rich)
│       └── entropy_table_bridge.py  # Optional entropy-table integration
└── tests/
    ├── test_core.py
    └── test_cli.py
```

## Stack Integration

With `pip install mandala-visualizer[stack]`, mandala-visualizer integrates with the full GenesisAeon stack:

| Package | Role |
|---------|------|
| `utac-core` | β-Fitting and resonance calculations |
| `sigillin` | Sigil-based domain encoding |
| `field-theory` | Field equations for mandala geometry |
| `entropy-table` | Domain relation tracking |
| `cosmic-moment` | Temporal anchoring |

## Role in the GenesisAeon Ecosystem

`mandala-visualizer` is **P-MANDALA-VIZ** in the GenesisAeon ecosystem,
responsible for mandala layout & fractal rendering — turning CREP/UTAC
state from upstream packages (`utac-core`, `sigillin`, `entropy-table`,
`cosmic-moment`) into visual mandala maps and dashboards.

## License

This repository is **dual-licensed**:

- **Source code** (`src/`, `tests/`, and other code files) is licensed
  under the [GNU General Public License v3.0 or later](LICENSE-CODE)
  (GPL-3.0-or-later).
- **Documentation** (this README, `docs/`, `CHANGELOG.md`, and other
  prose/Markdown content) is licensed under
  [Creative Commons Attribution 4.0 International](LICENSE-DOCS)
  (CC BY 4.0).

See [LICENSE](LICENSE) for details.

## Citation

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

This package is archived on Zenodo. Please cite the DOI above when
referencing `mandala-visualizer` in academic work.

---

Built with [matplotlib](https://matplotlib.org/) · [NetworkX](https://networkx.org/) · [Typer](https://typer.tiangolo.com/) · [Rich](https://rich.readthedocs.io/)
