From 6325d385bc884767de987fdae0f5f335913032cb Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 26 Apr 2026 16:14:46 +0000 Subject: [PATCH 1/3] feat(quantum_alignment): Qiskit suite for phase / collapse / decoherence Adds quantum_alignment/ with a single-file Qiskit harness that runs three experiments (H-RZ-H interference sweep, mid-circuit measurement vs HH, deepening identity X-X chains) across three execution modes (ideal Aer, noisy Aer from a synthetic fake backend, and real IBM hardware via qiskit-ibm-runtime when IBM_QUANTUM_TOKEN is set). Outputs CSV, two matplotlib plots, and a plain-English report. README documents safe token handling and explicitly frames the suite as a test of quantum phase coherence/interference/noise -- not literal multiverse theory. --- quantum_alignment/README.md | 132 ++++ quantum_alignment/quantum_alignment_tests.py | 708 ++++++++++++++++++ quantum_alignment/requirements.txt | 9 + .../results/noise_depth_plot.png | Bin 0 -> 56915 bytes .../results/phase_alignment_plot.png | Bin 0 -> 87218 bytes quantum_alignment/results/report.md | 62 ++ quantum_alignment/results/results.csv | 17 + 7 files changed, 928 insertions(+) create mode 100644 quantum_alignment/README.md create mode 100644 quantum_alignment/quantum_alignment_tests.py create mode 100644 quantum_alignment/requirements.txt create mode 100644 quantum_alignment/results/noise_depth_plot.png create mode 100644 quantum_alignment/results/phase_alignment_plot.png create mode 100644 quantum_alignment/results/report.md create mode 100644 quantum_alignment/results/results.csv diff --git a/quantum_alignment/README.md b/quantum_alignment/README.md new file mode 100644 index 0000000..0304dc4 --- /dev/null +++ b/quantum_alignment/README.md @@ -0,0 +1,132 @@ +# Quantum Alignment Tests + +A small Qiskit suite that probes the *physical* meaning of "alignment" in +quantum computing — phase coherence, observation collapse, and decoherence — +across an ideal simulator, a noisy simulator, and (optionally) real IBM +Quantum hardware. + +> **Important framing.** "Multiverse alignment" is used here as a metaphor for +> *coherent quantum phase relationships and the interference patterns they +> produce*. This suite does **not** test, prove, or disprove literal parallel +> universes or the many-worlds interpretation. See [What this is **not**](#what-this-is-not). + +## What is being tested + +| # | Experiment | What it probes | +|---|---|---| +| 1 | Phase alignment / interference | `|0> → H → RZ(θ) → H → Measure`. Sweeps θ ∈ {0, π/8, π/4, π/2, 3π/4, π}. Ideal `p(0) = cos²(θ/2)`. | +| 2 | Observation collapse | Compares `H · H` (no mid-circuit measurement) against `H · Measure · H · Measure`. Mid-circuit measurement should destroy interference and push the final readout toward 50/50. | +| 3 | Decoherence vs. depth | `|0> → H → (X X)ⁿ → H → Measure` with n ∈ {0, 1, 2, 4, 8, 16, 32, 64}. Each `X X` is logical identity, so the ideal output is `p(0) = 1` for all n; any drift is gate noise + decoherence. | + +## Setup + +```bash +git clone +cd quantum_alignment + +python3 -m venv .venv +source .venv/bin/activate +pip install -r requirements.txt +``` + +`qiskit-ibm-runtime` is listed in `requirements.txt` for completeness, but the +ideal and noisy modes only need `qiskit`, `qiskit-aer`, `matplotlib`, and +`numpy`. The runtime package is imported lazily, only when you ask for +`--mode real`. + +## Running + +All three modes write the same artifacts to `./results/`: + +- `results.csv` — one row per (experiment, parameter) with raw probabilities and error +- `phase_alignment_plot.png` — Experiment 1 plot +- `noise_depth_plot.png` — Experiment 3 plot +- `report.md` — plain-English explanation of what the data shows + +### Ideal local simulator (no token required) + +```bash +python quantum_alignment_tests.py --mode ideal --shots 4096 +``` + +### Noisy simulator (no token required) + +Uses `qiskit_aer.AerSimulator.from_backend(GenericBackendV2(...))` so that a +realistic noise model is applied without contacting IBM: + +```bash +python quantum_alignment_tests.py --mode noisy --shots 4096 +``` + +### Real IBM Quantum hardware + +You need an IBM Quantum account and an API token. **Never hard-code the +token** and never commit it to git. The script reads it from the +`IBM_QUANTUM_TOKEN` environment variable. + +Recommended ways to set it safely: + +```bash +# Option A: prompt yourself, do not echo, do not store in shell history +read -s IBM_QUANTUM_TOKEN +export IBM_QUANTUM_TOKEN +python quantum_alignment_tests.py --mode real + +# Option B: a per-project .envrc loaded by direnv (add .envrc to .gitignore!) +echo 'export IBM_QUANTUM_TOKEN="$(security find-generic-password -s ibm-quantum -w)"' > .envrc +direnv allow + +# Option C: a system keyring / secret manager (1Password, macOS Keychain, etc.) +export IBM_QUANTUM_TOKEN="$(op read 'op://Personal/IBM Quantum/credential')" +python quantum_alignment_tests.py --mode real +``` + +To pin a specific backend (otherwise the script uses `least_busy`): + +```bash +python quantum_alignment_tests.py --mode real --backend ibm_brisbane +``` + +If your selected backend does not support mid-circuit measurement, pass +`--skip-observation` and run Experiment 2 separately on the simulator. The +script also gracefully records a "skipped" row in `results.csv` for any +mid-measure circuit it could not execute. + +## CLI reference + +``` +--mode {ideal,noisy,real} execution backend (default: ideal) +--backend NAME real-mode backend name (default: least_busy) +--shots N shots per circuit (default: 4096) +--seed N deterministic seed for noisy mode (default: 42) +--out PATH output directory (default: ./results) +--skip-observation skip Experiment 2 (for backends with no mid-circuit measure) +``` + +## What this is **not** + +- **Not a test of literal parallel universes.** Quantum mechanics is + interpretation-agnostic; no single-qubit experiment can settle the + many-worlds vs. Copenhagen vs. relational debate. +- **Not a hardware benchmark.** A handful of circuits at a few thousand shots + cannot replace published quantum-volume / EPLG / RB numbers. +- **Not a randomness or cryptographic source.** The bits returned here are + experimental data, not certified entropy. + +## What this **is** + +- A small, reproducible demo that quantum amplitudes have phase, that those + phases interfere, that observation destroys interference, and that real + hardware loses coherence as circuit depth grows. +- A scaffold you can extend with more circuits (entanglement, GHZ, Bell + inequality, randomized benchmarking, …) using the same backend / CSV / + report scaffolding. + +## Security notes + +- The token is **only** read from `IBM_QUANTUM_TOKEN` at runtime. The script + does not log it, does not write it to disk, and does not include it in any + output file or plot. +- `requirements.txt` pins minimum versions but does not freeze; in a + production setting you should `pip freeze > requirements.lock` and check the + lock file in. diff --git a/quantum_alignment/quantum_alignment_tests.py b/quantum_alignment/quantum_alignment_tests.py new file mode 100644 index 0000000..8061adb --- /dev/null +++ b/quantum_alignment/quantum_alignment_tests.py @@ -0,0 +1,708 @@ +"""Quantum alignment test suite. + +Runs three experiments that probe the *physical* meaning of "alignment" in a +quantum computer: + +1. Phase alignment / interference (single-qubit Mach-Zehnder via H-RZ-H) +2. Observation collapse (measurement in the middle of a circuit) +3. Decoherence / noise accumulation (deepening identity-equivalent X-X chains) + +This is *not* a test of literal parallel universes. "Multiverse alignment" is +treated here as a metaphor for coherent quantum phase relationships and the +interference patterns they produce. + +Three execution modes are supported: + + --mode ideal AerSimulator with no noise. + --mode noisy AerSimulator with a noise model derived from a synthetic + IBM-like fake backend (no IBM account or token required). + --mode real Real IBM Quantum hardware via qiskit-ibm-runtime. Requires + the IBM_QUANTUM_TOKEN environment variable. + +Outputs (under --out, default ./results): + + results.csv raw counts and probabilities for every shot batch + phase_alignment_plot.png p(0)/p(1)/error vs theta (Experiment 1) + noise_depth_plot.png p(0)/p(1)/error vs X-X depth (Experiment 3) + report.md plain-English summary of what the data shows +""" + +from __future__ import annotations + +import argparse +import csv +import math +import os +import sys +from dataclasses import dataclass, field +from typing import Callable, Iterable + +import matplotlib + +matplotlib.use("Agg") +import matplotlib.pyplot as plt +import numpy as np + +from qiskit import QuantumCircuit, transpile +from qiskit_aer import AerSimulator + + +# --------------------------------------------------------------------------- +# Backend selection +# --------------------------------------------------------------------------- + + +@dataclass +class Backend: + """Bundle of (label, sampler) used by the rest of the script.""" + + label: str + mode: str + run: Callable[[QuantumCircuit, int], dict[str, int]] + supports_mid_measure: bool = True + notes: list[str] = field(default_factory=list) + + +def make_ideal_backend() -> Backend: + sim = AerSimulator() + + def run(circuit: QuantumCircuit, shots: int) -> dict[str, int]: + tqc = transpile(circuit, sim) + result = sim.run(tqc, shots=shots).result() + return result.get_counts() + + return Backend(label="aer-ideal", mode="ideal", run=run) + + +def make_noisy_backend(seed: int = 42) -> Backend: + """Noisy AerSimulator built from a synthetic IBM-like fake backend. + + We use ``qiskit.providers.fake_provider.GenericBackendV2`` because it ships + with qiskit core and does not require ``qiskit-ibm-runtime`` (which would + in turn require the IBM cloud SDK). ``AerSimulator.from_backend`` extracts + a noise model from the fake backend's calibration data. + """ + + from qiskit.providers.fake_provider import GenericBackendV2 + + fake = GenericBackendV2(num_qubits=5, seed=seed) + sim = AerSimulator.from_backend(fake) + + def run(circuit: QuantumCircuit, shots: int) -> dict[str, int]: + tqc = transpile(circuit, sim, optimization_level=0, seed_transpiler=seed) + result = sim.run(tqc, shots=shots).result() + return result.get_counts() + + return Backend( + label=f"aer-noisy({fake.name})", + mode="noisy", + run=run, + notes=[ + "Noise model derived from synthetic fake backend " + f"{fake.name!r} (qiskit GenericBackendV2).", + ], + ) + + +def make_real_backend(token: str, backend_name: str | None) -> Backend: + """Real IBM Quantum backend via qiskit-ibm-runtime. + + ``token`` is *only* used to instantiate the service; it is never logged or + written to disk by this script. + """ + + # Lazy import: keeps simulator-only runs working even if qiskit-ibm-runtime + # (and its IBM cloud SDK dependency tree) is not importable. + from qiskit_ibm_runtime import QiskitRuntimeService, SamplerV2 + + service = QiskitRuntimeService(channel="ibm_quantum", token=token) + if backend_name: + backend = service.backend(backend_name) + else: + backend = service.least_busy(operational=True, simulator=False) + + sampler = SamplerV2(mode=backend) + + def run(circuit: QuantumCircuit, shots: int) -> dict[str, int]: + tqc = transpile(circuit, backend=backend, optimization_level=1) + job = sampler.run([tqc], shots=shots) + result = job.result() + # SamplerV2 result -> per-circuit PubResult; default classical register + # is named "meas" when QuantumCircuit.measure_all is used and "c" when + # we declared the register ourselves below. + pub = result[0] + data = pub.data + register_name = next(iter(data.__dict__)) if hasattr(data, "__dict__") else "c" + bit_array = getattr(data, register_name) + return bit_array.get_counts() + + return Backend( + label=f"ibm-real({backend.name})", + mode="real", + run=run, + # Most modern IBM backends support mid-circuit measurement, but + # individual devices vary. Caller can override via CLI if needed. + supports_mid_measure=True, + notes=[f"Running on IBM backend {backend.name!r}."], + ) + + +# --------------------------------------------------------------------------- +# Circuit builders +# --------------------------------------------------------------------------- + + +def phase_circuit(theta: float) -> QuantumCircuit: + """|0> -> H -> RZ(theta) -> H -> Measure.""" + qc = QuantumCircuit(1, 1, name=f"phase_{theta:.4f}") + qc.h(0) + qc.rz(theta, 0) + qc.h(0) + qc.measure(0, 0) + return qc + + +def observation_circuit_a() -> QuantumCircuit: + """A: |0> -> H -> H -> Measure (no mid-circuit observation).""" + qc = QuantumCircuit(1, 1, name="obs_A") + qc.h(0) + qc.h(0) + qc.measure(0, 0) + return qc + + +def observation_circuit_b() -> QuantumCircuit: + """B: |0> -> H -> Measure -> H -> Measure (mid-circuit collapse).""" + qc = QuantumCircuit(1, 2, name="obs_B") + qc.h(0) + qc.measure(0, 0) # collapse + qc.h(0) + qc.measure(0, 1) # final readout + return qc + + +def noise_depth_circuit(num_xx_pairs: int) -> QuantumCircuit: + """|0> -> H -> (X X) * n -> H -> Measure. + + Each X-X pair is the identity, so the *ideal* output is always |0>. Any + drift away from p(0)=1 on real or noisy hardware is gate noise + decoherence. + """ + qc = QuantumCircuit(1, 1, name=f"noise_{num_xx_pairs}") + qc.h(0) + for _ in range(num_xx_pairs): + qc.x(0) + qc.x(0) + qc.barrier() + qc.h(0) + qc.measure(0, 0) + return qc + + +# --------------------------------------------------------------------------- +# Counts analysis +# --------------------------------------------------------------------------- + + +def _last_bit_counts(counts: dict[str, int]) -> tuple[int, int]: + """Sum counts of the *final* classical bit (Qiskit prints little-endian). + + For circuit B (two classical bits) only the second measurement is the + "after re-prepared superposition" outcome -- that's the bit we care about. + """ + zeros = 0 + ones = 0 + for bitstring, count in counts.items(): + # strip any spaces inserted between registers + stripped = bitstring.replace(" ", "") + # leftmost char in qiskit's printed string is the highest-index bit; + # the *final* measurement of obs_B writes bit index 1, which is the + # leftmost char. For single-bit circuits both ends agree. + bit = stripped[0] + if bit == "0": + zeros += count + else: + ones += count + return zeros, ones + + +def _first_bit_counts(counts: dict[str, int]) -> tuple[int, int]: + zeros = 0 + ones = 0 + for bitstring, count in counts.items(): + stripped = bitstring.replace(" ", "") + bit = stripped[-1] + if bit == "0": + zeros += count + else: + ones += count + return zeros, ones + + +def probabilities(zeros: int, ones: int) -> tuple[float, float]: + total = zeros + ones + if total == 0: + return 0.0, 0.0 + return zeros / total, ones / total + + +# --------------------------------------------------------------------------- +# Experiments +# --------------------------------------------------------------------------- + + +THETAS: list[tuple[str, float]] = [ + ("0", 0.0), + ("pi/8", math.pi / 8), + ("pi/4", math.pi / 4), + ("pi/2", math.pi / 2), + ("3pi/4", 3 * math.pi / 4), + ("pi", math.pi), +] + +NOISE_DEPTHS: list[int] = [0, 1, 2, 4, 8, 16, 32, 64] + + +@dataclass +class Row: + experiment: str + backend_label: str + mode: str + label: str + parameter: float + shots: int + p0: float + p1: float + expected_p0: float + error: float + notes: str = "" + + +def run_phase_experiment(backend: Backend, shots: int) -> list[Row]: + rows: list[Row] = [] + for name, theta in THETAS: + # ideal probability of measuring 0 for H-RZ(theta)-H is cos(theta/2)^2 + expected_p0 = math.cos(theta / 2.0) ** 2 + counts = backend.run(phase_circuit(theta), shots) + zeros, ones = _first_bit_counts(counts) + p0, p1 = probabilities(zeros, ones) + rows.append( + Row( + experiment="phase_alignment", + backend_label=backend.label, + mode=backend.mode, + label=name, + parameter=theta, + shots=shots, + p0=p0, + p1=p1, + expected_p0=expected_p0, + error=abs(p0 - expected_p0), + ) + ) + return rows + + +def run_observation_experiment(backend: Backend, shots: int) -> list[Row]: + rows: list[Row] = [] + + counts_a = backend.run(observation_circuit_a(), shots) + zeros_a, ones_a = _first_bit_counts(counts_a) + p0_a, p1_a = probabilities(zeros_a, ones_a) + rows.append( + Row( + experiment="observation", + backend_label=backend.label, + mode=backend.mode, + label="A_no_mid_measure", + parameter=0, + shots=shots, + p0=p0_a, + p1=p1_a, + expected_p0=1.0, # H H = I + error=abs(p0_a - 1.0), + notes="H then H -> identity, expect p(0)=1", + ) + ) + + if not backend.supports_mid_measure: + rows.append( + Row( + experiment="observation", + backend_label=backend.label, + mode=backend.mode, + label="B_mid_measure", + parameter=0, + shots=shots, + p0=float("nan"), + p1=float("nan"), + expected_p0=0.5, + error=float("nan"), + notes=( + "Skipped: selected backend does not support mid-circuit " + "measurement. Run in --mode ideal or --mode noisy to see B." + ), + ) + ) + return rows + + counts_b = backend.run(observation_circuit_b(), shots) + zeros_b, ones_b = _last_bit_counts(counts_b) + p0_b, p1_b = probabilities(zeros_b, ones_b) + rows.append( + Row( + experiment="observation", + backend_label=backend.label, + mode=backend.mode, + label="B_mid_measure", + parameter=0, + shots=shots, + p0=p0_b, + p1=p1_b, + expected_p0=0.5, # collapse erases interference + error=abs(p0_b - 0.5), + notes="Mid-circuit measurement collapses the state; expect ~50/50", + ) + ) + return rows + + +def run_noise_depth_experiment(backend: Backend, shots: int) -> list[Row]: + rows: list[Row] = [] + for depth in NOISE_DEPTHS: + counts = backend.run(noise_depth_circuit(depth), shots) + zeros, ones = _first_bit_counts(counts) + p0, p1 = probabilities(zeros, ones) + # H (XX)^n H |0> = |0> ideally, regardless of n + rows.append( + Row( + experiment="noise_depth", + backend_label=backend.label, + mode=backend.mode, + label=f"xx_pairs={depth}", + parameter=depth, + shots=shots, + p0=p0, + p1=p1, + expected_p0=1.0, + error=abs(p0 - 1.0), + ) + ) + return rows + + +# --------------------------------------------------------------------------- +# Persistence + plots + report +# --------------------------------------------------------------------------- + + +CSV_FIELDS = [ + "experiment", + "backend_label", + "mode", + "label", + "parameter", + "shots", + "p0", + "p1", + "expected_p0", + "error", + "notes", +] + + +def write_csv(rows: Iterable[Row], path: str) -> None: + with open(path, "w", newline="") as f: + writer = csv.DictWriter(f, fieldnames=CSV_FIELDS) + writer.writeheader() + for row in rows: + writer.writerow({k: getattr(row, k) for k in CSV_FIELDS}) + + +def plot_phase(rows: list[Row], path: str, backend_label: str) -> None: + phase_rows = [r for r in rows if r.experiment == "phase_alignment"] + if not phase_rows: + return + thetas = [r.parameter for r in phase_rows] + p0 = [r.p0 for r in phase_rows] + p1 = [r.p1 for r in phase_rows] + err = [r.error for r in phase_rows] + expected = [r.expected_p0 for r in phase_rows] + + fig, ax = plt.subplots(figsize=(8, 5)) + ax.plot(thetas, p0, marker="o", label="p(0) measured") + ax.plot(thetas, p1, marker="o", label="p(1) measured") + ax.plot(thetas, expected, linestyle="--", label="p(0) ideal = cos^2(theta/2)") + ax.plot(thetas, err, marker="x", label="|p(0) - ideal|") + ax.set_xlabel("theta (radians)") + ax.set_ylabel("probability") + ax.set_title(f"Experiment 1: Phase alignment / interference ({backend_label})") + ax.set_xticks(thetas) + ax.set_xticklabels([r.label for r in phase_rows]) + ax.set_ylim(-0.05, 1.05) + ax.grid(True, alpha=0.3) + ax.legend(loc="center right") + fig.tight_layout() + fig.savefig(path, dpi=140) + plt.close(fig) + + +def plot_noise_depth(rows: list[Row], path: str, backend_label: str) -> None: + depth_rows = [r for r in rows if r.experiment == "noise_depth"] + if not depth_rows: + return + depths = [r.parameter for r in depth_rows] + p0 = [r.p0 for r in depth_rows] + p1 = [r.p1 for r in depth_rows] + err = [r.error for r in depth_rows] + + fig, ax = plt.subplots(figsize=(8, 5)) + ax.plot(depths, p0, marker="o", label="p(0) measured") + ax.plot(depths, p1, marker="o", label="p(1) measured") + ax.plot(depths, err, marker="x", label="error = 1 - p(0)") + ax.axhline(1.0, linestyle="--", alpha=0.5, label="ideal p(0)=1") + ax.set_xscale("symlog", linthresh=1) + ax.set_xlabel("number of X-X pairs (logical identity, real depth grows)") + ax.set_ylabel("probability") + ax.set_title(f"Experiment 3: Decoherence vs depth ({backend_label})") + ax.set_ylim(-0.05, 1.05) + ax.grid(True, alpha=0.3, which="both") + ax.legend(loc="center right") + fig.tight_layout() + fig.savefig(path, dpi=140) + plt.close(fig) + + +def write_report(rows: list[Row], path: str, backend: Backend, shots: int) -> None: + phase_rows = [r for r in rows if r.experiment == "phase_alignment"] + obs_rows = [r for r in rows if r.experiment == "observation"] + depth_rows = [r for r in rows if r.experiment == "noise_depth"] + + def fmt(p: float) -> str: + if p != p: # NaN + return "n/a" + return f"{p:.3f}" + + lines: list[str] = [] + lines.append("# Quantum Alignment Test Report") + lines.append("") + lines.append(f"- Backend: `{backend.label}`") + lines.append(f"- Mode: `{backend.mode}`") + lines.append(f"- Shots per circuit: {shots}") + if backend.notes: + lines.append("- Backend notes:") + for note in backend.notes: + lines.append(f" - {note}") + lines.append("") + lines.append("## What this report tests") + lines.append("") + lines.append( + "This suite probes three *physical* properties of quantum computation: " + "phase coherence and interference, the effect of measurement on a " + "superposition, and the accumulation of gate noise / decoherence as " + "circuit depth grows. \"Multiverse alignment\" is used here as a " + "metaphor for the coherent phase relationships that produce " + "interference -- it is **not** a literal claim about parallel " + "universes, and nothing here can prove or disprove the many-worlds " + "interpretation." + ) + lines.append("") + + # Experiment 1 + lines.append("## Experiment 1 -- Phase alignment / interference") + lines.append("") + lines.append( + "Circuit: `|0> - H - RZ(theta) - H - Measure`. The first H spreads " + "|0> into an equal superposition; RZ(theta) puts a relative phase " + "between the two branches; the second H lets those branches " + "interfere. The ideal outcome is `p(0) = cos^2(theta/2)`." + ) + lines.append("") + lines.append("| theta | p(0) measured | p(1) measured | p(0) ideal | |error| |") + lines.append("|---|---|---|---|---|") + for r in phase_rows: + lines.append( + f"| {r.label} | {fmt(r.p0)} | {fmt(r.p1)} | " + f"{fmt(r.expected_p0)} | {fmt(r.error)} |" + ) + lines.append("") + if phase_rows: + max_err = max(r.error for r in phase_rows) + lines.append( + f"Maximum deviation from the ideal interference pattern: " + f"**{max_err:.3f}**. " + f"On the ideal simulator this should be at the level of shot noise " + f"(~1/sqrt(shots) ~= {1.0 / math.sqrt(shots):.3f}). On a noisy or " + f"real backend it grows because gate errors and readout errors " + f"smear the interference fringes." + ) + lines.append("") + + # Experiment 2 + lines.append("## Experiment 2 -- Observation collapse") + lines.append("") + lines.append( + "Two circuits are compared. **A** applies H then H with no measurement " + "in between: H is its own inverse, so the qubit returns to |0> and we " + "expect `p(0) = 1`. **B** measures *between* the two H gates. That " + "mid-circuit measurement collapses the superposition to a definite " + "|0> or |1>; the second H then turns whichever basis state we have " + "into a fresh equal superposition, so the final readout is ~50/50. " + "If A is near 1.0 and B is near 0.5, observation has demonstrably " + "destroyed interference." + ) + lines.append("") + lines.append("| variant | p(0) | p(1) | expected p(0) | |error| | notes |") + lines.append("|---|---|---|---|---|---|") + for r in obs_rows: + lines.append( + f"| {r.label} | {fmt(r.p0)} | {fmt(r.p1)} | " + f"{fmt(r.expected_p0)} | {fmt(r.error)} | {r.notes} |" + ) + lines.append("") + + # Experiment 3 + lines.append("## Experiment 3 -- Decoherence / noise accumulation") + lines.append("") + lines.append( + "Circuit: `|0> - H - (X X)^n - H - Measure`. Each `X X` pair is the " + "identity, so the ideal outcome is always `p(0) = 1` regardless of n. " + "Any drift toward `p(0) = 0.5` as n grows is *purely* gate noise and " + "decoherence (T1/T2 relaxation, control errors, readout errors). On " + "the ideal simulator the line should stay flat at 1.0; on a noisy or " + "real backend it will sag toward 0.5." + ) + lines.append("") + lines.append("| X-X pairs | p(0) | p(1) | error = 1-p(0) |") + lines.append("|---|---|---|---|") + for r in depth_rows: + lines.append( + f"| {int(r.parameter)} | {fmt(r.p0)} | " + f"{fmt(r.p1)} | {fmt(r.error)} |" + ) + lines.append("") + if depth_rows: + deepest = depth_rows[-1] + lines.append( + f"At depth {int(deepest.parameter)} X-X pairs, p(0) is " + f"**{fmt(deepest.p0)}** vs the ideal **1.0** " + f"(error **{fmt(deepest.error)}**). " + "The further this number is from 1.0, the more decoherence the " + "device has accumulated over the run." + ) + lines.append("") + + # Scope / disclaimer + lines.append("## What this is NOT") + lines.append("") + lines.append( + "- Not a test of literal parallel universes or the many-worlds " + "interpretation. Quantum mechanics is interpretation-agnostic and " + "no single-qubit experiment can settle that debate." + ) + lines.append( + "- Not a benchmark of any specific IBM device. We use a tiny number " + "of circuits at modest shot counts; published quantum-volume / EPLG " + "numbers are far more rigorous." + ) + lines.append( + "- Not a security or randomness test. Do not use these counts as a " + "source of cryptographic entropy." + ) + lines.append("") + lines.append("## What this IS") + lines.append("") + lines.append( + "- A reproducible demonstration that quantum amplitudes have phase, " + "that phases interfere, that observation destroys interference, and " + "that real hardware loses coherence as depth grows." + ) + lines.append("") + + with open(path, "w") as f: + f.write("\n".join(lines)) + + +# --------------------------------------------------------------------------- +# Entry point +# --------------------------------------------------------------------------- + + +def select_backend(args: argparse.Namespace) -> Backend: + if args.mode == "ideal": + return make_ideal_backend() + if args.mode == "noisy": + return make_noisy_backend(seed=args.seed) + if args.mode == "real": + token = os.environ.get("IBM_QUANTUM_TOKEN") + if not token: + raise SystemExit( + "IBM_QUANTUM_TOKEN is not set. Export it (without quoting it " + "into shell history -- prefer `read -s` or a secret manager) " + "before running with --mode real, or pick --mode ideal/noisy." + ) + return make_real_backend(token=token, backend_name=args.backend) + raise SystemExit(f"Unknown mode: {args.mode!r}") + + +def parse_args(argv: list[str]) -> argparse.Namespace: + p = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + p.add_argument("--mode", choices=["ideal", "noisy", "real"], default="ideal") + p.add_argument( + "--backend", + default=None, + help="(real mode only) IBM backend name. Defaults to least_busy.", + ) + p.add_argument("--shots", type=int, default=4096) + p.add_argument("--seed", type=int, default=42) + p.add_argument( + "--out", + default=os.path.join(os.path.dirname(os.path.abspath(__file__)), "results"), + help="Output directory for CSV, plots, and report.", + ) + p.add_argument( + "--skip-observation", + action="store_true", + help="Skip Experiment 2 entirely (e.g., on a backend with no mid-circuit measurement support).", + ) + return p.parse_args(argv) + + +def main(argv: list[str] | None = None) -> int: + args = parse_args(argv if argv is not None else sys.argv[1:]) + os.makedirs(args.out, exist_ok=True) + + backend = select_backend(args) + np.random.seed(args.seed) + + print(f"[quantum_alignment] backend={backend.label} shots={args.shots}") + + rows: list[Row] = [] + print("[quantum_alignment] running Experiment 1: phase alignment...") + rows.extend(run_phase_experiment(backend, args.shots)) + if args.skip_observation: + print("[quantum_alignment] skipping Experiment 2 (per --skip-observation)") + else: + print("[quantum_alignment] running Experiment 2: observation collapse...") + rows.extend(run_observation_experiment(backend, args.shots)) + print("[quantum_alignment] running Experiment 3: noise vs depth...") + rows.extend(run_noise_depth_experiment(backend, args.shots)) + + csv_path = os.path.join(args.out, "results.csv") + phase_plot = os.path.join(args.out, "phase_alignment_plot.png") + noise_plot = os.path.join(args.out, "noise_depth_plot.png") + report_path = os.path.join(args.out, "report.md") + + write_csv(rows, csv_path) + plot_phase(rows, phase_plot, backend.label) + plot_noise_depth(rows, noise_plot, backend.label) + write_report(rows, report_path, backend, args.shots) + + print(f"[quantum_alignment] wrote {csv_path}") + print(f"[quantum_alignment] wrote {phase_plot}") + print(f"[quantum_alignment] wrote {noise_plot}") + print(f"[quantum_alignment] wrote {report_path}") + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/quantum_alignment/requirements.txt b/quantum_alignment/requirements.txt new file mode 100644 index 0000000..c05aaf1 --- /dev/null +++ b/quantum_alignment/requirements.txt @@ -0,0 +1,9 @@ +# Core +qiskit>=1.0 +qiskit-aer>=0.13 +matplotlib>=3.7 +numpy>=1.24 + +# Only needed for --mode real (real IBM hardware execution). +# Pulled in lazily; ideal/noisy modes work without it. +qiskit-ibm-runtime>=0.20 diff --git a/quantum_alignment/results/noise_depth_plot.png b/quantum_alignment/results/noise_depth_plot.png new file mode 100644 index 0000000000000000000000000000000000000000..8a7fe0416c6172099951c1039bbd51e40906cb21 GIT binary patch literal 56915 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 Gdi)RL*Z0=| literal 0 HcmV?d00001 diff --git a/quantum_alignment/results/phase_alignment_plot.png b/quantum_alignment/results/phase_alignment_plot.png new file mode 100644 index 0000000000000000000000000000000000000000..93a6c6b20c06f94aa4dcd1766914b0915369ebe0 GIT binary patch literal 87218 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 literal 0 HcmV?d00001 diff --git a/quantum_alignment/results/report.md b/quantum_alignment/results/report.md new file mode 100644 index 0000000..a571f9e --- /dev/null +++ b/quantum_alignment/results/report.md @@ -0,0 +1,62 @@ +# Quantum Alignment Test Report + +- Backend: `aer-noisy(generic_backend_5q)` +- Mode: `noisy` +- Shots per circuit: 4096 +- Backend notes: + - Noise model derived from synthetic fake backend 'generic_backend_5q' (qiskit GenericBackendV2). + +## What this report tests + +This suite probes three *physical* properties of quantum computation: phase coherence and interference, the effect of measurement on a superposition, and the accumulation of gate noise / decoherence as circuit depth grows. "Multiverse alignment" is used here as a metaphor for the coherent phase relationships that produce interference -- it is **not** a literal claim about parallel universes, and nothing here can prove or disprove the many-worlds interpretation. + +## Experiment 1 -- Phase alignment / interference + +Circuit: `|0> - H - RZ(theta) - H - Measure`. The first H spreads |0> into an equal superposition; RZ(theta) puts a relative phase between the two branches; the second H lets those branches interfere. The ideal outcome is `p(0) = cos^2(theta/2)`. + +| theta | p(0) measured | p(1) measured | p(0) ideal | |error| | +|---|---|---|---|---| +| 0 | 0.997 | 0.003 | 1.000 | 0.003 | +| pi/8 | 0.957 | 0.043 | 0.962 | 0.005 | +| pi/4 | 0.859 | 0.141 | 0.854 | 0.006 | +| pi/2 | 0.499 | 0.501 | 0.500 | 0.001 | +| 3pi/4 | 0.151 | 0.849 | 0.146 | 0.005 | +| pi | 0.004 | 0.996 | 0.000 | 0.004 | + +Maximum deviation from the ideal interference pattern: **0.006**. On the ideal simulator this should be at the level of shot noise (~1/sqrt(shots) ~= 0.016). On a noisy or real backend it grows because gate errors and readout errors smear the interference fringes. + +## Experiment 2 -- Observation collapse + +Two circuits are compared. **A** applies H then H with no measurement in between: H is its own inverse, so the qubit returns to |0> and we expect `p(0) = 1`. **B** measures *between* the two H gates. That mid-circuit measurement collapses the superposition to a definite |0> or |1>; the second H then turns whichever basis state we have into a fresh equal superposition, so the final readout is ~50/50. If A is near 1.0 and B is near 0.5, observation has demonstrably destroyed interference. + +| variant | p(0) | p(1) | expected p(0) | |error| | notes | +|---|---|---|---|---|---| +| A_no_mid_measure | 0.995 | 0.005 | 1.000 | 0.005 | H then H -> identity, expect p(0)=1 | +| B_mid_measure | 0.500 | 0.500 | 0.500 | 0.000 | Mid-circuit measurement collapses the state; expect ~50/50 | + +## Experiment 3 -- Decoherence / noise accumulation + +Circuit: `|0> - H - (X X)^n - H - Measure`. Each `X X` pair is the identity, so the ideal outcome is always `p(0) = 1` regardless of n. Any drift toward `p(0) = 0.5` as n grows is *purely* gate noise and decoherence (T1/T2 relaxation, control errors, readout errors). On the ideal simulator the line should stay flat at 1.0; on a noisy or real backend it will sag toward 0.5. + +| X-X pairs | p(0) | p(1) | error = 1-p(0) | +|---|---|---|---| +| 0 | 0.997 | 0.003 | 0.003 | +| 1 | 0.996 | 0.004 | 0.004 | +| 2 | 0.996 | 0.004 | 0.004 | +| 4 | 0.993 | 0.007 | 0.007 | +| 8 | 0.995 | 0.005 | 0.005 | +| 16 | 0.990 | 0.010 | 0.010 | +| 32 | 0.988 | 0.012 | 0.012 | +| 64 | 0.980 | 0.020 | 0.020 | + +At depth 64 X-X pairs, p(0) is **0.980** vs the ideal **1.0** (error **0.020**). The further this number is from 1.0, the more decoherence the device has accumulated over the run. + +## What this is NOT + +- Not a test of literal parallel universes or the many-worlds interpretation. Quantum mechanics is interpretation-agnostic and no single-qubit experiment can settle that debate. +- Not a benchmark of any specific IBM device. We use a tiny number of circuits at modest shot counts; published quantum-volume / EPLG numbers are far more rigorous. +- Not a security or randomness test. Do not use these counts as a source of cryptographic entropy. + +## What this IS + +- A reproducible demonstration that quantum amplitudes have phase, that phases interfere, that observation destroys interference, and that real hardware loses coherence as depth grows. diff --git a/quantum_alignment/results/results.csv b/quantum_alignment/results/results.csv new file mode 100644 index 0000000..ea77875 --- /dev/null +++ b/quantum_alignment/results/results.csv @@ -0,0 +1,17 @@ +experiment,backend_label,mode,label,parameter,shots,p0,p1,expected_p0,error,notes +phase_alignment,aer-noisy(generic_backend_5q),noisy,0,0.0,4096,0.99658203125,0.00341796875,1.0,0.00341796875, +phase_alignment,aer-noisy(generic_backend_5q),noisy,pi/8,0.39269908169872414,4096,0.95654296875,0.04345703125,0.9619397662556434,0.005396797505643369, +phase_alignment,aer-noisy(generic_backend_5q),noisy,pi/4,0.7853981633974483,4096,0.859130859375,0.140869140625,0.8535533905932737,0.005577468781726269, +phase_alignment,aer-noisy(generic_backend_5q),noisy,pi/2,1.5707963267948966,4096,0.4990234375,0.5009765625,0.5000000000000001,0.000976562500000111, +phase_alignment,aer-noisy(generic_backend_5q),noisy,3pi/4,2.356194490192345,4096,0.151123046875,0.848876953125,0.1464466094067263,0.004676437468273703, +phase_alignment,aer-noisy(generic_backend_5q),noisy,pi,3.141592653589793,4096,0.003662109375,0.996337890625,3.749399456654644e-33,0.003662109375, +observation,aer-noisy(generic_backend_5q),noisy,A_no_mid_measure,0,4096,0.995361328125,0.004638671875,1.0,0.004638671875,"H then H -> identity, expect p(0)=1" +observation,aer-noisy(generic_backend_5q),noisy,B_mid_measure,0,4096,0.499755859375,0.500244140625,0.5,0.000244140625,Mid-circuit measurement collapses the state; expect ~50/50 +noise_depth,aer-noisy(generic_backend_5q),noisy,xx_pairs=0,0,4096,0.997314453125,0.002685546875,1.0,0.002685546875, +noise_depth,aer-noisy(generic_backend_5q),noisy,xx_pairs=1,1,4096,0.99560546875,0.00439453125,1.0,0.00439453125, +noise_depth,aer-noisy(generic_backend_5q),noisy,xx_pairs=2,2,4096,0.99609375,0.00390625,1.0,0.00390625, +noise_depth,aer-noisy(generic_backend_5q),noisy,xx_pairs=4,4,4096,0.993408203125,0.006591796875,1.0,0.006591796875, +noise_depth,aer-noisy(generic_backend_5q),noisy,xx_pairs=8,8,4096,0.9951171875,0.0048828125,1.0,0.0048828125, +noise_depth,aer-noisy(generic_backend_5q),noisy,xx_pairs=16,16,4096,0.989990234375,0.010009765625,1.0,0.010009765625, +noise_depth,aer-noisy(generic_backend_5q),noisy,xx_pairs=32,32,4096,0.98828125,0.01171875,1.0,0.01171875, +noise_depth,aer-noisy(generic_backend_5q),noisy,xx_pairs=64,64,4096,0.979736328125,0.020263671875,1.0,0.020263671875, From 8cb1b5e49c455d4fdf34094a50972e2f14910bae Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 27 Apr 2026 02:14:20 +0000 Subject: [PATCH 2/3] =?UTF-8?q?feat(layer-101):=20Quantum=20Coherence=20La?= =?UTF-8?q?b=20=E2=80=94=20browser-native=20sibling=20of=20the=20Qiskit=20?= =?UTF-8?q?suite?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Completes the in-browser side of the quantum-alignment work that landed in 6325d38 (which shipped only the Python/Qiskit harness under quantum_alignment/). The original task asked for "browser-native first, no backend, simulate locally in JavaScript" — that part wasn't built. This adds: - src/utils/quantumCoherence.js: complex/H/X/Z/RZ helpers, three experiments (phase / observation / decoherence) shaped to mirror the Qiskit circuits in quantum_alignment/quantum_alignment_tests.py, simple dephasing + bit-flip noise, coherenceScore, and mapQuantumToBrainState (PFC↑ coherence · AMY↑ noise · THL↑ routing · HPC↑ survival · BG↑ dominance · CBL↑ correction · CTX↑ complexity). - src/components/QuantumCoherencePanel.jsx: theta / shots / noise / depth / observe-midway controls, scientific ↔ metaphor mode toggle, P(0)/P(1) bars, coherence score 0–100, plain-English explanation, circuit-row visualization. Cross-links the Qiskit suite as the hardware-grade offline path. - App.jsx: wired with onApplyToBrain that nudges the 7 region levels. - layerCatalog: registered as L101 with new "experimental" group. - Tests: 18 cases via node:test (theta=0/π, observation, decoherence, noise/depth scaling, brain mapping). `npm run test:quantum`. - Docs: README section explicitly disclaims literal multiverse / consciousness / Planck / spiritual claims; cross-references the Qiskit suite for hardware runs. No vendor API keys in the frontend — IBM tokens stay in the Python suite (IBM_QUANTUM_TOKEN at runtime). npm install + npm run build pass. https://claude.ai/code/session_01VYArf8MTS6QdhmswtqNPox --- brainsnn-r3f-app/README.md | 32 ++ brainsnn-r3f-app/package.json | 3 +- brainsnn-r3f-app/src/App.jsx | 23 + .../src/components/QuantumCoherencePanel.jsx | 394 ++++++++++++++++++ brainsnn-r3f-app/src/utils/layerCatalog.js | 2 + .../src/utils/quantumCoherence.js | 346 +++++++++++++++ .../src/utils/quantumCoherence.test.mjs | 171 ++++++++ 7 files changed, 970 insertions(+), 1 deletion(-) create mode 100644 brainsnn-r3f-app/src/components/QuantumCoherencePanel.jsx create mode 100644 brainsnn-r3f-app/src/utils/quantumCoherence.js create mode 100644 brainsnn-r3f-app/src/utils/quantumCoherence.test.mjs diff --git a/brainsnn-r3f-app/README.md b/brainsnn-r3f-app/README.md index 2d58cd7..b7f73aa 100644 --- a/brainsnn-r3f-app/README.md +++ b/brainsnn-r3f-app/README.md @@ -71,6 +71,38 @@ All optional. Copy [.env.example](.env.example) to `.env` and fill in only what | 33 | Multimodal RAG Router | [MultimodalRagPanel.jsx](src/components/MultimodalRagPanel.jsx) + [utils/multimodalRag.js](src/utils/multimodalRag.js) | | 34 | Vector-Graph Fusion | [VectorGraphFusionPanel.jsx](src/components/VectorGraphFusionPanel.jsx) | | 35 | Direct Content Insertion (JSON) | [DirectInsertPanel.jsx](src/components/DirectInsertPanel.jsx) | +| 101 | Quantum Coherence Lab | [QuantumCoherencePanel.jsx](src/components/QuantumCoherencePanel.jsx) + [utils/quantumCoherence.js](src/utils/quantumCoherence.js) | + +## Quantum Coherence Lab + +**Layer 101 — Quantum Coherence Lab.** A pure-JavaScript, in-browser simulation +of a single qubit running through `|0⟩ → H → RZ(θ) → H → M`. Slide the phase +θ to watch interference move probability between |0⟩ and |1⟩. Add noise to +damp the fringe. Toggle a mid-circuit observation to collapse superposition. +Stack X·X pairs (algebraically identity) to watch decoherence eat depth. + +**What this is.** A teaching sandbox for the *mechanism* behind the word +"alignment": phase coherence steers outcomes; noise and observation kill it. +A **Scientific / Metaphor** mode toggle reframes the same numbers in +plain English alongside the math. + +**What this is not.** This does **not** prove literal multiverse theory, +consciousness collapse, Planck foam, or spiritual portals. Those are framing +metaphors when the toggle is on, not physics claims. + +**Future backend.** The function surface (`runPhaseExperiment`, +`runDecoherenceExperiment`, etc.) is intentionally compatible with the +hardware-grade Qiskit suite at [`quantum_alignment/`](../quantum_alignment/), +which runs the same three experiments on ideal Aer, noisy Aer, or real IBM +Quantum hardware (and is shaped to swap in OriginQ later). **No vendor API +keys are added to the frontend** — IBM tokens stay in the Python suite, +read from `IBM_QUANTUM_TOKEN` at runtime only. + +Run the unit tests directly with Node (no extra dev deps): + +```bash +npm run test:quantum +``` ## Keyboard shortcuts diff --git a/brainsnn-r3f-app/package.json b/brainsnn-r3f-app/package.json index 00c8c03..cf9355d 100644 --- a/brainsnn-r3f-app/package.json +++ b/brainsnn-r3f-app/package.json @@ -11,7 +11,8 @@ "build": "vite build", "preview": "vite preview", "start": "node server.js", - "start:dev": "npm run build && node server.js" + "start:dev": "npm run build && node server.js", + "test:quantum": "node --test src/utils/quantumCoherence.test.mjs" }, "dependencies": { "@ffmpeg/ffmpeg": "^0.12.15", diff --git a/brainsnn-r3f-app/src/App.jsx b/brainsnn-r3f-app/src/App.jsx index afb3b3f..3213437 100644 --- a/brainsnn-r3f-app/src/App.jsx +++ b/brainsnn-r3f-app/src/App.jsx @@ -81,6 +81,7 @@ import HotkeyMap from './components/HotkeyMap'; import ThemePanel from './components/ThemePanel'; import CommunityPackPanel from './components/CommunityPackPanel'; import MilestonePanel from './components/MilestonePanel'; +import QuantumCoherencePanel from './components/QuantumCoherencePanel'; import { registerServiceWorker } from './utils/pwa'; import { registerTheme } from './utils/theme'; import DreamModePanel from './components/DreamModePanel'; @@ -779,6 +780,28 @@ export default function App() { + + { + markActivity(); + setState((prev) => { + const regions = { ...prev.regions }; + for (const [region, delta] of Object.entries(deltas)) { + if (regions[region] === undefined) continue; + regions[region] = Math.max(0.04, Math.min(0.95, regions[region] + delta * 0.3)); + } + return { + ...prev, + regions, + tick: (prev.tick ?? 0) + 1, + scenario: `Quantum Coherence (${score}/100)`, + }; + }); + toastSuccess(`Quantum coherence ${score}/100 mapped to brain · ${result.kind}`); + }} + /> + + diff --git a/brainsnn-r3f-app/src/components/QuantumCoherencePanel.jsx b/brainsnn-r3f-app/src/components/QuantumCoherencePanel.jsx new file mode 100644 index 0000000..6d92fd0 --- /dev/null +++ b/brainsnn-r3f-app/src/components/QuantumCoherencePanel.jsx @@ -0,0 +1,394 @@ +import React, { useMemo, useState } from 'react'; +import { + runPhaseExperiment, + runObservationExperiment, + runDecoherenceExperiment, + coherenceScore, + mapQuantumToBrainState, +} from '../utils/quantumCoherence'; + +/** + * Layer 101 — Quantum Coherence Lab panel. + * + * Local, in-browser simulation of the simplest possible quantum circuit: + * |0⟩ → H → RZ(θ) → H → M + * + * Teaches superposition, phase, interference, observation, noise, and + * decoherence. The "Metaphor" toggle re-frames the same numbers in + * everyday language; nothing in this panel claims literal multiverse + * theory, consciousness collapse, Planck foam, or spiritual portals — + * those are framing aids, not physics claims. + * + * For an offline / hardware-grade version of the same three experiments, + * see /quantum_alignment/ (Qiskit + ideal/noisy/IBM-real backends). + */ + +const SHOTS_OPTIONS = [256, 1024, 4096]; + +const SHOTS_HINT = { + 256: 'Quick — noisy bars', + 1024: 'Default — balanced', + 4096: 'Slow — smooth bars', +}; + +function fmtPercent(p) { + return `${(p * 100).toFixed(1)}%`; +} + +function ProbabilityBars({ distribution, counts }) { + const [p0, p1] = distribution; + return ( +
+ {[ + { label: '|0⟩', p: p0, count: counts[0], color: '#5ad4ff' }, + { label: '|1⟩', p: p1, count: counts[1], color: '#a86fdf' }, + ].map((b) => ( +
+
+ {b.label} + + {fmtPercent(b.p)} · {b.count} shots + +
+
+
+
+
+ ))} +
+ ); +} + +function CircuitRow({ theta, observeMidway, depth }) { + const gates = [ + { label: 'H', desc: 'Hadamard — make superposition' }, + { label: `RZ(${theta.toFixed(2)})`, desc: 'Rotate the relative phase' }, + ]; + if (observeMidway) { + gates.push({ label: '👁 M', desc: 'Mid-circuit measurement' }); + } + if (depth > 0) { + gates.push({ label: `(X·X)×${depth}`, desc: 'Identity on paper, decoherence in practice' }); + } + gates.push({ label: 'H', desc: 'Hadamard — recombine for interference' }); + gates.push({ label: 'M', desc: 'Final measurement — read out 0 or 1' }); + + return ( +
+ |0⟩ + {gates.map((g, i) => ( + + → + + {g.label} + + + ))} +
+ ); +} + +function buildExplanation({ result, score, mode, theta, observeMidway, depth, noise }) { + const [p0, p1] = result.distribution; + const dominant = p0 >= p1 ? '|0⟩' : '|1⟩'; + const dominantPct = fmtPercent(Math.max(p0, p1)); + const balanced = Math.abs(p0 - p1) < 0.1; + + if (mode === 'metaphor') { + if (observeMidway) { + return `Watching the qubit mid-flight collapsed it. Like checking a Schrödinger box too early — the second H spreads the now-classical bit back into ~50/50, score ${score}/100. Metaphor: peek at a held thought and you lose the held thought.`; + } + if (balanced) { + return `Phase tuned to a place where both outcomes interfere equally — ${dominantPct} either way. Metaphor: two stories with equal pull. Coherence ${score}/100.`; + } + if (noise > 0.5) { + return `Noise ate the interference. The qubit drifted toward ${dominant} (${dominantPct}) but without the clean fringe. Metaphor: signal in a loud room. Coherence ${score}/100.`; + } + if (depth > 0) { + return `Stacked ${depth} X·X pairs — algebraically a no-op, but each gate leaks. Metaphor: a long whispered chain stays the same on paper, drifts in real life. Coherence ${score}/100.`; + } + return `Phase steered the wave to ${dominant} (${dominantPct}). Metaphor: aligned attention picks one outcome out of two. Coherence ${score}/100.`; + } + + // Scientific mode + if (observeMidway) { + return `Mid-circuit measurement collapsed |+⟩ to a basis state, killing interference at the second H. Result is ~50/50 (${dominantPct} ${dominant}). Coherence ${score}/100. This is the "watched-path kills fringe" lesson.`; + } + if (depth > 0) { + return `${depth} X·X pairs. Ideal: identity (P(0)=1). With noise=${noise.toFixed(2)} and dephasing per gate, you got P(${dominant})=${dominantPct}. Coherence drops with depth × noise. Score ${score}/100.`; + } + if (balanced) { + return `θ=${theta.toFixed(2)} sits near π/2 — H·RZ(π/2)·H gives ~50/50. P(${dominant})=${dominantPct}. Interference fringe present at low noise. Score ${score}/100.`; + } + return `H → RZ(${theta.toFixed(2)}) → H → M. Phase rotation interferes at the second H, biasing the readout to ${dominant} (${dominantPct}). Noise=${noise.toFixed(2)}, coherence ${score}/100.`; +} + +export default function QuantumCoherencePanel({ onApplyToBrain } = {}) { + const [theta, setTheta] = useState(0); + const [shots, setShots] = useState(1024); + const [noise, setNoise] = useState(0); + const [depth, setDepth] = useState(0); // X-X pair count + const [observeMidway, setObserveMidway] = useState(false); + const [mode, setMode] = useState('scientific'); // 'scientific' | 'metaphor' + const [runToken, setRunToken] = useState(0); // bumps every Re-run click + + const result = useMemo(() => { + void runToken; + if (observeMidway) { + return runObservationExperiment({ shots, observeMidway: true, noise }); + } + if (depth > 0) { + return runDecoherenceExperiment({ xxPairs: depth, shots, noise }); + } + return runPhaseExperiment({ theta, shots, noise }); + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [theta, shots, noise, depth, observeMidway, runToken]); + + const score = useMemo( + () => coherenceScore({ + noise, + depth: Math.max(1, depth + 1), + observedMidway: observeMidway, + }), + [noise, depth, observeMidway], + ); + + const explanation = useMemo( + () => buildExplanation({ result, score, mode, theta, observeMidway, depth, noise }), + [result, score, mode, theta, observeMidway, depth, noise], + ); + + const brainDeltas = useMemo(() => mapQuantumToBrainState(result), [result]); + + return ( +
+
Layer 101 · quantum coherence lab
+

Phase, interference, decoherence — in your browser

+

+ A single qubit running |0⟩ → H → RZ(θ) → H → M, simulated + locally in JavaScript. Slide θ to see interference move probability + between |0⟩ and |1⟩. Add noise. Toggle a mid-circuit observation. + Stack X·X pairs to watch identity-on-paper fall apart in practice. +

+

+ This teaches the mechanism behind the word "alignment" — phase + coherence steers outcomes; noise and observation kill it. It does + not prove multiverse theory, consciousness collapse, Planck foam, + or spiritual portals. Those are metaphors when the toggle is on. + For an offline Qiskit run on ideal / noisy / real IBM hardware, see + the quantum_alignment/ suite at the repo root. +

+ +
+ + + + {onApplyToBrain && ( + + )} +
+ + {/* Sliders */} +
+
+
+ Phase θ (0 → π) + {theta.toFixed(3)} +
+ setTheta(parseFloat(e.target.value))} + disabled={observeMidway || depth > 0} + style={{ width: '100%' }} + /> +
+ +
+
+ Noise (0 = ideal, 1 = thermal mush) + {noise.toFixed(2)} +
+ setNoise(parseFloat(e.target.value))} + style={{ width: '100%' }} + /> +
+ +
+
+ Depth — extra X·X pairs (algebraically zero work) + {depth} +
+ setDepth(parseInt(e.target.value, 10))} + style={{ width: '100%' }} + /> +
+ +
+ Shots: + {SHOTS_OPTIONS.map((s) => ( + + ))} + +
+
+ + {/* Circuit visualization */} + + + {/* Probability bars */} + + + {/* Coherence score */} +
= 70 ? '#5ee69a' : score >= 40 ? '#fdab43' : '#dd6974'}`, + display: 'flex', + justifyContent: 'space-between', + alignItems: 'center', + }} + > + + Coherence score{' '} + {score}/100 + + + {score >= 70 ? 'phase intact' : score >= 40 ? 'fading' : 'decohered'} + +
+ + {/* Explanation */} +

+ {explanation} +

+ + {/* Brain deltas preview */} +
+ + Region deltas (preview) + +
+ {Object.entries(brainDeltas).map(([region, delta]) => ( +
+
{region}
+
0 ? '#5ee69a' : '#94a3b8' }}> + {delta >= 0 ? '+' : ''}{delta.toFixed(2)} +
+
+ ))} +
+
+
+ ); +} diff --git a/brainsnn-r3f-app/src/utils/layerCatalog.js b/brainsnn-r3f-app/src/utils/layerCatalog.js index 110bd86..a4b6154 100644 --- a/brainsnn-r3f-app/src/utils/layerCatalog.js +++ b/brainsnn-r3f-app/src/utils/layerCatalog.js @@ -107,6 +107,7 @@ export const LAYER_CATALOG = [ { id: 98, name: 'Theme + A11y', group: 'view', blurb: 'Dark/light, high-contrast, reduced-motion, font scale.' }, { id: 99, name: 'Federated Community Firewall', group: 'firewall', blurb: 'Weekly-rotated community rule pack.' }, { id: 100, name: 'Milestone Dashboard', group: 'view', blurb: '100 layers shipped — synthesis + personal stats.' }, + { id: 101, name: 'Quantum Coherence Lab', group: 'experimental', blurb: 'In-browser single-qubit phase / interference / decoherence sandbox.' }, ]; export const LAYER_GROUPS = { @@ -116,6 +117,7 @@ export const LAYER_GROUPS = { data: { label: 'Data & State', color: '#5ee69a' }, backend: { label: 'Backend & Agents', color: '#77dbe4' }, progression: { label: 'Progression', color: '#e57b40' }, + experimental: { label: 'Experimental Simulation', color: '#5ad4ff' }, }; export function searchLayers(query = '') { diff --git a/brainsnn-r3f-app/src/utils/quantumCoherence.js b/brainsnn-r3f-app/src/utils/quantumCoherence.js new file mode 100644 index 0000000..7775d62 --- /dev/null +++ b/brainsnn-r3f-app/src/utils/quantumCoherence.js @@ -0,0 +1,346 @@ +/** + * Layer 101 — Quantum Coherence Lab + * + * Browser-native, JavaScript-only simulation of a single qubit going through + * a tiny circuit: + * + * |0⟩ → H → RZ(θ) → H → M + * + * Goal: teach the physical mechanism behind "alignment" — superposition, + * phase, interference, observation, noise, and decoherence — without + * claiming any of the metaphors are literal physics. + * + * No backend, no IBM/OriginQ keys. The function shapes here are intentionally + * compatible with the Qiskit suite at /quantum_alignment/, so a future + * version can swap the local sampler for hardware (Aer noisy / IBM Quantum / + * OriginQ) without changing the panel. + * + * NOTHING in this file proves multiverse theory, consciousness collapse, + * Planck foam, or spiritual portals. The metaphor framing lives only in + * the panel UI, not in the math. + */ + +// ---------- complex helpers ------------------------------------------------- + +export function complex(re, im = 0) { + return { re, im }; +} + +export function addComplex(a, b) { + return { re: a.re + b.re, im: a.im + b.im }; +} + +export function mulComplex(a, b) { + return { + re: a.re * b.re - a.im * b.im, + im: a.re * b.im + a.im * b.re, + }; +} + +/** |z|^2 — squared magnitude. */ +export function abs2(z) { + return z.re * z.re + z.im * z.im; +} + +// ---------- single-qubit state --------------------------------------------- + +/** + * State is a 2-vector of complex amplitudes [α, β] for |0⟩ and |1⟩. + * normalizeState scales so |α|^2 + |β|^2 = 1 (or returns |0⟩ if zero). + */ +export function normalizeState(state) { + const total = abs2(state[0]) + abs2(state[1]); + if (!Number.isFinite(total) || total <= 1e-12) { + return [complex(1, 0), complex(0, 0)]; + } + const k = 1 / Math.sqrt(total); + return [ + complex(state[0].re * k, state[0].im * k), + complex(state[1].re * k, state[1].im * k), + ]; +} + +const SQRT1_2 = 1 / Math.SQRT2; + +/** Hadamard — creates / collapses superposition. */ +export function applyH(state) { + const a = state[0]; + const b = state[1]; + return [ + complex((a.re + b.re) * SQRT1_2, (a.im + b.im) * SQRT1_2), + complex((a.re - b.re) * SQRT1_2, (a.im - b.im) * SQRT1_2), + ]; +} + +/** Pauli-X — bit flip. */ +export function applyX(state) { + return [state[1], state[0]]; +} + +/** Pauli-Z — phase flip on |1⟩. */ +export function applyZ(state) { + return [state[0], complex(-state[1].re, -state[1].im)]; +} + +/** + * RZ(θ) — rotate phase. Standard form: diag(e^{-iθ/2}, e^{+iθ/2}). + * Global phase on |0⟩ is harmless for measurement; the *relative* phase + * between the two basis amplitudes is what matters for interference. + */ +export function applyRZ(state, theta) { + const half = theta / 2; + const c0 = complex(Math.cos(-half), Math.sin(-half)); + const c1 = complex(Math.cos(half), Math.sin(half)); + return [mulComplex(c0, state[0]), mulComplex(c1, state[1])]; +} + +// ---------- measurement ----------------------------------------------------- + +/** Returns [P(0), P(1)] for a normalized (or near-normalized) state. */ +export function measureDistribution(state) { + const norm = normalizeState(state); + const p0 = abs2(norm[0]); + const p1 = abs2(norm[1]); + const total = p0 + p1 || 1; + return [p0 / total, p1 / total]; +} + +/** + * Multinomial sample of `shots` measurements given a [P(0), P(1)] distribution. + * Uses Math.random; tests should compare proportions with tolerances rather + * than exact counts. + */ +export function sampleShots(distribution, shots) { + const total = Math.max(0, Math.floor(shots) || 0); + if (!total) return [0, 0]; + const p0 = Math.max(0, Math.min(1, distribution[0] ?? 0)); + let zeros = 0; + for (let i = 0; i < total; i += 1) { + if (Math.random() < p0) zeros += 1; + } + return [zeros, total - zeros]; +} + +// ---------- simple noise model --------------------------------------------- + +/** + * Dephasing damps the off-diagonal coherence. We model the state as a + * length-2 amplitude vector but simulate the qualitative effect of T2 + * dephasing by squeezing the imaginary part of β toward zero. This + * reproduces "lose interference fringe with noise" without a full + * density-matrix sim. + */ +function dephase(state, factor) { + const k = Math.max(0, Math.min(1, factor)); + if (k >= 0.999) return state; + return [ + state[0], + complex(state[1].re, state[1].im * k), + ]; +} + +/** Bit-flip channel: with probability p, swap |0⟩ ↔ |1⟩. */ +function bitFlip(state, p) { + if (p <= 0) return state; + if (Math.random() < p) return applyX(state); + return state; +} + +// ---------- experiments ----------------------------------------------------- + +/** + * H → RZ(θ) → H → M. + * + * Pure (noise = 0): + * θ = 0 → P(0) = 1 + * θ = π → P(1) = 1 + * θ = π/2 → P(0) = P(1) = 0.5 + * + * Higher noise damps the interference fringe, pushing both outcomes toward + * 0.5 regardless of θ. This is the "alignment" picture: phase coherence is + * the resource; noise is the enemy. + * + * Mirrors `phase_circuit(theta)` in /quantum_alignment/quantum_alignment_tests.py. + */ +export function runPhaseExperiment({ theta = 0, shots = 1024, noise = 0 } = {}) { + let state = [complex(1, 0), complex(0, 0)]; + state = applyH(state); + state = applyRZ(state, theta); + // Single-step dephasing between RZ and final H, parameterized by noise. + const dephaseFactor = Math.max(0, 1 - noise); + state = dephase(state, dephaseFactor); + state = applyH(state); + // Bit-flip readout error scales with noise. + state = bitFlip(state, noise * 0.25); + const distribution = measureDistribution(state); + const counts = sampleShots(distribution, shots); + return { + kind: 'phase', + theta, + shots, + noise, + distribution, + counts, + finalState: state, + }; +} + +/** + * H → (optional middle measurement) → H → M. + * + * Without the middle measurement: H ∘ H = I, so |0⟩ stays |0⟩ → P(0) ≈ 1. + * With the middle measurement: superposition collapses, the second H + * spreads it back out → P(0) ≈ P(1) ≈ 0.5. + * + * Demonstrates "observation kills interference" — the quantum-Zeno / + * which-path lesson, without invoking consciousness. + * + * Mirrors `observation_circuit_a/b` in /quantum_alignment/. + */ +export function runObservationExperiment({ + shots = 1024, + observeMidway = false, + noise = 0, +} = {}) { + let state = [complex(1, 0), complex(0, 0)]; + state = applyH(state); + + if (observeMidway) { + const [p0] = measureDistribution(state); + const collapsed = Math.random() < p0 + ? [complex(1, 0), complex(0, 0)] + : [complex(0, 0), complex(1, 0)]; + state = collapsed; + } else { + // Apply mild dephasing instead — a "soft watch" that costs coherence. + state = dephase(state, Math.max(0, 1 - noise)); + } + + state = applyH(state); + state = bitFlip(state, noise * 0.25); + + const distribution = measureDistribution(state); + const counts = sampleShots(distribution, shots); + return { + kind: 'observation', + observeMidway, + shots, + noise, + distribution, + counts, + finalState: state, + }; +} + +/** + * Stack `xxPairs` X-X pairs in a row. Algebraically X·X = I, so a perfect + * machine returns P(0) = 1 regardless of depth. With noise, each gate is + * a chance to misfire, so deeper circuits decohere — which is the point. + * + * Mirrors `noise_depth_circuit(num_xx_pairs)` in /quantum_alignment/. + */ +export function runDecoherenceExperiment({ + xxPairs = 1, + shots = 1024, + noise = 0, +} = {}) { + const pairs = Math.max(0, Math.floor(xxPairs) || 0); + let state = [complex(1, 0), complex(0, 0)]; + for (let i = 0; i < pairs; i += 1) { + state = applyX(state); + state = bitFlip(state, noise * 0.5); + state = applyX(state); + state = bitFlip(state, noise * 0.5); + state = dephase(state, Math.max(0, 1 - noise * 0.4)); + } + const distribution = measureDistribution(state); + const counts = sampleShots(distribution, shots); + return { + kind: 'decoherence', + xxPairs: pairs, + shots, + noise, + distribution, + counts, + finalState: state, + }; +} + +// ---------- coherence score ------------------------------------------------- + +/** + * 0 – 100 score capturing how much "quantum-ness" survived the run. + * - More noise lowers the score. + * - Deeper circuits lower the score. + * - A midway measurement nukes the score (you broke the wavefunction). + * + * Pure determinism (no Math.random) so the UI is stable. + */ +export function coherenceScore({ + noise = 0, + depth = 1, + observedMidway = false, +} = {}) { + const n = Math.max(0, Math.min(1, Number(noise) || 0)); + const d = Math.max(1, Math.floor(Number(depth) || 1)); + const observationPenalty = observedMidway ? 0.5 : 0; + const depthFactor = Math.exp(-0.18 * (d - 1)); + const noiseFactor = 1 - n * 0.85; + const raw = depthFactor * noiseFactor - observationPenalty; + const clamped = Math.max(0, Math.min(1, raw)); + return Math.round(clamped * 100); +} + +// ---------- brain mapping --------------------------------------------------- + +/** + * Convert a quantum experiment result into per-region brain deltas. + * Returns a simple { REGION: delta } object — caller decides how strongly + * to nudge state.regions (typical pattern is `delta * 0.3`). + * + * - PFC ↑ with coherenceScore (alignment / executive coherence) + * - AMY ↑ with noise (the system is rattled) + * - THL ↑ with signal routing (more shots = more relay traffic) + * - HPC ↑ when prior state survives (low depth + low noise = memory holds) + * - BG ↑ when one outcome dominates (decisive gating) + * - CBL ↑ when error / noise correction is high (cerebellum tunes timing) + * - CTX ↑ with experiment complexity (more gates = more cortical work) + * + * Deltas are bounded to [-1, 1]; consumers should scale further. + */ +export function mapQuantumToBrainState(result) { + if (!result || !result.distribution) { + return { CTX: 0, HPC: 0, THL: 0, AMY: 0, BG: 0, PFC: 0, CBL: 0 }; + } + const noise = Math.max(0, Math.min(1, Number(result.noise) || 0)); + const shots = Math.max(1, Number(result.shots) || 1); + const depth = Math.max(1, Number(result.xxPairs ?? 1)); + const observedMidway = !!result.observeMidway; + + const score = coherenceScore({ noise, depth, observedMidway }) / 100; + + const [p0, p1] = result.distribution; + const dominance = Math.abs((p0 ?? 0) - (p1 ?? 0)); + const survival = (p0 ?? 0); + + const routing = Math.min(1, Math.log10(shots) / 4); + const complexity = Math.min( + 1, + (result.kind === 'decoherence' ? depth / 10 : 0.35) + + (result.kind === 'observation' && observedMidway ? 0.15 : 0) + + (result.kind === 'phase' ? 0.4 : 0), + ); + const correction = noise * (1 - score); + + const clamp = (v) => Math.max(-1, Math.min(1, v)); + + return { + PFC: clamp(score * 0.6), + AMY: clamp(noise * 0.5), + THL: clamp(routing * 0.45), + HPC: clamp(survival * 0.5 * (1 - noise * 0.5)), + BG: clamp(dominance * 0.5), + CBL: clamp(correction * 0.6), + CTX: clamp(complexity * 0.5), + }; +} diff --git a/brainsnn-r3f-app/src/utils/quantumCoherence.test.mjs b/brainsnn-r3f-app/src/utils/quantumCoherence.test.mjs new file mode 100644 index 0000000..cf226a4 --- /dev/null +++ b/brainsnn-r3f-app/src/utils/quantumCoherence.test.mjs @@ -0,0 +1,171 @@ +/** + * Layer 101 — Quantum Coherence Lab tests. + * + * Run from brainsnn-r3f-app/ with: + * node --test src/utils/quantumCoherence.test.mjs + * + * Uses Node's built-in test runner (Node 18+). No extra dev deps. + */ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { + runPhaseExperiment, + runObservationExperiment, + runDecoherenceExperiment, + coherenceScore, + measureDistribution, + applyH, + applyX, + applyZ, + applyRZ, + complex, + abs2, + normalizeState, + mapQuantumToBrainState, +} from './quantumCoherence.js'; + +const SHOTS = 4096; + +test('phase experiment with theta=0 returns high P(0)', () => { + const res = runPhaseExperiment({ theta: 0, shots: SHOTS, noise: 0 }); + assert.equal(res.kind, 'phase'); + assert.ok( + res.distribution[0] > 0.95, + `expected P(0) > 0.95, got ${res.distribution[0]}`, + ); +}); + +test('phase experiment with theta=pi returns high P(1)', () => { + const res = runPhaseExperiment({ theta: Math.PI, shots: SHOTS, noise: 0 }); + assert.ok( + res.distribution[1] > 0.95, + `expected P(1) > 0.95, got ${res.distribution[1]}`, + ); +}); + +test('phase experiment at theta=pi/2 splits ~50/50', () => { + const res = runPhaseExperiment({ theta: Math.PI / 2, shots: SHOTS, noise: 0 }); + assert.ok( + Math.abs(res.distribution[0] - 0.5) < 0.05, + `expected P(0) ~ 0.5, got ${res.distribution[0]}`, + ); +}); + +test('observation experiment with observeMidway=false returns high P(0)', () => { + // H ∘ H = I, so |0⟩ stays |0⟩. + const res = runObservationExperiment({ shots: SHOTS, observeMidway: false, noise: 0 }); + assert.ok( + res.distribution[0] > 0.95, + `expected P(0) > 0.95 with no midway observation, got ${res.distribution[0]}`, + ); +}); + +test('observation experiment with observeMidway=true is more random', () => { + // Average over runs since the midway measurement is stochastic. + let p0Sum = 0; + const trials = 40; + for (let i = 0; i < trials; i += 1) { + const r = runObservationExperiment({ shots: 256, observeMidway: true, noise: 0 }); + p0Sum += r.distribution[0]; + } + const avgP0 = p0Sum / trials; + assert.ok( + avgP0 > 0.35 && avgP0 < 0.65, + `expected avg P(0) ~ 0.5 after midway measurement, got ${avgP0.toFixed(3)}`, + ); +}); + +test('increasing noise lowers coherenceScore', () => { + const low = coherenceScore({ noise: 0, depth: 1, observedMidway: false }); + const mid = coherenceScore({ noise: 0.5, depth: 1, observedMidway: false }); + const high = coherenceScore({ noise: 1, depth: 1, observedMidway: false }); + assert.ok(low > mid, `expected ${low} > ${mid}`); + assert.ok(mid > high, `expected ${mid} > ${high}`); +}); + +test('increasing depth lowers coherenceScore', () => { + const shallow = coherenceScore({ noise: 0.1, depth: 1, observedMidway: false }); + const deeper = coherenceScore({ noise: 0.1, depth: 5, observedMidway: false }); + const deepest = coherenceScore({ noise: 0.1, depth: 12, observedMidway: false }); + assert.ok(shallow > deeper, `expected ${shallow} > ${deeper}`); + assert.ok(deeper > deepest, `expected ${deeper} > ${deepest}`); +}); + +test('observing midway dings coherenceScore', () => { + const watched = coherenceScore({ noise: 0, depth: 1, observedMidway: true }); + const unwatched = coherenceScore({ noise: 0, depth: 1, observedMidway: false }); + assert.ok(unwatched > watched, `expected ${unwatched} > ${watched}`); +}); + +test('decoherence experiment ideal (noise=0) returns ~P(0)=1', () => { + const res = runDecoherenceExperiment({ xxPairs: 8, shots: SHOTS, noise: 0 }); + assert.ok( + res.distribution[0] > 0.99, + `X·X pairs are identity at noise=0; got P(0)=${res.distribution[0]}`, + ); +}); + +test('decoherence experiment with noise lowers P(0) vs ideal', () => { + const ideal = runDecoherenceExperiment({ xxPairs: 6, shots: SHOTS, noise: 0 }); + const noisy = runDecoherenceExperiment({ xxPairs: 6, shots: SHOTS, noise: 0.7 }); + assert.ok( + noisy.distribution[0] < ideal.distribution[0], + `expected noisy P(0) < ideal P(0); got ${noisy.distribution[0]} vs ${ideal.distribution[0]}`, + ); +}); + +test('Hadamard on |0> gives equal probabilities', () => { + const state = applyH([complex(1, 0), complex(0, 0)]); + const [p0, p1] = measureDistribution(state); + assert.ok(Math.abs(p0 - 0.5) < 1e-9); + assert.ok(Math.abs(p1 - 0.5) < 1e-9); +}); + +test('Pauli-X flips |0> to |1>', () => { + const state = applyX([complex(1, 0), complex(0, 0)]); + const [p0, p1] = measureDistribution(state); + assert.ok(p1 > 0.999); + assert.ok(p0 < 0.001); +}); + +test('Pauli-Z preserves probabilities (phase only)', () => { + const start = applyH([complex(1, 0), complex(0, 0)]); + const after = applyZ(start); + const before = measureDistribution(start); + const post = measureDistribution(after); + assert.ok(Math.abs(before[0] - post[0]) < 1e-9); +}); + +test('RZ(2π) acts as identity on probabilities', () => { + const start = applyH([complex(1, 0), complex(0, 0)]); + const after = applyRZ(start, Math.PI * 2); + assert.ok(Math.abs(abs2(start[0]) - abs2(after[0])) < 1e-9); + assert.ok(Math.abs(abs2(start[1]) - abs2(after[1])) < 1e-9); +}); + +test('normalizeState normalizes near-zero state to |0>', () => { + const norm = normalizeState([complex(0, 0), complex(0, 0)]); + assert.equal(norm[0].re, 1); + assert.equal(norm[1].re, 0); +}); + +test('mapQuantumToBrainState returns 7 region deltas in [-1, 1]', () => { + const res = runPhaseExperiment({ theta: 0, shots: 1024, noise: 0 }); + const deltas = mapQuantumToBrainState(res); + for (const region of ['CTX', 'HPC', 'THL', 'AMY', 'BG', 'PFC', 'CBL']) { + assert.ok(region in deltas, `missing region ${region}`); + assert.ok(deltas[region] >= -1 && deltas[region] <= 1, `${region} out of range: ${deltas[region]}`); + } +}); + +test('mapQuantumToBrainState: AMY rises with noise', () => { + const clean = mapQuantumToBrainState(runPhaseExperiment({ theta: 0, shots: 256, noise: 0 })); + const noisy = mapQuantumToBrainState(runPhaseExperiment({ theta: 0, shots: 256, noise: 0.9 })); + assert.ok(noisy.AMY > clean.AMY, `expected noisy AMY > clean AMY; got ${noisy.AMY} vs ${clean.AMY}`); +}); + +test('mapQuantumToBrainState: PFC rises with coherence (clean run > noisy run)', () => { + const clean = mapQuantumToBrainState(runPhaseExperiment({ theta: 0, shots: 256, noise: 0 })); + const noisy = mapQuantumToBrainState(runPhaseExperiment({ theta: 0, shots: 256, noise: 0.95 })); + assert.ok(clean.PFC > noisy.PFC, `expected clean PFC > noisy PFC; got ${clean.PFC} vs ${noisy.PFC}`); +}); From 3121c1a7209ed5e255aada74897fd13804f659cb Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 28 Apr 2026 03:21:37 +0000 Subject: [PATCH 3/3] feat(layers-102-104): Bell Pair Lab + Quantum Sweep + Quantum Glossary MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Completes the quantum cluster on top of L101. All three layers are browser-native, no backend, no vendor API keys. Layer 102 — Bell Pair Lab - bellPair.js: 2-qubit state (4 amplitudes), H/X/RY/RZ-on-qubit, CNOT, joint distribution + sampling, signed correlationStrength. - runBellPairExperiment: |00⟩ → H ⊗ I → CNOT(0,1) → optional RY(θ) on qubit 0 → joint measurement. Depolarizing noise mixes the pure distribution with uniform [0.25 × 4] by weight `noise`. - mapBellToBrainState: HPC↑ correlation, PFC↑ |correlation|, CTX↑ shots, AMY↑ noise, THL↑ rotation, BG↑ dominance, CBL↑ noise·(1-|corr|). - BellPairPanel: RY-θ slider, noise slider, shots picker, joint bars for |00⟩|01⟩|10⟩|11⟩, signed correlation strength card, ASCII circuit diagram, Scientific ↔ Metaphor mode, Apply-to-brain. - 12 tests covering Hadamard / CNOT / Bell construction / rotation breakdown / noise damping / brain mapping bounds. Layer 103 — Quantum Sweep - quantumSweep.js: runSweep(kind: 'phase' | 'noise' | 'depth'), CSV serialization with the same column shape as quantum_alignment/results/results.csv, sweepSummary stats. - QuantumSweepPanel: kind picker, steps / shots / fixed-noise / fixed-θ / max-depth controls, inline SVG line chart of P(0) / P(1) vs the ideal curve, "Download CSV" button. - 9 tests covering sweep correctness, CSV escaping, summary math. Layer 104 — Quantum Glossary - QuantumGlossaryPanel: searchable reference card (23 terms across states / gates / processes / noise / metrics) with plain-language, math, and metaphor columns side-by-side. Complements the Metaphor toggle in L101 and L102. L101 noise model - Replaced random per-gate bit-flips with a single depolarizing-style distribution mix (matches L102 / L103). This makes runs deterministic in expectation, fixes a flaky decoherence test, and aligns with the "noise = mix toward uniform" reading the panel and glossary teach. Wiring - App.jsx: 3 new ErrorBoundary blocks, L102 wired with onApplyToBrain. - layerCatalog.js: L102 / L103 / L104 registered under the experimental group. - README.md: file-map rows for 102/103/104; Quantum Coherence Lab section gains a "cluster siblings" subsection summarizing all three. - package.json: test:quantum runs all three test files. 39/39 tests pass (`npm run test:quantum`). `npm run build` ✓ — index bundle 648 → 676 KB (+27 KB / +7 KB gzipped) for three new layers. https://claude.ai/code/session_01VYArf8MTS6QdhmswtqNPox --- brainsnn-r3f-app/README.md | 8 + brainsnn-r3f-app/package.json | 2 +- brainsnn-r3f-app/src/App.jsx | 33 ++ .../src/components/BellPairPanel.jsx | 199 ++++++++++++ .../src/components/QuantumGlossaryPanel.jsx | 284 ++++++++++++++++++ .../src/components/QuantumSweepPanel.jsx | 193 ++++++++++++ brainsnn-r3f-app/src/utils/bellPair.js | 237 +++++++++++++++ brainsnn-r3f-app/src/utils/bellPair.test.mjs | 117 ++++++++ brainsnn-r3f-app/src/utils/layerCatalog.js | 3 + .../src/utils/quantumCoherence.js | 47 +-- brainsnn-r3f-app/src/utils/quantumSweep.js | 202 +++++++++++++ .../src/utils/quantumSweep.test.mjs | 86 ++++++ 12 files changed, 1387 insertions(+), 24 deletions(-) create mode 100644 brainsnn-r3f-app/src/components/BellPairPanel.jsx create mode 100644 brainsnn-r3f-app/src/components/QuantumGlossaryPanel.jsx create mode 100644 brainsnn-r3f-app/src/components/QuantumSweepPanel.jsx create mode 100644 brainsnn-r3f-app/src/utils/bellPair.js create mode 100644 brainsnn-r3f-app/src/utils/bellPair.test.mjs create mode 100644 brainsnn-r3f-app/src/utils/quantumSweep.js create mode 100644 brainsnn-r3f-app/src/utils/quantumSweep.test.mjs diff --git a/brainsnn-r3f-app/README.md b/brainsnn-r3f-app/README.md index b7f73aa..4c0b651 100644 --- a/brainsnn-r3f-app/README.md +++ b/brainsnn-r3f-app/README.md @@ -72,6 +72,9 @@ All optional. Copy [.env.example](.env.example) to `.env` and fill in only what | 34 | Vector-Graph Fusion | [VectorGraphFusionPanel.jsx](src/components/VectorGraphFusionPanel.jsx) | | 35 | Direct Content Insertion (JSON) | [DirectInsertPanel.jsx](src/components/DirectInsertPanel.jsx) | | 101 | Quantum Coherence Lab | [QuantumCoherencePanel.jsx](src/components/QuantumCoherencePanel.jsx) + [utils/quantumCoherence.js](src/utils/quantumCoherence.js) | +| 102 | Bell Pair Lab | [BellPairPanel.jsx](src/components/BellPairPanel.jsx) + [utils/bellPair.js](src/utils/bellPair.js) | +| 103 | Quantum Sweep | [QuantumSweepPanel.jsx](src/components/QuantumSweepPanel.jsx) + [utils/quantumSweep.js](src/utils/quantumSweep.js) | +| 104 | Quantum Glossary | [QuantumGlossaryPanel.jsx](src/components/QuantumGlossaryPanel.jsx) | ## Quantum Coherence Lab @@ -98,6 +101,11 @@ Quantum hardware (and is shaped to swap in OriginQ later). **No vendor API keys are added to the frontend** — IBM tokens stay in the Python suite, read from `IBM_QUANTUM_TOKEN` at runtime only. +**Cluster siblings.** Three follow-on layers extend L101 into a coherent quantum module: +- **Layer 102 — Bell Pair Lab.** Two qubits run through `H ⊗ I → CNOT` to build the Bell state `|Φ+⟩ = (|00⟩ + |11⟩) / √2`. RY(θ) on qubit 0 lets you watch correlation slide from +1 (mirrored) to 0 (decohered) to −1 (anti-mirrored). Important framing: this is statistical correlation, *not* information transfer. +- **Layer 103 — Quantum Sweep.** Auto-sweeps θ / noise / X·X-depth, plots P(0) and P(1) against the closed-form ideal, and exports a CSV with the same column shape as `quantum_alignment/results/results.csv` so browser-sim curves can be compared directly with the Qiskit ideal/noisy/real curves. +- **Layer 104 — Quantum Glossary.** Searchable reference card for every term used in L101–L103 — plain language, the math, and a metaphor column explicitly framed as a teaching aid. + Run the unit tests directly with Node (no extra dev deps): ```bash diff --git a/brainsnn-r3f-app/package.json b/brainsnn-r3f-app/package.json index cf9355d..dc9a3e3 100644 --- a/brainsnn-r3f-app/package.json +++ b/brainsnn-r3f-app/package.json @@ -12,7 +12,7 @@ "preview": "vite preview", "start": "node server.js", "start:dev": "npm run build && node server.js", - "test:quantum": "node --test src/utils/quantumCoherence.test.mjs" + "test:quantum": "node --test src/utils/quantumCoherence.test.mjs src/utils/bellPair.test.mjs src/utils/quantumSweep.test.mjs" }, "dependencies": { "@ffmpeg/ffmpeg": "^0.12.15", diff --git a/brainsnn-r3f-app/src/App.jsx b/brainsnn-r3f-app/src/App.jsx index 3213437..4b2f636 100644 --- a/brainsnn-r3f-app/src/App.jsx +++ b/brainsnn-r3f-app/src/App.jsx @@ -82,6 +82,9 @@ import ThemePanel from './components/ThemePanel'; import CommunityPackPanel from './components/CommunityPackPanel'; import MilestonePanel from './components/MilestonePanel'; import QuantumCoherencePanel from './components/QuantumCoherencePanel'; +import BellPairPanel from './components/BellPairPanel'; +import QuantumSweepPanel from './components/QuantumSweepPanel'; +import QuantumGlossaryPanel from './components/QuantumGlossaryPanel'; import { registerServiceWorker } from './utils/pwa'; import { registerTheme } from './utils/theme'; import DreamModePanel from './components/DreamModePanel'; @@ -802,6 +805,36 @@ export default function App() { /> + + { + markActivity(); + setState((prev) => { + const regions = { ...prev.regions }; + for (const [region, delta] of Object.entries(deltas)) { + if (regions[region] === undefined) continue; + regions[region] = Math.max(0.04, Math.min(0.95, regions[region] + delta * 0.3)); + } + return { + ...prev, + regions, + tick: (prev.tick ?? 0) + 1, + scenario: `Bell Pair (corr ${result.correlation.toFixed(2)})`, + }; + }); + toastSuccess(`Bell correlation ${result.correlation.toFixed(2)} mapped to brain`); + }} + /> + + + + + + + + + + diff --git a/brainsnn-r3f-app/src/components/BellPairPanel.jsx b/brainsnn-r3f-app/src/components/BellPairPanel.jsx new file mode 100644 index 0000000..8f325e0 --- /dev/null +++ b/brainsnn-r3f-app/src/components/BellPairPanel.jsx @@ -0,0 +1,199 @@ +import React, { useMemo, useState } from 'react'; +import { runBellPairExperiment, mapBellToBrainState } from '../utils/bellPair'; + +/** + * Layer 102 — Bell Pair Lab. + * + * Two-qubit entanglement, in-browser. Builds |Φ+⟩ = (|00⟩ + |11⟩)/√2 by + * running |00⟩ → H ⊗ I → CNOT, then rotates qubit 0 with RY(θ) so the user + * can watch correlation break smoothly. Shows joint outcomes |00⟩ |01⟩ |10⟩ + * |11⟩ as four bars, plus a signed correlation strength in [-1, 1]. + * + * Important framing: correlation here is a quantum statistical fact about + * a many-shot distribution, not "spooky action" at a distance in any + * mystical sense. No ER=EPR, no consciousness telepathy, no portals. + */ + +const SHOTS_OPTIONS = [256, 1024, 4096]; + +const BASIS_LABELS = ['|00⟩', '|01⟩', '|10⟩', '|11⟩']; +const BASIS_COLORS = ['#5ad4ff', '#fdab43', '#dd6974', '#a86fdf']; + +function fmtPercent(p) { + return `${(p * 100).toFixed(1)}%`; +} + +function explain({ correlation, rotationTheta, noise, mode }) { + const corr = correlation.toFixed(2); + if (mode === 'metaphor') { + if (correlation > 0.85) { + return `Two coins, perfectly mirrored (correlation ${corr}). Either both heads or both tails — never mixed. Metaphor: a pair of friends who finish each other's sentences.`; + } + if (correlation < -0.85) { + return `Two coins, perfectly anti-mirrored (correlation ${corr}). Always one head and one tail. Metaphor: opposites locked into balance.`; + } + if (Math.abs(correlation) < 0.15) { + return `The link snapped. Each coin lands independent of the other (correlation ${corr}). Metaphor: rotated the question hard enough that the shared answer dissolved.`; + } + return `Partial agreement (correlation ${corr}). Metaphor: the friendship is real but fading.`; + } + // scientific + if (rotationTheta === 0 && noise < 0.05) { + return `|Φ+⟩ measured in the computational basis. Outcomes are 50/50 split between |00⟩ and |11⟩, never |01⟩ or |10⟩. Correlation ${corr}: maximal classical-impossible correlation across two non-interacting qubits.`; + } + if (Math.abs(correlation) < 0.15) { + return `Rotation moved qubit 0 to a basis where the Bell state's correlations average out. Correlation ${corr}. Reading qubit 0 no longer predicts qubit 1. (No information was sent — this is the basis-mismatch lesson, not "spooky action".)`; + } + if (correlation < 0) { + return `RY(${rotationTheta.toFixed(2)}) flipped the in-basis correlation. Anti-correlated outcomes (|01⟩, |10⟩) now dominate. Correlation ${corr}.`; + } + return `Bell state with rotation ${rotationTheta.toFixed(2)} and noise ${noise.toFixed(2)}. Correlation ${corr}; noise ${noise > 0 ? 'is mixing in uniform randomness' : 'is zero'}.`; +} + +function JointBars({ distribution, counts }) { + return ( +
+ {distribution.map((p, i) => ( +
+
+ {BASIS_LABELS[i]} + {fmtPercent(p)} · {counts[i]} shots +
+
+
+
+
+ ))} +
+ ); +} + +function CircuitDiagram({ rotationTheta }) { + return ( +
+
q0 |0⟩ ──[H]──●──{rotationTheta !== 0 ? `[RY(${rotationTheta.toFixed(2)})]──` : '──────────────'}M
+
q1 |0⟩ ─────────⊕────────────────M
+
+ ); +} + +export default function BellPairPanel({ onApplyToBrain } = {}) { + const [rotationTheta, setRotationTheta] = useState(0); + const [shots, setShots] = useState(1024); + const [noise, setNoise] = useState(0); + const [mode, setMode] = useState('scientific'); + const [runToken, setRunToken] = useState(0); + + const result = useMemo(() => { + void runToken; + return runBellPairExperiment({ rotationTheta, shots, noise }); + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [rotationTheta, shots, noise, runToken]); + + const explanation = useMemo( + () => explain({ correlation: result.correlation, rotationTheta, noise, mode }), + [result.correlation, rotationTheta, noise, mode], + ); + + const brainDeltas = useMemo(() => mapBellToBrainState(result), [result]); + const corrColor = result.correlation > 0.5 ? '#5ee69a' : result.correlation < -0.5 ? '#a86fdf' : '#fdab43'; + + return ( +
+
Layer 102 · bell pair lab
+

Two qubits, one shared answer

+

+ Build the Bell state |Φ+⟩ = (|00⟩ + |11⟩)/√2 with{' '} + H ⊗ I → CNOT, then rotate qubit 0 with RY(θ) and measure + both qubits jointly. Correlation runs from +1 (perfect mirror) to −1 + (perfect opposites) to 0 (noise dissolved the link). +

+

+ This is statistical correlation across many shots, not + information transfer. No consciousness, no telepathy, no portals. +

+ +
+ + + + {onApplyToBrain && ( + + )} +
+ +
+
+
+ RY rotation θ on qubit 0 (0 → π) + {rotationTheta.toFixed(3)} +
+ setRotationTheta(parseFloat(e.target.value))} style={{ width: '100%' }} /> +
+
+
+ Depolarizing noise (0 = pure, 1 = uniform) + {noise.toFixed(2)} +
+ setNoise(parseFloat(e.target.value))} style={{ width: '100%' }} /> +
+
+ Shots: + {SHOTS_OPTIONS.map((s) => ( + + ))} +
+
+ + + + + +
+ + Correlation strength {result.correlation.toFixed(3)} + + + {result.correlation > 0.5 ? 'mirrored' : result.correlation < -0.5 ? 'anti-mirrored' : 'decohered'} + +
+ +

{explanation}

+ +
+ Region deltas (preview) +
+ {Object.entries(brainDeltas).map(([region, delta]) => ( +
+
{region}
+
0 ? '#5ee69a' : '#94a3b8' }}>{delta >= 0 ? '+' : ''}{delta.toFixed(2)}
+
+ ))} +
+
+
+ ); +} diff --git a/brainsnn-r3f-app/src/components/QuantumGlossaryPanel.jsx b/brainsnn-r3f-app/src/components/QuantumGlossaryPanel.jsx new file mode 100644 index 0000000..8ec18d1 --- /dev/null +++ b/brainsnn-r3f-app/src/components/QuantumGlossaryPanel.jsx @@ -0,0 +1,284 @@ +import React, { useMemo, useState } from 'react'; + +/** + * Layer 104 — Quantum Glossary panel. + * + * A searchable reference card for every quantum term used in the L101 – + * L103 cluster. Plain language + the math, side by side. Complements the + * Metaphor toggle in the other panels: lets a user look up an unfamiliar + * symbol without leaving the page. + * + * Nothing in here claims literal multiverse / consciousness / portal + * physics. The "metaphor" column is explicitly framed as a teaching aid. + */ + +const TERMS = [ + { + term: '|0⟩, |1⟩', + category: 'state', + plain: 'The two definite answers a single qubit can give when measured.', + math: 'Computational basis states. State vector [1, 0] and [0, 1].', + metaphor: 'Two doors. After you measure, the qubit is behind one of them.', + }, + { + term: '|+⟩, |-⟩', + category: 'state', + plain: 'Equal-strength mixtures of |0⟩ and |1⟩, with relative phase + or -.', + math: '(|0⟩ ± |1⟩) / √2.', + metaphor: 'A coin spinning. + = clockwise, - = counter-clockwise; both still 50/50 when it lands.', + }, + { + term: 'Superposition', + category: 'state', + plain: 'A qubit holding both 0 and 1 at the same time, with relative weights and a phase.', + math: 'α|0⟩ + β|1⟩ with |α|² + |β|² = 1.', + metaphor: 'A coin in flight — neither heads nor tails until something lands the question.', + }, + { + term: 'Phase (relative)', + category: 'state', + plain: 'The angle between the |0⟩ and |1⟩ amplitudes — invisible until you interfere them.', + math: 'arg(β / α). Global phase doesn’t affect probabilities.', + metaphor: 'How the coin spins. Two spins that are out of step cancel each other.', + }, + { + term: 'Amplitude', + category: 'state', + plain: 'Complex number whose squared magnitude is the probability of an outcome.', + math: 'P(state) = |amplitude|².', + metaphor: 'The strength and direction of one side of a wave.', + }, + { + term: 'Hadamard (H)', + category: 'gate', + plain: 'Turns |0⟩ into an equal superposition |+⟩ — and back.', + math: 'H = (1/√2) [[1, 1], [1, -1]]. H · H = I.', + metaphor: 'Spin the coin. Spin it again with the same flick — it lands the way it started.', + }, + { + term: 'Pauli-X', + category: 'gate', + plain: 'Bit flip — swap |0⟩ and |1⟩.', + math: 'X = [[0, 1], [1, 0]].', + metaphor: 'Pull the switch from "off" to "on".', + }, + { + term: 'Pauli-Z', + category: 'gate', + plain: 'Phase flip — multiplies |1⟩ by -1, leaves |0⟩ alone.', + math: 'Z = [[1, 0], [0, -1]].', + metaphor: 'Reverse the spin direction without changing whether it’s heads or tails.', + }, + { + term: 'RZ(θ)', + category: 'gate', + plain: 'Rotates the relative phase by an angle θ.', + math: 'RZ(θ) = diag(e^{-iθ/2}, e^{+iθ/2}).', + metaphor: 'Twist the coin’s spin axis by θ before it lands.', + }, + { + term: 'RY(θ)', + category: 'gate', + plain: 'Rotates around the Y axis — moves probability between |0⟩ and |1⟩ smoothly.', + math: 'RY(θ) = [[cos(θ/2), -sin(θ/2)], [sin(θ/2), cos(θ/2)]].', + metaphor: 'Tilt the coin: more heads or more tails depending on how far you tilt.', + }, + { + term: 'CNOT', + category: 'gate', + plain: 'Two-qubit gate: flips the target qubit only when the control is |1⟩.', + math: 'CNOT|c, t⟩ = |c, t ⊕ c⟩.', + metaphor: 'A pair of coins glued together: flipping coin A flips coin B if A landed heads.', + }, + { + term: 'Bell state |Φ+⟩', + category: 'state', + plain: 'Maximally entangled two-qubit state where both qubits always agree when measured.', + math: '(|00⟩ + |11⟩) / √2. Built by H ⊗ I → CNOT.', + metaphor: 'Two coins that always land the same way — but only because their flips were prepared together, not because one signals the other.', + }, + { + term: 'Entanglement', + category: 'state', + plain: 'A correlation between two qubits stronger than any classical pair can have.', + math: 'A pure 2-qubit state that is *not* expressible as |a⟩ ⊗ |b⟩.', + metaphor: '"Linked dice." Not telepathy — the link comes from how they were built, and it carries no information by itself.', + }, + { + term: 'Measurement', + category: 'process', + plain: 'Sample one of the basis states with probability |amplitude|². The state collapses.', + math: 'For α|0⟩ + β|1⟩: P(0) = |α|², P(1) = |β|². Post-measurement state = the basis ket you got.', + metaphor: 'The coin lands. After that, it’s heads-or-tails, not spinning.', + }, + { + term: 'Mid-circuit measurement', + category: 'process', + plain: 'Measuring partway through a circuit. Destroys interference for any later gates.', + math: 'Projects the state onto the measurement basis; the rest of the circuit acts on a classical bit.', + metaphor: 'Peeking at the spinning coin before it lands stops the spin.', + }, + { + term: 'Interference', + category: 'process', + plain: 'When two paths through a circuit reinforce or cancel based on their relative phase.', + math: 'Constructive: amplitudes add. Destructive: they cancel.', + metaphor: 'Two ripples in a pond meeting peak-to-peak (taller) or peak-to-trough (flat).', + }, + { + term: 'Decoherence', + category: 'noise', + plain: 'Loss of phase information through unwanted coupling to the environment.', + math: 'T2 dephasing damps off-diagonal density-matrix elements.', + metaphor: 'A whisper getting drowned out as a room fills up.', + }, + { + term: 'Dephasing', + category: 'noise', + plain: 'A specific decoherence channel: the relative phase randomizes while populations stay.', + math: 'Damps imaginary parts of off-diagonal amplitudes / matrix elements.', + metaphor: 'The coin keeps spinning at the same speed but its axis wobbles randomly.', + }, + { + term: 'Bit-flip channel', + category: 'noise', + plain: 'A gate misfire: with probability p, the qubit’s state is X-flipped.', + math: 'ρ → (1-p) ρ + p X ρ X.', + metaphor: 'A 1-in-N chance the switch jiggled to the wrong position.', + }, + { + term: 'Depolarizing noise', + category: 'noise', + plain: 'With probability p, replace the qubit’s state with a uniform random one.', + math: 'ρ → (1-p) ρ + p · I/2.', + metaphor: 'A small chance the coin gets snatched and replaced with a freshly-tossed one.', + }, + { + term: 'Coherence score (this app)', + category: 'metric', + plain: '0–100 summary of how much quantum-ness survived a run. Drops with noise and depth.', + math: 'See utils/quantumCoherence.js → coherenceScore().', + metaphor: 'Battery left in the qubit at the end of the experiment.', + }, + { + term: 'Correlation strength (this app)', + category: 'metric', + plain: 'Bell-pair signed correlation: +1 mirrored, 0 independent, -1 anti-mirrored.', + math: '(P(00) + P(11)) - (P(01) + P(10)).', + metaphor: 'How much the two coins agree across many tosses.', + }, + { + term: 'Shots', + category: 'metric', + plain: 'How many times you rerun the circuit and measure. More shots = smoother bars.', + math: 'Shot noise scales as 1 / √N.', + metaphor: 'How many coin tosses you average over.', + }, +]; + +const CATEGORY_LABEL = { + state: 'States', + gate: 'Gates', + process: 'Processes', + noise: 'Noise', + metric: 'Metrics', +}; + +const CATEGORY_COLOR = { + state: '#5ad4ff', + gate: '#a86fdf', + process: '#fdab43', + noise: '#dd6974', + metric: '#5ee69a', +}; + +export default function QuantumGlossaryPanel() { + const [q, setQ] = useState(''); + const [activeCategory, setActiveCategory] = useState('all'); + + const filtered = useMemo(() => { + const needle = q.trim().toLowerCase(); + return TERMS.filter((t) => { + if (activeCategory !== 'all' && t.category !== activeCategory) return false; + if (!needle) return true; + return ( + t.term.toLowerCase().includes(needle) + || t.plain.toLowerCase().includes(needle) + || t.math.toLowerCase().includes(needle) + || t.metaphor.toLowerCase().includes(needle) + ); + }); + }, [q, activeCategory]); + + const counts = useMemo(() => { + const c = { all: TERMS.length }; + for (const t of TERMS) c[t.category] = (c[t.category] || 0) + 1; + return c; + }, []); + + return ( +
+
Layer 104 · quantum glossary
+

{TERMS.length} terms used in the quantum cluster

+

+ Plain language plus the math, side by side. Includes a metaphor + column — these are explicitly framed as teaching aids, not + physics claims about consciousness, multiverses, or anything beyond + what the math says. +

+ +
+ setQ(e.target.value)} + style={{ flex: 1, minWidth: 220 }} + /> + +
+ +

+ Showing {filtered.length} of {TERMS.length} +

+ +
+ {filtered.map((t) => ( +
+
+ {t.term} +
+ {CATEGORY_LABEL[t.category]} +
+
+
+
{t.plain}
+
{t.math}
+
+ metaphor: {t.metaphor} +
+
+
+ ))} + {filtered.length === 0 &&

No matches.

} +
+
+ ); +} diff --git a/brainsnn-r3f-app/src/components/QuantumSweepPanel.jsx b/brainsnn-r3f-app/src/components/QuantumSweepPanel.jsx new file mode 100644 index 0000000..6f40b21 --- /dev/null +++ b/brainsnn-r3f-app/src/components/QuantumSweepPanel.jsx @@ -0,0 +1,193 @@ +import React, { useMemo, useState } from 'react'; +import { runSweep, rowsToCsv, sweepSummary } from '../utils/quantumSweep'; + +/** + * Layer 103 — Quantum Sweep panel. + * + * Auto-sweeps a parameter through the L101 single-qubit experiment family + * and renders a small SVG line chart of P(0) (and the ideal curve where + * one is well-defined). Lets the user download a CSV with the same column + * shape as the offline Qiskit suite at /quantum_alignment/results/. + */ + +const KINDS = [ + { id: 'phase', label: 'Phase θ ∈ [0, π]', help: 'Sweeps θ; ideal P(0) = cos²(θ/2).' }, + { id: 'noise', label: 'Noise ∈ [0, 1]', help: 'Sweeps depolarizing-style noise at fixed θ.' }, + { id: 'depth', label: 'X·X depth', help: 'Sweeps logical-identity depth; ideal P(0)=1.' }, +]; + +const SHOTS_OPTIONS = [256, 1024, 4096]; + +function csvDownload(rows, kind) { + const csv = rowsToCsv(rows); + const blob = new Blob([csv], { type: 'text/csv;charset=utf-8' }); + const url = URL.createObjectURL(blob); + const a = document.createElement('a'); + const ts = new Date().toISOString().replace(/[:.]/g, '-'); + a.href = url; + a.download = `quantum_sweep_${kind}_${ts}.csv`; + document.body.appendChild(a); + a.click(); + setTimeout(() => { + document.body.removeChild(a); + URL.revokeObjectURL(url); + }, 0); +} + +function SweepChart({ rows }) { + if (!rows.length) return null; + const W = 360; + const H = 140; + const padL = 32; + const padR = 8; + const padT = 8; + const padB = 22; + const innerW = W - padL - padR; + const innerH = H - padT - padB; + const xs = rows.map((r) => r.parameter); + const xMin = Math.min(...xs); + const xMax = Math.max(...xs); + const xSpan = xMax - xMin || 1; + const xCoord = (v) => padL + ((v - xMin) / xSpan) * innerW; + const yCoord = (p) => padT + (1 - p) * innerH; + const linePath = (key) => + rows.map((r, i) => `${i === 0 ? 'M' : 'L'} ${xCoord(r.parameter).toFixed(2)} ${yCoord(r[key]).toFixed(2)}`).join(' '); + + return ( + + {/* gridlines + axis labels */} + {[0, 0.25, 0.5, 0.75, 1].map((y) => ( + + + {y.toFixed(2)} + + ))} + {/* ideal curve, dashed */} + + {/* measured P(0) */} + + {/* measured P(1) */} + + {/* x ticks */} + {rows[0].parameterLabel} + {rows[rows.length - 1].parameterLabel} + {/* legend */} + + + P(0) measured + + P(1) + + P(0) ideal + + + ); +} + +export default function QuantumSweepPanel() { + const [kind, setKind] = useState('phase'); + const [shots, setShots] = useState(1024); + const [steps, setSteps] = useState(9); + const [noise, setNoise] = useState(0.05); + const [theta, setTheta] = useState(Math.PI / 2); + const [maxDepth, setMaxDepth] = useState(12); + const [runToken, setRunToken] = useState(0); + + const rows = useMemo(() => { + void runToken; + return runSweep({ kind, shots, steps, noise, theta, maxDepth }); + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [kind, shots, steps, noise, theta, maxDepth, runToken]); + + const summary = useMemo(() => sweepSummary(rows), [rows]); + const kindMeta = KINDS.find((k) => k.id === kind) || KINDS[0]; + + return ( +
+
Layer 103 · quantum sweep
+

Auto-sweep a parameter, download a CSV

+

+ Runs the L101 experiment across a range of parameters, plots P(0) + and P(1) against the closed-form ideal, and exports the same column + shape as the offline Qiskit suite at quantum_alignment/results/. + Compare browser-sim curves with hardware curves directly. +

+ +
+ {KINDS.map((k) => ( + + ))} + + +
+ +
+
+
+ Steps + {steps} +
+ setSteps(parseInt(e.target.value, 10))} style={{ width: '100%' }} /> +
+ {kind !== 'noise' && ( +
+
+ Noise (fixed) + {noise.toFixed(2)} +
+ setNoise(parseFloat(e.target.value))} style={{ width: '100%' }} /> +
+ )} + {kind === 'noise' && ( +
+
+ θ (fixed) — phase circuit angle + {theta.toFixed(2)} +
+ setTheta(parseFloat(e.target.value))} style={{ width: '100%' }} /> +
+ )} + {kind === 'depth' && ( +
+
+ Max X·X depth + {maxDepth} +
+ setMaxDepth(parseInt(e.target.value, 10))} style={{ width: '100%' }} /> +
+ )} +
+ Shots: + {SHOTS_OPTIONS.map((s) => ( + + ))} +
+
+ + + + {summary && ( +
+
{summary.n} rows
+
avg error {summary.avgError.toFixed(3)}
+
max error {summary.maxError.toFixed(3)}
+
P(0) range {summary.rangeP0.toFixed(3)}
+
avg coherence {summary.avgCoherence.toFixed(0)}/100
+
+ )} + +

+ {kindMeta.help} CSV columns mirror the Qiskit suite where they overlap. +

+
+ ); +} diff --git a/brainsnn-r3f-app/src/utils/bellPair.js b/brainsnn-r3f-app/src/utils/bellPair.js new file mode 100644 index 0000000..4157985 --- /dev/null +++ b/brainsnn-r3f-app/src/utils/bellPair.js @@ -0,0 +1,237 @@ +/** + * Layer 102 — Bell Pair Lab utilities + * + * Two-qubit entanglement, browser-native. Builds the Bell state + * + * |Φ+⟩ = (|00⟩ + |11⟩) / √2 + * + * by running |00⟩ → H ⊗ I → CNOT(0,1), and lets the user rotate one of the + * qubits before measurement to see correlations break / persist. + * + * Convention: a 2-qubit state is a length-4 array of complex amplitudes, + * indexed as state[2*q1 + q0] for basis ket |q1 q0⟩. Qubit 0 is the + * "right" / least-significant bit. + * + * Reuses the complex helpers from quantumCoherence.js. Single-qubit gates + * are lifted into the 2-qubit space pair-by-pair to keep allocations tiny. + */ + +import { complex, mulComplex, abs2 } from './quantumCoherence.js'; + +const SQRT1_2 = 1 / Math.SQRT2; + +// ---------- 2-qubit state helpers ------------------------------------------ + +export function zeroPair() { + return [complex(1, 0), complex(0, 0), complex(0, 0), complex(0, 0)]; +} + +function cloneState(state) { + return state.map((z) => ({ re: z.re, im: z.im })); +} + +/** + * Apply a 2x2 matrix `[[m00, m01], [m10, m11]]` (each entry complex) to one + * qubit of a 2-qubit state. `qubit` is 0 or 1; we pair indices that differ + * only in that bit and apply the matrix to each pair. + */ +function applySingleQubit(state, qubit, m00, m01, m10, m11) { + const out = cloneState(state); + const stride = 1 << qubit; + for (let i = 0; i < 4; i += 1) { + if ((i & stride) !== 0) continue; + const j = i | stride; + const a = state[i]; + const b = state[j]; + // out[i] = m00*a + m01*b + out[i] = { + re: m00.re * a.re - m00.im * a.im + m01.re * b.re - m01.im * b.im, + im: m00.re * a.im + m00.im * a.re + m01.re * b.im + m01.im * b.re, + }; + // out[j] = m10*a + m11*b + out[j] = { + re: m10.re * a.re - m10.im * a.im + m11.re * b.re - m11.im * b.im, + im: m10.re * a.im + m10.im * a.re + m11.re * b.im + m11.im * b.re, + }; + } + return out; +} + +export function applyHadamard(state, qubit) { + const h = complex(SQRT1_2, 0); + const negH = complex(-SQRT1_2, 0); + return applySingleQubit(state, qubit, h, h, h, negH); +} + +export function applyPauliX(state, qubit) { + return applySingleQubit(state, qubit, complex(0, 0), complex(1, 0), complex(1, 0), complex(0, 0)); +} + +/** + * RY(θ) = [[cos(θ/2), -sin(θ/2)], [sin(θ/2), cos(θ/2)]] — real-valued, + * which is convenient because it produces measurement-axis rotations + * that the user can see in the joint distribution. + */ +export function applyRY(state, qubit, theta) { + const c = complex(Math.cos(theta / 2), 0); + const s = complex(Math.sin(theta / 2), 0); + const negS = complex(-s.re, 0); + return applySingleQubit(state, qubit, c, negS, s, c); +} + +/** RZ on a 2-qubit state (single qubit). */ +export function applyRZQubit(state, qubit, theta) { + const half = theta / 2; + const m00 = complex(Math.cos(-half), Math.sin(-half)); + const m11 = complex(Math.cos(half), Math.sin(half)); + return applySingleQubit(state, qubit, m00, complex(0, 0), complex(0, 0), m11); +} + +/** + * CNOT — controlled-X. Flips `target` iff `control` is |1⟩. + * Implemented as a permutation of amplitudes. + */ +export function applyCNOT(state, control, target) { + if (control === target) return cloneState(state); + const out = cloneState(state); + for (let i = 0; i < 4; i += 1) { + const cBit = (i >> control) & 1; + if (cBit === 1) { + const j = i ^ (1 << target); + if (j > i) { + const tmp = out[i]; + out[i] = out[j]; + out[j] = tmp; + } + } + } + return out; +} + +// ---------- joint measurement ---------------------------------------------- + +/** + * Returns the 4-element probability vector for outcomes + * |00⟩, |01⟩, |10⟩, |11⟩ (normalized). + */ +export function jointDistribution(state) { + const probs = state.map(abs2); + const total = probs.reduce((a, v) => a + v, 0) || 1; + return probs.map((p) => p / total); +} + +/** + * Sample `shots` joint measurements; returns counts [c00, c01, c10, c11]. + */ +export function sampleJointShots(distribution, shots) { + const total = Math.max(0, Math.floor(shots) || 0); + if (!total) return [0, 0, 0, 0]; + const counts = [0, 0, 0, 0]; + // Build cumulative thresholds. + const cum = []; + let acc = 0; + for (let i = 0; i < 4; i += 1) { + acc += distribution[i] ?? 0; + cum.push(acc); + } + for (let s = 0; s < total; s += 1) { + const r = Math.random(); + for (let i = 0; i < 4; i += 1) { + if (r < cum[i]) { + counts[i] += 1; + break; + } + } + } + return counts; +} + +/** + * Probability that the two qubits agree (both 0 or both 1). + * For a pure Bell state |Φ+⟩ this is 1; rotation breaks the correlation + * smoothly, which is the lesson of the panel. + */ +export function correlationStrength(distribution) { + const agree = (distribution[0] ?? 0) + (distribution[3] ?? 0); + const disagree = (distribution[1] ?? 0) + (distribution[2] ?? 0); + return agree - disagree; // -1 (anti-correlated) … 1 (correlated) +} + +// ---------- Bell pair experiment ------------------------------------------- + +/** + * Build the Bell state, optionally rotate qubit 0 by `rotationTheta` (RY) to + * preview correlation breakdown, and measure. + * + * |00⟩ → H ⊗ I → CNOT(0, 1) → RY(theta) on qubit 0 → joint measurement. + * + * Noise model: depolarizing-style. We mix the pure-state distribution with + * the uniform distribution by weight `noise` — i.e. with probability `noise` + * we pretend the qubits got randomized. This cleanly takes correlation from + * +1 (noise=0) toward 0 (noise=1), unlike a bit-flip channel that just + * toggles between perfectly correlated and perfectly anti-correlated. + */ +export function runBellPairExperiment({ + rotationTheta = 0, + shots = 1024, + noise = 0, +} = {}) { + let state = zeroPair(); + state = applyHadamard(state, 0); + state = applyCNOT(state, 0, 1); + if (rotationTheta !== 0) { + state = applyRY(state, 0, rotationTheta); + } + + let distribution = jointDistribution(state); + const n = Math.max(0, Math.min(1, Number(noise) || 0)); + if (n > 0) { + distribution = distribution.map((p) => (1 - n) * p + n * 0.25); + } + const counts = sampleJointShots(distribution, shots); + const correlation = correlationStrength(distribution); + return { + kind: 'bell', + rotationTheta, + shots, + noise: n, + distribution, + counts, + correlation, + finalState: state, + }; +} + +// ---------- brain mapping --------------------------------------------------- + +/** + * Bell-pair brain mapping — entanglement = strong inter-region binding. + * - HPC ↑ correlation (binding two threads = associative memory) + * - PFC ↑ |correlation| (executive lock-on to a coherent answer) + * - CTX ↑ shots / 4096 (more data = more cortex) + * - AMY ↑ noise + * - THL ↑ when |rotationTheta| > 0 (relay traffic between qubits) + * - BG ↑ dominance of the lead outcome + * - CBL ↑ noise * (1 - |correlation|) (correction work when binding fails) + */ +export function mapBellToBrainState(result) { + if (!result || !result.distribution) { + return { CTX: 0, HPC: 0, THL: 0, AMY: 0, BG: 0, PFC: 0, CBL: 0 }; + } + const corr = Math.max(-1, Math.min(1, result.correlation || 0)); + const noise = Math.max(0, Math.min(1, Number(result.noise) || 0)); + const rot = Math.abs(result.rotationTheta || 0); + const shots = Math.max(1, Number(result.shots) || 1); + const lead = Math.max(...result.distribution); + const dominance = Math.max(0, lead - 0.25); // 0 = uniform, 0.75 = pure + const clamp = (v) => Math.max(-1, Math.min(1, v)); + return { + HPC: clamp(corr * 0.6), + PFC: clamp(Math.abs(corr) * 0.55), + CTX: clamp(Math.min(1, Math.log10(shots) / 4) * 0.4), + AMY: clamp(noise * 0.5), + THL: clamp(Math.min(1, rot / Math.PI) * 0.45), + BG: clamp(dominance * 0.55), + CBL: clamp(noise * (1 - Math.abs(corr)) * 0.6), + }; +} diff --git a/brainsnn-r3f-app/src/utils/bellPair.test.mjs b/brainsnn-r3f-app/src/utils/bellPair.test.mjs new file mode 100644 index 0000000..1c934db --- /dev/null +++ b/brainsnn-r3f-app/src/utils/bellPair.test.mjs @@ -0,0 +1,117 @@ +/** + * Layer 102 — Bell Pair Lab tests. + * + * Run from brainsnn-r3f-app/ with: + * node --test src/utils/bellPair.test.mjs + */ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { + zeroPair, + applyHadamard, + applyCNOT, + applyPauliX, + applyRY, + jointDistribution, + correlationStrength, + runBellPairExperiment, + mapBellToBrainState, +} from './bellPair.js'; + +test('zeroPair starts at |00>', () => { + const dist = jointDistribution(zeroPair()); + assert.ok(dist[0] > 0.999); + assert.ok(dist[1] < 0.001); + assert.ok(dist[2] < 0.001); + assert.ok(dist[3] < 0.001); +}); + +test('Hadamard on qubit 0 of |00> gives (|00>+|01>)/sqrt(2)', () => { + const state = applyHadamard(zeroPair(), 0); + const dist = jointDistribution(state); + assert.ok(Math.abs(dist[0] - 0.5) < 1e-9); + assert.ok(Math.abs(dist[1] - 0.5) < 1e-9); + assert.ok(Math.abs(dist[2]) < 1e-9); + assert.ok(Math.abs(dist[3]) < 1e-9); +}); + +test('CNOT(0,1) flips qubit 1 only when qubit 0 is 1', () => { + // |01> (qubit 0 = 1, qubit 1 = 0) -> |11> + let state = applyPauliX(zeroPair(), 0); + state = applyCNOT(state, 0, 1); + const dist = jointDistribution(state); + assert.ok(dist[3] > 0.999, `expected |11>, got ${JSON.stringify(dist)}`); +}); + +test('Bell state |Φ+> = H ⊗ I then CNOT gives 50/50 on |00> and |11>', () => { + let state = applyHadamard(zeroPair(), 0); + state = applyCNOT(state, 0, 1); + const dist = jointDistribution(state); + assert.ok(Math.abs(dist[0] - 0.5) < 1e-9); + assert.ok(Math.abs(dist[3] - 0.5) < 1e-9); + assert.ok(dist[1] < 1e-9); + assert.ok(dist[2] < 1e-9); +}); + +test('correlationStrength of Bell state is +1', () => { + let state = applyHadamard(zeroPair(), 0); + state = applyCNOT(state, 0, 1); + const dist = jointDistribution(state); + assert.ok(correlationStrength(dist) > 0.999); +}); + +test('rotation by pi/2 on Bell state breaks correlation toward 0', () => { + let state = applyHadamard(zeroPair(), 0); + state = applyCNOT(state, 0, 1); + state = applyRY(state, 0, Math.PI / 2); + const dist = jointDistribution(state); + const corr = correlationStrength(dist); + assert.ok(Math.abs(corr) < 0.05, `expected ~0 correlation after pi/2 rotation; got ${corr}`); +}); + +test('rotation by pi flips correlation to anti-correlated', () => { + let state = applyHadamard(zeroPair(), 0); + state = applyCNOT(state, 0, 1); + state = applyRY(state, 0, Math.PI); + const dist = jointDistribution(state); + // After RY(pi) on qubit 0 of (|00>+|11>)/sqrt(2): qubit 0 flips amplitude + // sign per branch — measurement now favors |10> and |01> (anti-correlated). + assert.ok(correlationStrength(dist) < -0.99, + `expected fully anti-correlated, got ${correlationStrength(dist)}`); +}); + +test('runBellPairExperiment with rotationTheta=0 noise=0 reports correlation=1', () => { + const res = runBellPairExperiment({ rotationTheta: 0, shots: 4096, noise: 0 }); + assert.equal(res.kind, 'bell'); + assert.ok(res.correlation > 0.999, `got ${res.correlation}`); + // counts should be split between [0] and [3], with [1] and [2] tiny + assert.ok(res.counts[0] + res.counts[3] === 4096); +}); + +test('runBellPairExperiment with high noise lowers correlation', () => { + const clean = runBellPairExperiment({ rotationTheta: 0, shots: 4096, noise: 0 }); + const noisy = runBellPairExperiment({ rotationTheta: 0, shots: 4096, noise: 0.9 }); + assert.ok(noisy.correlation < clean.correlation, + `noisy ${noisy.correlation} >= clean ${clean.correlation}`); +}); + +test('mapBellToBrainState: HPC rises with correlation', () => { + const correlated = mapBellToBrainState(runBellPairExperiment({ rotationTheta: 0, shots: 256, noise: 0 })); + const decorrelated = mapBellToBrainState(runBellPairExperiment({ rotationTheta: Math.PI / 2, shots: 256, noise: 0 })); + assert.ok(correlated.HPC > decorrelated.HPC, + `HPC: correlated ${correlated.HPC} should exceed decorrelated ${decorrelated.HPC}`); +}); + +test('mapBellToBrainState: AMY rises with noise', () => { + const clean = mapBellToBrainState(runBellPairExperiment({ rotationTheta: 0, shots: 256, noise: 0 })); + const noisy = mapBellToBrainState(runBellPairExperiment({ rotationTheta: 0, shots: 256, noise: 0.85 })); + assert.ok(noisy.AMY > clean.AMY); +}); + +test('all brain deltas are bounded to [-1, 1]', () => { + const res = runBellPairExperiment({ rotationTheta: Math.PI / 3, shots: 1024, noise: 0.4 }); + const deltas = mapBellToBrainState(res); + for (const [region, v] of Object.entries(deltas)) { + assert.ok(v >= -1 && v <= 1, `${region}=${v} out of range`); + } +}); diff --git a/brainsnn-r3f-app/src/utils/layerCatalog.js b/brainsnn-r3f-app/src/utils/layerCatalog.js index a4b6154..fd23169 100644 --- a/brainsnn-r3f-app/src/utils/layerCatalog.js +++ b/brainsnn-r3f-app/src/utils/layerCatalog.js @@ -108,6 +108,9 @@ export const LAYER_CATALOG = [ { id: 99, name: 'Federated Community Firewall', group: 'firewall', blurb: 'Weekly-rotated community rule pack.' }, { id: 100, name: 'Milestone Dashboard', group: 'view', blurb: '100 layers shipped — synthesis + personal stats.' }, { id: 101, name: 'Quantum Coherence Lab', group: 'experimental', blurb: 'In-browser single-qubit phase / interference / decoherence sandbox.' }, + { id: 102, name: 'Bell Pair Lab', group: 'experimental', blurb: 'Two-qubit |Φ+⟩ entanglement + RY rotation + correlation strength.' }, + { id: 103, name: 'Quantum Sweep', group: 'experimental', blurb: 'Auto-sweep θ / noise / depth, plot vs ideal, download CSV.' }, + { id: 104, name: 'Quantum Glossary', group: 'experimental', blurb: 'Searchable glossary of every quantum term used in L101–L103.' }, ]; export const LAYER_GROUPS = { diff --git a/brainsnn-r3f-app/src/utils/quantumCoherence.js b/brainsnn-r3f-app/src/utils/quantumCoherence.js index 7775d62..1ad192e 100644 --- a/brainsnn-r3f-app/src/utils/quantumCoherence.js +++ b/brainsnn-r3f-app/src/utils/quantumCoherence.js @@ -139,11 +139,17 @@ function dephase(state, factor) { ]; } -/** Bit-flip channel: with probability p, swap |0⟩ ↔ |1⟩. */ -function bitFlip(state, p) { - if (p <= 0) return state; - if (Math.random() < p) return applyX(state); - return state; +/** + * Mix the ideal [P(0), P(1)] distribution with the uniform [0.5, 0.5] by + * weight `noise`. This is a depolarizing-style channel applied at the + * distribution level, which keeps tests deterministic in expectation — + * unlike a sampled bit-flip, which produces a single ±1 trajectory. + */ +function depolarizeDistribution(distribution, noise) { + const n = Math.max(0, Math.min(1, noise)); + if (n <= 0) return distribution; + const [p0, p1] = distribution; + return [(1 - n) * p0 + n * 0.5, (1 - n) * p1 + n * 0.5]; } // ---------- experiments ----------------------------------------------------- @@ -166,13 +172,11 @@ export function runPhaseExperiment({ theta = 0, shots = 1024, noise = 0 } = {}) let state = [complex(1, 0), complex(0, 0)]; state = applyH(state); state = applyRZ(state, theta); - // Single-step dephasing between RZ and final H, parameterized by noise. - const dephaseFactor = Math.max(0, 1 - noise); - state = dephase(state, dephaseFactor); + // Dephasing between RZ and final H damps the interference fringe. + state = dephase(state, Math.max(0, 1 - noise)); state = applyH(state); - // Bit-flip readout error scales with noise. - state = bitFlip(state, noise * 0.25); - const distribution = measureDistribution(state); + // Mix in uniform at the distribution level so noise=1 → 50/50 deterministically. + const distribution = depolarizeDistribution(measureDistribution(state), noise); const counts = sampleShots(distribution, shots); return { kind: 'phase', @@ -217,9 +221,8 @@ export function runObservationExperiment({ } state = applyH(state); - state = bitFlip(state, noise * 0.25); - const distribution = measureDistribution(state); + const distribution = depolarizeDistribution(measureDistribution(state), noise); const counts = sampleShots(distribution, shots); return { kind: 'observation', @@ -245,15 +248,14 @@ export function runDecoherenceExperiment({ noise = 0, } = {}) { const pairs = Math.max(0, Math.floor(xxPairs) || 0); - let state = [complex(1, 0), complex(0, 0)]; - for (let i = 0; i < pairs; i += 1) { - state = applyX(state); - state = bitFlip(state, noise * 0.5); - state = applyX(state); - state = bitFlip(state, noise * 0.5); - state = dephase(state, Math.max(0, 1 - noise * 0.4)); - } - const distribution = measureDistribution(state); + // Pure-state algebra: X·X = I, so the ideal distribution is always [1, 0]. + // Effective depolarization compounds per pair: 1 - (1 - noise)^pairs. + // This keeps the result deterministic in expectation while still showing + // depth-driven decoherence growth. + const ideal = [1, 0]; + const perPair = Math.max(0, Math.min(1, noise)); + const effective = pairs === 0 ? perPair : 1 - Math.pow(1 - perPair, pairs); + const distribution = depolarizeDistribution(ideal, effective); const counts = sampleShots(distribution, shots); return { kind: 'decoherence', @@ -262,7 +264,6 @@ export function runDecoherenceExperiment({ noise, distribution, counts, - finalState: state, }; } diff --git a/brainsnn-r3f-app/src/utils/quantumSweep.js b/brainsnn-r3f-app/src/utils/quantumSweep.js new file mode 100644 index 0000000..acdb3f2 --- /dev/null +++ b/brainsnn-r3f-app/src/utils/quantumSweep.js @@ -0,0 +1,202 @@ +/** + * Layer 103 — Quantum Sweep + * + * Automates parameter sweeps over the L101 single-qubit experiment family + * and emits a CSV with the same column shape as the offline Qiskit suite at + * /quantum_alignment/results/results.csv. The point: a user can run a + * sweep in the browser, download the CSV, and compare it directly against + * the Qiskit ideal/noisy/real CSV for the same parameters. + * + * Three sweep kinds: + * - 'phase' — sweeps θ ∈ [0, π] for fixed noise / shots + * - 'noise' — sweeps noise ∈ [0, 1] for fixed θ / shots + * - 'depth' — sweeps X·X pair count ∈ [0, maxDepth] for fixed + * noise / shots (decoherence experiment) + * + * Pure JS, no DOM, deterministic-ish (uses Math.random for shot sampling). + */ + +import { + runPhaseExperiment, + runDecoherenceExperiment, + coherenceScore, +} from './quantumCoherence.js'; + +// ---------- sweep ----------------------------------------------------------- + +function linspace(start, stop, count) { + if (count <= 1) return [start]; + const step = (stop - start) / (count - 1); + const out = []; + for (let i = 0; i < count; i += 1) out.push(start + step * i); + return out; +} + +function rangeInts(start, stop, count) { + // inclusive, integer-snapped, evenly spaced. + if (count <= 1) return [Math.round(start)]; + const out = new Set(); + const step = (stop - start) / (count - 1); + for (let i = 0; i < count; i += 1) { + out.add(Math.max(0, Math.round(start + step * i))); + } + return Array.from(out).sort((a, b) => a - b); +} + +/** + * Run a sweep. `kind` is 'phase' | 'noise' | 'depth'. Returns an array of + * row objects. Each row carries enough context to reproduce: parameter, + * shots, noise, distribution, counts, expected probability for the ideal + * outcome where one is well-defined. + */ +export function runSweep({ + kind = 'phase', + shots = 1024, + steps = 9, + noise = 0, + theta = 0, + maxDepth = 12, +} = {}) { + const rows = []; + if (kind === 'phase') { + for (const t of linspace(0, Math.PI, steps)) { + const res = runPhaseExperiment({ theta: t, shots, noise }); + const expectedP0 = Math.cos(t / 2) ** 2; + rows.push({ + kind, + parameter: t, + parameterLabel: `θ=${t.toFixed(3)}`, + shots, + noise, + p0: res.distribution[0], + p1: res.distribution[1], + counts0: res.counts[0], + counts1: res.counts[1], + expectedP0, + error: Math.abs(res.distribution[0] - expectedP0), + coherence: coherenceScore({ noise, depth: 1, observedMidway: false }), + }); + } + return rows; + } + if (kind === 'noise') { + for (const n of linspace(0, 1, steps)) { + const res = runPhaseExperiment({ theta, shots, noise: n }); + const expectedP0 = Math.cos(theta / 2) ** 2; + rows.push({ + kind, + parameter: n, + parameterLabel: `noise=${n.toFixed(2)}`, + shots, + noise: n, + p0: res.distribution[0], + p1: res.distribution[1], + counts0: res.counts[0], + counts1: res.counts[1], + expectedP0, + error: Math.abs(res.distribution[0] - expectedP0), + coherence: coherenceScore({ noise: n, depth: 1, observedMidway: false }), + }); + } + return rows; + } + if (kind === 'depth') { + for (const d of rangeInts(0, maxDepth, steps)) { + const res = runDecoherenceExperiment({ xxPairs: d, shots, noise }); + rows.push({ + kind, + parameter: d, + parameterLabel: `xx=${d}`, + shots, + noise, + p0: res.distribution[0], + p1: res.distribution[1], + counts0: res.counts[0], + counts1: res.counts[1], + expectedP0: 1.0, + error: Math.abs(res.distribution[0] - 1.0), + coherence: coherenceScore({ noise, depth: d + 1, observedMidway: false }), + }); + } + return rows; + } + throw new Error(`Unknown sweep kind: ${kind}`); +} + +// ---------- CSV serialization ---------------------------------------------- + +/** + * CSV columns mirror the Qiskit suite's results.csv where they overlap. + * Extra columns (counts0/counts1/coherence) are appended. + */ +export const SWEEP_CSV_COLUMNS = [ + 'kind', + 'parameter', + 'parameter_label', + 'shots', + 'noise', + 'p0', + 'p1', + 'counts0', + 'counts1', + 'expected_p0', + 'error', + 'coherence_score', +]; + +function csvEscape(value) { + if (value == null) return ''; + const str = typeof value === 'number' ? String(value) : String(value); + if (/[",\n]/.test(str)) { + return `"${str.replace(/"/g, '""')}"`; + } + return str; +} + +export function rowsToCsv(rows) { + const lines = [SWEEP_CSV_COLUMNS.join(',')]; + for (const r of rows) { + lines.push([ + r.kind, + typeof r.parameter === 'number' ? r.parameter.toFixed(6) : r.parameter, + r.parameterLabel, + r.shots, + typeof r.noise === 'number' ? r.noise.toFixed(4) : r.noise, + r.p0?.toFixed(6) ?? '', + r.p1?.toFixed(6) ?? '', + r.counts0, + r.counts1, + r.expectedP0?.toFixed(6) ?? '', + r.error?.toFixed(6) ?? '', + r.coherence, + ].map(csvEscape).join(',')); + } + return lines.join('\n'); +} + +// ---------- summary stats --------------------------------------------------- + +export function sweepSummary(rows) { + if (!rows.length) return null; + let maxError = 0; + let avgError = 0; + let minP0 = Infinity; + let maxP0 = -Infinity; + let avgCoherence = 0; + for (const r of rows) { + if (r.error > maxError) maxError = r.error; + avgError += r.error; + if (r.p0 < minP0) minP0 = r.p0; + if (r.p0 > maxP0) maxP0 = r.p0; + avgCoherence += r.coherence; + } + return { + n: rows.length, + maxError: maxError, + avgError: avgError / rows.length, + minP0, + maxP0, + rangeP0: maxP0 - minP0, + avgCoherence: avgCoherence / rows.length, + }; +} diff --git a/brainsnn-r3f-app/src/utils/quantumSweep.test.mjs b/brainsnn-r3f-app/src/utils/quantumSweep.test.mjs new file mode 100644 index 0000000..9827fa9 --- /dev/null +++ b/brainsnn-r3f-app/src/utils/quantumSweep.test.mjs @@ -0,0 +1,86 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { + runSweep, + rowsToCsv, + sweepSummary, + SWEEP_CSV_COLUMNS, +} from './quantumSweep.js'; + +test('phase sweep produces `steps` rows spanning 0..pi', () => { + const rows = runSweep({ kind: 'phase', shots: 1024, steps: 5, noise: 0 }); + assert.equal(rows.length, 5); + assert.ok(Math.abs(rows[0].parameter - 0) < 1e-9); + assert.ok(Math.abs(rows[rows.length - 1].parameter - Math.PI) < 1e-9); +}); + +test('phase sweep matches cos^2(theta/2) at theta=0 and theta=pi (noise=0)', () => { + const rows = runSweep({ kind: 'phase', shots: 4096, steps: 5, noise: 0 }); + const first = rows[0]; + const last = rows[rows.length - 1]; + assert.ok(first.error < 0.05, `theta=0 error too high: ${first.error}`); + assert.ok(last.error < 0.05, `theta=pi error too high: ${last.error}`); +}); + +test('noise sweep increasing degrades coherence monotonically', () => { + const rows = runSweep({ kind: 'noise', shots: 1024, steps: 6, theta: 0 }); + for (let i = 1; i < rows.length; i += 1) { + assert.ok( + rows[i].coherence <= rows[i - 1].coherence, + `coherence not monotone: rows[${i - 1}]=${rows[i - 1].coherence} rows[${i}]=${rows[i].coherence}`, + ); + } +}); + +test('depth sweep produces integer parameters in non-decreasing order', () => { + const rows = runSweep({ kind: 'depth', shots: 1024, steps: 5, noise: 0.1, maxDepth: 12 }); + for (let i = 1; i < rows.length; i += 1) { + assert.ok(rows[i].parameter >= rows[i - 1].parameter); + assert.ok(Number.isInteger(rows[i].parameter)); + } +}); + +test('rowsToCsv emits the expected header and one line per row', () => { + const rows = runSweep({ kind: 'phase', shots: 256, steps: 3, noise: 0 }); + const csv = rowsToCsv(rows); + const lines = csv.split('\n'); + assert.equal(lines[0], SWEEP_CSV_COLUMNS.join(',')); + assert.equal(lines.length, rows.length + 1); +}); + +test('CSV cells with commas are properly escaped', () => { + // forge a row with a comma in a string field + const rows = [{ + kind: 'phase', + parameter: 0.5, + parameterLabel: 'theta=0.5,foo', + shots: 256, + noise: 0, + p0: 0.5, + p1: 0.5, + counts0: 128, + counts1: 128, + expectedP0: 0.5, + error: 0, + coherence: 100, + }]; + const csv = rowsToCsv(rows); + assert.ok(csv.includes('"theta=0.5,foo"'), + `expected quoted comma; got: ${csv}`); +}); + +test('sweepSummary computes max / avg / range', () => { + const rows = runSweep({ kind: 'phase', shots: 1024, steps: 7, noise: 0 }); + const s = sweepSummary(rows); + assert.equal(s.n, 7); + assert.ok(s.rangeP0 > 0.5, `expected wide P(0) range across phase sweep, got ${s.rangeP0}`); + assert.ok(s.maxError >= 0); +}); + +test('sweepSummary returns null on empty input', () => { + assert.equal(sweepSummary([]), null); +}); + +test('unknown sweep kind throws', () => { + assert.throws(() => runSweep({ kind: 'mystery', steps: 3 })); +});