Metadata-Version: 2.4
Name: qig-compute
Version: 0.1.0a1
Summary: Fast compute engine for QIG geometry — analytical QFI, GPU contractions, observable governance
Project-URL: Homepage, https://github.com/GaryOcean428/qig-compute
Project-URL: Repository, https://github.com/GaryOcean428/qig-compute
Author-email: Braden Lang <braden@garyocean.com>
License: MIT
Keywords: fisher-information,gpu,qig,quantum,tensor-network
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: cupy-cuda12x; extra == 'full'
Requires-Dist: physics-tenpy>=1.0; extra == 'full'
Requires-Dist: scipy>=1.10; extra == 'full'
Provides-Extra: gpu
Requires-Dist: cupy-cuda12x; extra == 'gpu'
Provides-Extra: tenpy
Requires-Dist: physics-tenpy>=1.0; extra == 'tenpy'
Description-Content-Type: text/markdown

# qig-compute

Fast compute engine for QIG geometry — analytical QFI, GPU contractions, observable governance.

## Install

```bash
pip install qig-compute              # numpy only
pip install qig-compute[tenpy]       # + TeNPy for MPS-QFI
pip install qig-compute[gpu]         # + CuPy for GPU acceleration
pip install qig-compute[full]        # everything
```

## Usage

```python
from qig_compute.qfi_analytical import qfi_analytical, qfi_with_governance

# Compute QFI from a single MPS ground state (zero DMRG loops)
F = qfi_analytical(psi_mps, L=6, sites=pruned_sites)

# With governance checks (warns about blindspots, auto-fills cheap measurements)
F, report = qfi_with_governance(psi_mps, L=6, h=1.0, J=1.0)
print(report.summary())
```

## Observable Governance

Built-in blindspot detection warns when:
- Results only tested in one regime
- Observable amplitude collapses (wrong channel)
- FFT frequency at resolution floor
- DMRG bond dimension at limit
- Energy gap not measured (auto-fills if cheap)
