# QPC-MCGS (Multi-Contexture Gauge-Sector)

Gauge-sector motivated extension of the Joint Structure Challenge, motivated by Gyawali et al. [arXiv:2410.06557](https://arxiv.org/abs/2410.06557).

## Four points

| Point | Script | Output |
|-------|--------|--------|
| 1 + 4 (ED) | `gauge_patch_ed.py` | `results/mcgs_point1_point4_ed.json` |
| 2 + 3 (Aer/IBM) | `mcgs_icc_runner.py` | `results/mcgs_aer_sweep.json`, `results/mcgs_icc_ibm_fez.json` |
| Bundle | `mcgs_bundle.py` | `results/qpc_mcgs_bundle.json` |

## Quick start

```bash
cd site_release_2025_11_15
.venv/bin/python3 vendor_benchmarks/qpc_mcgs/mcgs_icc_runner.py --mode ed
.venv/bin/python3 vendor_benchmarks/qpc_mcgs/mcgs_icc_runner.py --mode aer-sweep
.venv/bin/python3 vendor_benchmarks/qpc_mcgs/mcgs_icc_runner.py --mode ibm --backend ibm_fez
.venv/bin/python3 vendor_benchmarks/qpc_mcgs/mcgs_bundle.py
```

Pre-registration: `docs/QPC_MCGS_PREREGISTRATION.md`  
MCQST outreach draft: `docs/QPC_MCGS_MCQST_OUTREACH.md`