qpol 0.1.0

QPOL — a hardware-aware simulation, mapping, and analog layer for QuTiP.

qpol

QPOL (Quantum Physical Operations Language) — a hardware-aware simulation, mapping, and analog layer for QuTiP.

QPOL is a low-level, topology-aware intermediate representation and execution API that bridges ideal quantum computations and real-world physical deployment. It maps digital circuits and continuous analog field schedules down to QuTiP time-dependent Hamiltonians to assess true physical state evolution.

⚠️ This project is in the proposal/planning stage — the API surface described in docs/plan.md is planned, not yet implemented.

Installation

pip install qpol

Development

Uses uv for Python and dependency management; uv.lock is canonical and CI runs with UV_FROZEN=true.

uv sync
pre-commit install

uv run pytest               # tests with 100% coverage gate
uv run ruff check           # lint
uv run ruff format --check  # format check
uv run ty check src/        # type check
uv run zensical serve       # live-preview the docs

Docs are authored in docs/ (Markdown) and built with Zensical; docs.yml deploys them to GitHub Pages on every push to main.

License

Apache License 2.0. See LICENSE.