Metadata-Version: 2.4
Name: rozier-quantum
Version: 1.3.2
Summary: Structural diagnostic reader for multi-chip quantum computing systems
Author-email: Rozier Quantum LLC <contact@rozierquantum.com>
License: Proprietary
Project-URL: Homepage, https://rozierquantum.com
Project-URL: GitHub, https://github.com/catrozier08-gif
Keywords: quantum computing,qubit placement,quantum diagnostics,multi-chip quantum,quantum hardware,qiskit
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: qiskit>=1.0.0
Requires-Dist: networkx>=3.0
Requires-Dist: numpy>=1.24
Provides-Extra: server
Requires-Dist: fastapi>=0.110.0; extra == "server"
Requires-Dist: uvicorn>=0.29.0; extra == "server"
Requires-Dist: python-multipart>=0.0.9; extra == "server"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: httpx>=0.27; extra == "dev"

# Rozier Quantum SystemReader (v1.3.1)

### Structural Diagnostic Suite for Multi-Chip Quantum Scaling
**Author:** Rozier Quantum LLC  
**Website:** [rozierquantum.com](https://rozierquantum.com)  
**Security Status:** Verified No-Phone-Home / No-Network-Calls

---

## 🏗️ The Problem
As quantum hardware scales beyond 127 qubits (IBM Eagle) toward 4,000+ qubits (IBM Flamingo), the primary bottleneck shifts from individual qubit coherence to **Structural Communication Stress**. Multi-chip architectures introduce high-latency interconnects that can collapse success probability if the workload layout is not "site-calibrated" to the hardware's physical topology.

## 🛠️ The Solution: SystemReader
Rozier Quantum's `SystemReader` is an "OBD2 Scanner" for quantum workloads. It analyzes the structural alignment between a quantum circuit and the underlying hardware coupling map.

### Key Performance Benchmarks (v1.3.0/1.3.1)
*   **Scale:** Successfully verified 100,000-qubit workloads in < 6 seconds.
*   **Impact:** Demonstrated **83.58% communication stress reduction** on 127-qubit community-structured workloads.
*   **Reliability:** 6.08x increase in estimated success probability through structural refinement.

---

## 🚦 Diagnostic Codes (The OBD2 for Qubits)
SystemReader scans every qubit and link, assigning standard health codes:
*   **Q-001 (Overloaded):** Qubit interaction degree exceeds effective threshold for the circuit's density.
*   **Q-002 (Decoherence Risk):** High ratio of cross-chip interactions relative to local chip support.
*   **Q-003 (Isolation):** Active qubit with zero local support, spread across multiple remote chips.
*   **Q-004 (Bottleneck):** Qubit resides on a "Hot Corridor" link with projected routing congestion.

---

## 🛡️ Security & Integrity Statement
Rozier Quantum is built for secure, air-gapped laboratory environments. 
*   **Zero Network Calls:** The package does not import `requests`, `urllib`, or any networking libraries.
*   **Local Execution:** All analysis is performed entirely on the local machine.
*   **No Obfuscation:** The source code is clean, PEP8 compliant, and open for audit.

---

## 🚀 Quick Start
```python
from rozier import SystemReader, build_line_topology

# 1. Define your 4-chip hardware (34 qubits per chip)
topology = build_line_topology(num_chips=4, qubits_per_chip=34)

# 2. Initialize the Reader
reader = SystemReader(topology)

# 3. Run a Clinical Cycle on your circuit
results = reader.run_clinical_cycle(your_qiskit_circuit)
