quchip documentation

quchip documentation

Model quantum devices in Python. Declare devices, couplings, controls, and losses, then calculate spectra, simulate pulses, or fit parameters.

Install

Python 3.11 or newer is required.

python -m pip install quchip

See installation for optional backends and integrations.

Your first calculation

Couple a transmon to a resonator and read their dressed frequencies. Frequencies and couplings are in GHz. This model uses the rotating-wave approximation.

from quchip import RWA, Capacitive, Chip, DuffingTransmon, Resonator

q = DuffingTransmon(freq=5.0, anharmonicity=-0.25, levels=4, label="q")
r = Resonator(freq=7.0, levels=5, label="r")
chip = Chip(
    [q, r], [Capacitive(q, r, g=0.05, label="qr")], approximation=RWA()
)

print(f"Qubit: {chip.freq(q):.6f} GHz")
print(f"Resonator: {chip.freq(r):.6f} GHz")

Qubit: 4.998751 GHz
Resonator: 7.001249 GHz

The coupling shifts each frequency from its bare value. Continue with your first chip to inspect the Hamiltonian and change a parameter.

What would you like to calculate?

Spectra and interactionsSweep parameters and follow dressed states.→ Pulses, leakage, and readoutSchedule drives, compare leakage, and read observables.→ Readout and fridge wiringCalculate microwave response and receiver noise.→ Gradients and parameter fittingDifferentiate observables and infer model parameters.→

Browse all guides or find the API and physics conventions. The focused studies examine specific physical questions, and the cookbook collects practical tips.