qliff 0.0.1__tar.gz

qliff-0.0.1/Cargo.lock

@@ -0,0 +1,264 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "cc"
+version = "1.2.67"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e17dd265a7d0f31ef544e1b20e03add05d3b45b491b633b10d67145d2acc1a38"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "crossbeam-deque"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9dd111b7b7f7d55b72c0a6ae361660ee5853c9af73f70c3c2ef6858b950e2e51"
+dependencies = [
+ "crossbeam-epoch",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-epoch"
+version = "0.9.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5b82ac4a3c2ca9c3460964f020e1402edd5753411d7737aa39c3714ad1b5420e"
+dependencies = [
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-utils"
+version = "0.8.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28"
+
+[[package]]
+name = "either"
+version = "1.16.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91622ff5e7162018101f2fea40d6ebf4a78bbe5a49736a2020649edf9693679e"
+
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7778bffd85cf38175ac1f545509665d0b9b92a198ca7941f131f85f7a4f9a872"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94f6cbe86ef3bf18998d9df6e0f3fc1050a8c5efa409bf712e661a4366e010fb"
+dependencies = [
+ "once_cell",
+ "python3-dll-a",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e9f1b4c431c0bb1c8fb0a338709859eed0d030ff6daa34368d3b152a63dfdd8d"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fbc2201328f63c4710f68abdf653c89d8dbc2858b88c5d88b0ff38a75288a9da"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fca6726ad0f3da9c9de093d6f116a93c1a38e417ed73bf138472cf4064f72028"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "python3-dll-a"
+version = "0.2.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d80ba7540edb18890d444c5aa8e1f1f99b1bdf26fb26ae383135325f4a36042b"
+dependencies = [
+ "cc",
+]
+
+[[package]]
+name = "qliff"
+version = "0.0.1"
+dependencies = [
+ "pyo3",
+ "rayon",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rayon"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fb39b166781f92d482534ef4b4b1b2568f42613b53e5b6c160e24cfbfa30926d"
+dependencies = [
+ "either",
+ "rayon-core",
+]
+
+[[package]]
+name = "rayon-core"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91"
+dependencies = [
+ "crossbeam-deque",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "shlex"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"

qliff-0.0.1/Cargo.toml

@@ -0,0 +1,26 @@
+[package]
+name = "qliff"
+version = "0.0.1"
+edition = "2021"
+description = "Clifford + noisy stabilizer simulator (native core)"
+license = "MIT"
+repository = "https://github.com/plutoniumm/qliff"
+
+[lib]
+name = "_core"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.23", features = [
+  "extension-module",
+  "abi3-py311",
+  # synthesize the python3.dll import lib when cross-compiling to Windows,
+  # so no Windows Python needs to be present on the build machine.
+  "generate-import-lib",
+] }
+rayon = "1"
+
+[profile.release]
+lto = true
+codegen-units = 1
+opt-level = 3

qliff-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 plutoniumm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

qliff-0.0.1/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+include Cargo.toml
+include Cargo.lock
+recursive-include src *.rs
+recursive-include qliff/server/static *

qliff-0.0.1/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: qliff
+Version: 0.0.1
+Summary: Clifford + noisy stabilizer simulator: noise-free and noisy (importance-sampled) stabilizer simulation with a native core.
+Home-page: https://github.com/plutoniumm/qliff
+Author: plutoniumm
+Author-email: haskell-game@manav.ch
+License: MIT
+Keywords: quantum,clifford,stabilizer,simulator,noise,qec,tableau
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Provides-Extra: dev
+Requires-Dist: setuptools-rust; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Provides-Extra: bench
+Requires-Dist: stim; extra == "bench"
+Requires-Dist: pymatching; extra == "bench"
+Provides-Extra: studio
+Requires-Dist: fastapi; extra == "studio"
+Requires-Dist: uvicorn[standard]; extra == "studio"
+Requires-Dist: pymatching; extra == "studio"
+Requires-Dist: ldpc; extra == "studio"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# qliff
+
+A Clifford stabilizer simulator with support for noisy and mid-circuit measurement-based simulation.
+
+- **Clifford stab simulation** via the Aaronson–Gottesman tableau
+- **Noisy sim** via stabilizer-channel
+  decomposition `E = Σ_μ q_μ S_μ` and **stratified importance sampling**
+  ([arXiv:2512.07304](https://arxiv.org/abs/2512.07304)), "nearly as cheap as Pauli noise."
+- **Decoder-ready QEC primitives**: detectors, observables, detection-event sampling, a
+  detector error model by Pauli-frame propagation, and exporters (parity-check matrix +
+  priors, matching weights, syndrome/label tensors). These drop
+  directly into MWPM (pymatching), BP, or ML decoders.
+
+## Install
+
+```sh
+pip install qliff
+```
+
+Docs at [plutoniumm.github.io/qliff](https://plutoniumm.github.io/qliff/).
+
+## Clifford simulation
+
+```python
+from qliff import Simulator
+
+s = Simulator(2).H(0).CX(0, 1)
+s.canon()        # ['+XX', '+ZZ']
+s.peek("ZZ")     # +1
+s.measure("XX")  # (+1, False)
+
+m0, m1 = Simulator(2).H(0).CX(0, 1).M(0, 1)  # m0 == m1
+```
+
+Mid-circuit measurement and classical feedback are just Python — the simulator is stateful,
+so conditionals (teleportation, syndrome correction) need no special API:
+
+```python
+s = Simulator(3, seed=0)
+s.H(0)
+s.H(1).CX(1, 2)
+s.CX(0, 1).H(0)
+
+if s.M(1) == 1:
+    s.X(2)
+if s.M(0) == 1:
+    s.Z(2)
+
+s.peek("__X")  # +1
+```
+
+## Noise
+Build `Circuit` with gate/noise methods, then sample or estimate.
+
+`Circuit.estimate` picks the right sampler by default — plain Monte-Carlo when every channel is Pauli, otherwise
+stratified importance sampling
+
+```python
+from qliff import Circuit
+
+c = Circuit(1)
+c.H(0).DEPOLARIZE1(0, 0.1).M(0)
+c.sample(1000)
+
+c = Circuit(1)
+c.H(0).RZ(0, 0.3)
+c.estimate("X", 20000)  # ≈ cos(0.3)
+
+c = Circuit(1)
+c.X(0).AMPLITUDE_DAMP(0, 0.3)
+c.estimate("Z", 60000)  # ≈ 2p - 1
+```
+
+Force the variance strategy with `c.estimate(obs, shots, stratify=False)` (flat) or `stratify=True`
+(stratified), or drive the sampler directly: `from qliff.noise import Sampler`, then
+`Sampler(c).expect(obs, shots, stratify=True)`. Add a custom channel by subclassing
+`qliff.noise.Channel` and dropping it in with `c.noise(ch, q)`.
+
+## Quantum error correction
+
+`qliff.qec` ships code-circuit generators, so you can go straight to a logical-error-rate
+curve. Any circuit's detectors and observables are declared with `c.detector(...)` /
+`c.observable(...)`, then turned into decoder inputs:
+
+```python
+from qliff.qec import rotated_surface_code, logical_fidelity
+from pymatching import Matching
+
+c = rotated_surface_code(distance=5, rounds=5, p=0.01)
+dem = c.dem()
+
+H, priors, obs_matrix = dem.check_matrix()
+m = Matching.from_check_matrix(
+  H,
+  weights=dem.weights(),
+  faults_matrix=obs_matrix
+)
+
+dets, flips = c.detector_sampler().sample(20000)
+fidelity = logical_fidelity(m.decode_batch(dets), flips)
+```
+
+## Extending
+
+Everything you'd customize lives in Python. Add a noise channel by subclassing
+`qliff.noise.Channel` and returning its stabilizer-channel `branches`; plug in a custom
+sampler or observable; export the DEM to whatever decoder you like. The Rust core stays a thin,
+fast tableau engine.
+
+## Develop
+
+```sh
+./do develop   # build rust core
+./do test
+./do lint
+./do bench
+./do build     # all wheels (macOS/Linux/Windows, x86_64 + arm) + sdist, no upload
+./do deploy    # same build, then publish to PyPI
+
+cd docs && npm run build && npm run deploy   # docs site -> GitHub Pages
+```
+
+## License
+MIT
+
+If you are a company using this, please get a grad student to help you with issues. If you are a grad student, please feel free to email me :)

qliff-0.0.1/README.md

@@ -0,0 +1,126 @@
+# qliff
+
+A Clifford stabilizer simulator with support for noisy and mid-circuit measurement-based simulation.
+
+- **Clifford stab simulation** via the Aaronson–Gottesman tableau
+- **Noisy sim** via stabilizer-channel
+  decomposition `E = Σ_μ q_μ S_μ` and **stratified importance sampling**
+  ([arXiv:2512.07304](https://arxiv.org/abs/2512.07304)), "nearly as cheap as Pauli noise."
+- **Decoder-ready QEC primitives**: detectors, observables, detection-event sampling, a
+  detector error model by Pauli-frame propagation, and exporters (parity-check matrix +
+  priors, matching weights, syndrome/label tensors). These drop
+  directly into MWPM (pymatching), BP, or ML decoders.
+
+## Install
+
+```sh
+pip install qliff
+```
+
+Docs at [plutoniumm.github.io/qliff](https://plutoniumm.github.io/qliff/).
+
+## Clifford simulation
+
+```python
+from qliff import Simulator
+
+s = Simulator(2).H(0).CX(0, 1)
+s.canon()        # ['+XX', '+ZZ']
+s.peek("ZZ")     # +1
+s.measure("XX")  # (+1, False)
+
+m0, m1 = Simulator(2).H(0).CX(0, 1).M(0, 1)  # m0 == m1
+```
+
+Mid-circuit measurement and classical feedback are just Python — the simulator is stateful,
+so conditionals (teleportation, syndrome correction) need no special API:
+
+```python
+s = Simulator(3, seed=0)
+s.H(0)
+s.H(1).CX(1, 2)
+s.CX(0, 1).H(0)
+
+if s.M(1) == 1:
+    s.X(2)
+if s.M(0) == 1:
+    s.Z(2)
+
+s.peek("__X")  # +1
+```
+
+## Noise
+Build `Circuit` with gate/noise methods, then sample or estimate.
+
+`Circuit.estimate` picks the right sampler by default — plain Monte-Carlo when every channel is Pauli, otherwise
+stratified importance sampling
+
+```python
+from qliff import Circuit
+
+c = Circuit(1)
+c.H(0).DEPOLARIZE1(0, 0.1).M(0)
+c.sample(1000)
+
+c = Circuit(1)
+c.H(0).RZ(0, 0.3)
+c.estimate("X", 20000)  # ≈ cos(0.3)
+
+c = Circuit(1)
+c.X(0).AMPLITUDE_DAMP(0, 0.3)
+c.estimate("Z", 60000)  # ≈ 2p - 1
+```
+
+Force the variance strategy with `c.estimate(obs, shots, stratify=False)` (flat) or `stratify=True`
+(stratified), or drive the sampler directly: `from qliff.noise import Sampler`, then
+`Sampler(c).expect(obs, shots, stratify=True)`. Add a custom channel by subclassing
+`qliff.noise.Channel` and dropping it in with `c.noise(ch, q)`.
+
+## Quantum error correction
+
+`qliff.qec` ships code-circuit generators, so you can go straight to a logical-error-rate
+curve. Any circuit's detectors and observables are declared with `c.detector(...)` /
+`c.observable(...)`, then turned into decoder inputs:
+
+```python
+from qliff.qec import rotated_surface_code, logical_fidelity
+from pymatching import Matching
+
+c = rotated_surface_code(distance=5, rounds=5, p=0.01)
+dem = c.dem()
+
+H, priors, obs_matrix = dem.check_matrix()
+m = Matching.from_check_matrix(
+  H,
+  weights=dem.weights(),
+  faults_matrix=obs_matrix
+)
+
+dets, flips = c.detector_sampler().sample(20000)
+fidelity = logical_fidelity(m.decode_batch(dets), flips)
+```
+
+## Extending
+
+Everything you'd customize lives in Python. Add a noise channel by subclassing
+`qliff.noise.Channel` and returning its stabilizer-channel `branches`; plug in a custom
+sampler or observable; export the DEM to whatever decoder you like. The Rust core stays a thin,
+fast tableau engine.
+
+## Develop
+
+```sh
+./do develop   # build rust core
+./do test
+./do lint
+./do bench
+./do build     # all wheels (macOS/Linux/Windows, x86_64 + arm) + sdist, no upload
+./do deploy    # same build, then publish to PyPI
+
+cd docs && npm run build && npm run deploy   # docs site -> GitHub Pages
+```
+
+## License
+MIT
+
+If you are a company using this, please get a grad student to help you with issues. If you are a grad student, please feel free to email me :)

qliff-0.0.1/qliff/__init__.py

@@ -0,0 +1,18 @@
+from . import noise, qec
+from ._core import ColTableau, __version__
+from .circuit import Circuit
+from .metrics import expectation, fidelity
+from .pauli import PauliString
+from .simulator import Simulator
+
+__all__ = [
+    "__version__",
+    "ColTableau",
+    "Simulator",
+    "PauliString",
+    "Circuit",
+    "expectation",
+    "fidelity",
+    "noise",
+    "qec",
+]

qliff-0.0.1/qliff/__main__.py

@@ -0,0 +1,3 @@
+from .server.cli import main
+
+main()

qliff-0.0.1/qliff/_types.py

@@ -0,0 +1,6 @@
+Bits = list[int]  # per-qubit 0/1 vector
+Signed = tuple[int, Bits, Bits]  # (sign in {0, 1}, x bits, z bits)
+Targets = tuple[int, ...]  # qubit indices an op acts on
+Op = tuple[str, Targets]  # (gate name, target qubits)
+Branch = tuple[float, list[Op]]  # (weight, ops) -- one stabilizer-channel branch
+Instruction = tuple[str, Targets, object]  # (name, targets, arg) in a Circuit