Metadata-Version: 2.4
Name: qig-bench
Version: 0.1.0
Summary: Validation harness for QIG compute backends — benchmark against frozen physics results
Project-URL: Homepage, https://github.com/GaryOcean428/qig-bench
Project-URL: Repository, https://github.com/GaryOcean428/qig-bench
Author-email: Braden Lang <braden@garyocean.com>
License: MIT
Keywords: benchmarking,physics,qig,quantum,validation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.10
Requires-Dist: numpy>=1.24
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: qig-warp>=0.4.0; extra == 'full'
Requires-Dist: scipy>=1.10; extra == 'full'
Description-Content-Type: text/markdown

# qig-bench

Validation harness for QIG compute backends — benchmark against frozen physics results.

## Install

```bash
pip install qig-bench
```

## Usage

```python
from qig_bench import run_suite
from qig_bench.compare import compare

results = run_suite(backend="my-backend", verification_root="path/to/qig-verification")
table = compare({"my-backend": results})
print(table)
```

## Core 5 Benchmarks

| # | Benchmark | Frozen Value | Tolerance |
|---|---|---|---|
| 1 | Constitutive κ at L=4 | 63.32 | ±5% |
| 2 | Screening ξ_G at L=5 | 0.6182 | ±2% |
| 3 | Anderson α | 0.089/site | ±5% |
| 4 | Bridge exponent | 0.86 | ±10% |
| 5 | Regime h_t | 0.1055 | ±5% |
