Python

Python bindings for qirc, a compiler and state vector simulator for QIR, the LLVM based intermediate representation used by Q#, PyQIR and other quantum toolchains.

pip install qirc

import qirc

source = open("bell.ll").read()

qasm = qirc.compile(source, emit="qasm3", opt=3, gates="rz-sx-cx", coupling="line:4")
counts = qirc.run(source, shots=1000, seed=7)
verdict = qirc.diff(source, opt=3, gates="rz-sx-cx", resynth=4)
report = qirc.cost(source, gates="rz-sx-cx")
energy = qirc.expectation(source, "Z0 Z1 + 0.5 X0")

compile returns the emitted text for any emit kind: qir, qasm3, qasm2, stim, json, ir, circuit, quantikz, svg, cost, check or run. run returns the measurement counts as a dictionary. diff compares the compiled program, or a second program, with the original at -O0 branch by branch and returns "equivalent", "different" or "inconclusive". cost returns the T count, two qubit gates, gates, depth and peak live qubits for every path and for the worst case. expectation returns the exact expectation value of a sum of Pauli strings on the final state, or with a calibration the noisy value averaged over shots when noisy=True, or the zero noise extrapolation when zne=True.

Every function takes the same compiler options as keywords: opt (0 to 3), gates, exclude, resynth, cost, coupling, calibration, epsilon and budget with the values the command line accepts, relabel=True, reuse=True, noisy=True or dd=True, and bind, a dictionary of values for a program’s OpenQASM 3 input declarations, as in qirc.expectation(source, "Z0 Z1", bind={"theta": 0.3}). compile(source, emit="resources") returns a fault tolerant resource estimate. The package ships type stubs, so editors complete every function and keyword. A program that does not compile raises qirc.CompileError with the rendered diagnostics, and warnings are reported through the warnings module.