Metadata-Version: 2.4
Name: benchmark-qc
Version: 0.1.0
Summary: Benchmark QC Hamiltonians (N2, FeS, U2)
Author: Benchmark-QC contributors
License: BSD-3-Clause
Project-URL: homepage, https://github.com/asthanalab/BenchmarkQC
Keywords: quantum chemistry,hamiltonian,benchmark,pennylane,pyscf
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: pennylane
Requires-Dist: pyscf
Requires-Dist: basis_set_exchange

# Benchmark-QC

[![Docs](https://img.shields.io/badge/docs-README-blue)](docs/README.md)

Benchmark qubit Hamiltonians for N2, FeS, and U2.


This repo stores pre-generated Hamiltonians in `.npz` files (one per system) and provides:
- A small Python package (`benchmark_qc/`) with shared utilities
- Backwards-compatible notebook wrappers in each system folder
- Simple test scripts that validate the saved Hamiltonians

## Documentation

Start here: [docs/README.md](docs/README.md)

## Install (recommended)

Editable install so notebooks/scripts can import the package from any folder:

- `pip install -e .`

If you prefer conda, see [docs/USAGE.md](docs/USAGE.md) for the `bench` environment setup.

## Run Hamiltonian sanity checks

From the repo root:

- `python N2/test_n2_hamiltonian.py --index 0`
- `python FeS/test_fes_hamiltonian.py --index 0`
- `python U2/test_u2_hamiltonian.py --index 0`

## Notes

- FeS is open-shell/high-spin. The FeS test restricts diagonalization to the same `(N_alpha, N_beta)` sector as the stored CASCI reference (see [docs/USAGE.md](docs/USAGE.md)).
- The saved `.npz` files include a `labels` array (bond lengths). The exact per-system grids are listed in [docs/USAGE.md](docs/USAGE.md) under “Stored geometry points (bond lengths)”.
