Metadata-Version: 2.4
Name: rozier-quantum
Version: 1.4.1
Summary: Structural diagnostic reader for multi-chip quantum computing systems
Author-email: Rozier Quantum LLC <contact@rozierquantum.com>
License-Expression: Apache-2.0
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.4.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 same friction exists in AI data centers, energy grids, 
and any hyperscale system where information travels across 
an unoptimized layout. **Spatial Routing Waste is the 
hidden tax on every advanced computing system.**

---

## 🛠️ The Solution: SystemReader
Rozier Quantum's `SystemReader` is an "OBD2 Scanner" for 
quantum workloads and hyperscale infrastructure. It analyzes 
the structural alignment between a workload and the 
underlying hardware topology — quantifying waste in both 
**routing stress units** and **estimated electrical 
consumption (kW).**

---

## 🆕 Version History

### [v1.4.1] The Grid Awareness Update
*   **Q-006 (Grid Stress):** New diagnostic code that 
    translates routing friction into estimated electrical 
    waste (kW). Bridges quantum diagnostics to real-world 
    energy and utility grid impact.
*   **22.48x ROI Benchmark:** Updated from verified 
    Industrial Refiner stress tests (previously 17.1x).
*   **Scan Duration Reporting:** Every Odometer scan 
    now self-reports its execution time.
*   **GitHub Community Integration:** Star call-to-action 
    built into every scan output.

### [v1.4.0] The Hyperscale & Location Update
*   **Site Log Integration:** Assign circuits to physical 
    job sites (e.g., `site_name="Data-Center-Alpha"`) 
    for long-term calibration tracking.
*   **Global Stress Odometer:** Real-time calculation of 
    topological routing stress.
*   **100k-Qubit Validation:** Benchmarked to process 
    100,000-qubit workloads in < 0.1 seconds (0.0004s verified).
*   **Projected ROI Mapping:** Identifies potential 
    efficiency gains of up to 22.48x.

---

## 🚦 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.
*   **Q-005 (Idle):** Qubit is allocated but receiving zero 
    interaction traffic. Dead weight on the layout.
*   **Q-006 (Grid Stress):** Excessive routing friction 
    generating measurable electrical waste. Reported in 
    estimated kW. Bridges quantum diagnostics to real-world 
    energy and utility grid impact.

---

## 🛡️ 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.
*   **Air-Gap Compatible:** Verified for secure laboratory 
    and industrial environments.

---

## 🚀 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 with Site Log (v1.4.0+)
reader = SystemReader(
    topology,
    site_name="Lab-Alpha",
    calibration_gen="Gen-1"
)

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

# 4. Run the Grid-Aware Odometer (v1.4.1)
# Returns stress, grid waste (kW), ROI, and scan duration
scan = reader.run_odometer_scan(your_qiskit_circuit)
'''

---

## Sample Odometer Output (v1.4.1)

    [ROZIER QUANTUM SITE LOG]
    SITE:        Lab-Alpha
    CALIBRATION: Gen-1
    TIMESTAMP:   2026-04-27 08:00:00
    ---------------------------------------------
    TOTAL QUBITS:           136
    TOTAL INTERACTIONS:     50
    TOTAL SITE STRESS:      1,125.00 units
    ESTIMATED GRID WASTE:   0.0031 kW (Q-006)
    ---------------------------------------------
    REFINEMENT POTENTIAL:   95.55%
    PROJECTED ROI:          22.48x Multiplier
    HYPERSCALE VALIDATED:   100,000 qubits in 0.0004s
    ---------------------------------------------
    [COMMUNITY]: Find this useful? Star us on GitHub:
    github.com/catrozier08-gif/rozier-quantum
    ---------------------------------------------
    For Grid Stability Review: chris.rozier@rozierquantum.com
    rozierquantum.com

---

## Roadmap
*   **The Reader**   - Live v1.4.1
*   **The Refiner**  - In Development
    (Hub-and-Spoke City Planning / Rideshare Batching /
    Thermal Balancing / Cross-Chip Bridge Bracing)
*   **The Monitor**  - Planned
    (Real-time Hardware Health Tracking)
*   **The Operator** - Vision
    (Autonomous Site Superintendent)

Advanced proprietary refinement architecture available
under NDA for qualified partners.

Contact: chris.rozier@rozierquantum.com
rozierquantum.com

---

## Benchmarks

| Metric                | Value              |
|-----------------------|--------------------|
| Stress Reduction      | 95.55%             |
| ROI Multiplier        | 22.48x             |
| 100k-Qubit Scan       | 0.0004s            |
| Grid Waste Detection  | Q-006 (kW)         |
| Hyperscale Validated  | 100,000 qubits     |
| Security              | Zero network calls |
| License               | Apache 2.0         |

---

## Contact and Consulting
Rozier Quantum provides structural diagnostic audits for:
*   Quantum hardware manufacturers
*   National laboratories
*   AI data center operators
*   Energy grid infrastructure teams

**Standard Structural Audit:** Available upon request.
**Refinement Engagement:** NDA required.
**Grid Stability Review:** chris.rozier@rozierquantum.com
**Website:** rozierquantum.com
