# PSimon Framework: Metriplectic Quantum Dynamics

![Project Status](https://img.shields.io/badge/Status-Beta-blueviolet?style=for-the-badge)
![Physics](https://img.shields.io/badge/Physics-Metriplectic-ff69b4?style=for-the-badge)
![Quantum](https://img.shields.io/badge/Algorithm-Simon's-blue?style=for-the-badge)

## 🌌 Overview

The **PSimon Framework** (psimon_h7) is a high-precision computational suite designed to simulate quantum systems under the **Metriplectic** formalism. It bridges the gap between conservative Hamiltonian dynamics (Information) and dissipative Metric dynamics (Entropy), governed by the rigorous principles of **El Mandato Metriplético**.

**Concepto Central:** Truncamiento en el campo de Fock, dentro de un espacio de Hilbert, confinado en la esfera de Bloch.

The core engine utilizes **Simon's Algorithm** to discover hidden periodicities in state spaces modulated by the **Golden Operator ($O_n$)**.

## ⚖️ El Mandato Metriplético (Core Physics)

Every simulation in this framework obeys the fundamental laws:

1. **Symplectic Component**: Conservative movement generated by the Hamiltonian $H$.
2. **Metric Component**: Relaxation toward attractors governed by Dissipation Potential $S$.
3. **No Singularities**: Balanced dynamics—neither purely conservative nor purely dissipative.
4. **Golden Spacetime ($O_n$)**: Structured vacuum modulation using the Golden Ratio $\phi$.

## 🏗️ Project Structure

```text
.
├── core/               # PSimon Engine & Framework Management
├── physics/            # Metriplectic Oracles & Nuclear Systems
├── quantum/            # Simon's Algorithm & Quantum Logic
├── data/               # Computational results & JSON Convergence tables
├── tests/              # Pytest suite for rigorous validation
└── main.py             # Unified entry point
```

## 🚀 Getting Started

### Prerequisites

- Python 3.10+
- `numpy`, `scipy`, `pytest`

### Usage

Run the unified framework entry point:

```bash
python main.py
```

### Testing

Validate the physics and logic:

```bash
pytest tests/
```

---
*Developed under the framework of the **Analogy Rigor Manifesto** by Jacobo Tlacaelel Mina Rodriguez.*
