Metadata-Version: 2.4
Name: rozier-quantum
Version: 1.8.0
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.8.0
## The Honest Layout

*"I don't sell hourly labor. I sell the Vision that clears the fog."*
*— Chris Rozier, CEO | Rozier Quantum LLC*

---

## Who Built This

My name is Chris Rozier. I'm a carpenter and layout lead
from Fort Wayne, Indiana. I grew up bouncing between tents
and shelter homes. I have a wife and two kids.

I started using AI in January 2025 to answer physics
questions I'd been carrying for years. That led to a
patent-pending quantum computing architecture. That led
to this tool.

I have no computer science degree. I have no lab. I have
no team. No customers yet.

What I have is 20 years of reading physical space —
foundations, grades, radii, corridors — and the
realization that quantum systems have the same structural
problems that bad construction layout has. If the
foundation isn't square, the roof never sits right.
The same is true for qubit placement.

I built this tool to show that the insight is real.
The code works. You can run it right now.

---

## What This Tool Actually Is

SystemReader is a structural diagnostic tool for
multi-chip quantum computing systems.

It reads a quantum circuit and a hardware topology,
identifies structural mismatches between them, and
produces a clinical diagnostic report — qubit health
codes, corridor load maps, thermal risk zones, placement
recommendations.

Think of it as an OBD2 scanner for quantum hardware.
Plug it in before you commit to runtime. Read the codes.
Fix the layout first.

---

## What Has Been Verified — Honestly

**Verified in simulation:**
- 100,000 qubit structural scans complete in under 0.5
  seconds on standard hardware
- The diagnostic pipeline catches placement stress,
  cross-chip overload, thermal concentration, and idle
  waste in synthetic circuits
- The placement optimizer reduces communication cost
  measurably against the unoptimized baseline in every
  test run

**Derived from geometric and physical models:**
- The 22.48x efficiency figure comes from D4 lattice
  geometry — 24 kissing neighbors as the theoretical
  maximum coherence gain, with a real-world reduction
  applied. Analytical projection, not yet confirmed on
  live hardware.
- The 58.8% waste factor is based on coherence alignment
  theory — phase-aligned systems lose less energy to
  resistive scatter and heat. Needs experimental
  confirmation on live hardware.
- Energy and ROI projections in impact reports are
  extrapolations from these models applied to
  industry-scale estimates. They represent what the
  architecture is designed to achieve. No customer has
  confirmed them yet.

**Not yet verified:**
- Live quantum hardware benchmarks
- Customer deployments
- Independent third-party validation

I am one person. I have been coding for a matter of
weeks. I do not have a 50-person team. I am telling you
this because I believe the work is real enough to stand
on its own without pretending otherwise.

---

## What I Am Looking For

If you are a quantum researcher, hardware engineer, or
lab operator and you see something real here, I want to
hear from you.

I am not looking for a check. I am looking for someone
with hardware access who wants to find out if this holds
up in the real world. I believe it does. I cannot prove
it without the hardware.

The patent is pending. The architecture is documented.
The code is open for inspection under Apache 2.0.

If you want to run this against a real circuit on real
hardware and compare results, that is the conversation
I want to have.

---

## Install

```bash
pip install rozier-quantum
```

---

## Quick Start

```python
from qiskit import QuantumCircuit
from rozier import SystemReader, build_line_topology

# Build or load your circuit
qc = QuantumCircuit(20)
# ... add your gates ...

# Define your hardware topology
topology = build_line_topology(num_chips=4, qubits_per_chip=34)

# Read the structure
reader = SystemReader(topology, site_name="My Site")
print(reader.generate_report(qc))
```

---

## Run the Demo

```bash
python -m rozier.demo
python -m rozier.demo --qubits 1000 --depth 5000 --chips 8
python -m rozier.demo --vendor ibm --export
```

---

## The Creed

```python
from rozier import print_masters_layout
print_masters_layout()
```

---

## Diagnostic Codes

| Code | Name | What It Catches |
|------|------|-----------------|
| Q-001 | Overloaded | Qubit carrying too many interactions |
| Q-002 | Decoherence Risk | Too many cross-chip interactions |
| Q-003 | Entanglement Isolation | Active qubit with no local support |
| Q-004 | Bottleneck Exposure | Qubit on a hot corridor link |
| Q-005 | Idle | Qubit with no interactions |
| Q-006 | Grid Stress | Estimated electrical waste |
| Q-007 | Bridge Overload | Cross-chip communication stress |
| Q-008 | Thermal Risk | Load concentration at peak qubit |
| Q-020 | Coherence Shadow | Ghost power from structural misalignment |
| Q-022 | Lattice Ballast | Distributed jitter stabilization |

---

## Core Pipeline

```
SystemReader
  └── PerceptionEngine          reads circuit and topology structure
  └── DiagnosisEngine           projects stress, corridor load,
  |                             concurrency pressure
  └── QubitHealthScanner        assigns health codes per qubit
  └── PathMapper                maps interaction paths and corridors
  └── StablePlacementOptimizer  community-aware placement
  └── TradesmanTools            physical layout logic and grade math
```

---

## The Tradesman Module

The same spatial logic that holds a grade line within
1/8 inch over 50 feet applies to qubit placement density
across chip boundaries. The math is identical.

```python
from rozier import TradesmanTools

tools = TradesmanTools()

# Grade check on a radius arc
result = tools.radius_grade_check(
    start_elev=100.7,
    end_elev=100.0,
    total_arc_length=50,
    check_distance=25
)
# {'slope_per_ft': 0.014, 'target_elevation': 100.35,
#  'bust_detected': True}

# How many anchor points to hold the line
pins = tools.evaluate_pin_density(
    total_distance=50,
    total_drop=0.7
)
# {'pins_needed': 3, 'slope_per_ft': 0.014,
#  'tension_score': 0.029167, 'status': 'DIAMOND STABLE'}
```

---

## Vendor Profiles

IBM, Google, IonQ, Rigetti, and Rozier baselines included.
Terminology translates automatically per vendor.

```python
from rozier import get_vendor_profile
profile = get_vendor_profile("ibm")
```

---

## Topology Types

| Type | Description |
|------|-------------|
| line | Linear chain of chips |
| ring | Circular chain |
| star | Hub and spoke |
| fully_connected | All chips connected |
| mesh | Square grid |

Unknown topology types default to line with a clear
notification. No hard errors.

---

## Export Formats

```python
from rozier import export_json, export_markdown

report = reader.prescribe(circuit)
export_json(report, "report.json", vendor="ibm")
export_markdown(report, "report.md", vendor="ibm")
```

PDF export available via pandoc.

---

## Server Mode

```bash
pip install rozier-quantum[server]
uvicorn rozier.api_server:app --host 0.0.0.0 --port 8000
```

Endpoints: `GET /` `GET /vendors` `POST /analyze` `POST /preflight`

---

## Security

Zero network calls. Air-gap compatible. Apache 2.0.

---

## Contact

**Chris Rozier, CEO**
Rozier Quantum LLC — Fort Wayne, Indiana

chris.rozier@rozierquantum.com
rozierquantum.com
github.com/catrozier08-gif/rozier-quantum

Patent pending.

*"The Layout is always the answer."*
