qickodes 0.1.5

QCoDeS driver for QICK

QICKoDeS

A QCoDeS driver for QICK. Usable but still under active development. Pull requests are welcome!

Supports Python 3.9+

Development goals

• This should be a thin wrapper that directly exposes all features of QICK.
• Pulses ("instructions") and pulse sequences ("protocols") should be parameterized such that they can be fully reproduced based on the QCoDeS snapshot that gets saved with every dataset.

Status between tProc v1 and v2

Currently, tProc v1 is under maintenance mode where only bug fixes will be implemented. tProc v2 is what you should be using.

At some point, tProc v1 will be deprecated. If you find some bugs, please do report them in the issue tracker.

Getting started

1. Clone or copy this repository to a local PC.
2. pip install -e path\to\repository
3. Start the Pyro4 nameserver (see here, use port 8888) and the QICK server (see here) on a Xilinx board.
4. Check the connection and the channel number assignment:

   from qickodes import QickInstrument
   qick_instrument = QickInstrument("ip.address.of.board")
   print(qick_instrument.soccfg)
   

5. Copy the scripts in the folder example_scripts into your folder.
6. Edit header.py:
   • Specify the IP address of the board by editing the line like

     qick_instrument = QickInstrument("ip.address.of.board")
     

   • Specify DAC/ADC channel numbers by editing the lines like

     readout_dac = qick_instrument.dacs[channel_number]
     

7. Run the example scripts:
   • meas_s21_vs_adc_trig_offset.py: Optimize the ADC trigger offset
   • meas_resonator.py: Measure S21 vs frequency
   • meas_punchout.py: Measure S21 vs frequency and amplitude
   • meas_pulse_probe_2d.py: Pulse probe spectroscopy of a qubit dispersively coupled to a resonator
   • meas_pi_pulse_gain_sweep.py: Optimize the amplitude of a pi pulse (play 10 pi pulses and readout)
   • meas_resonator_vs_qubit_state.py: Measure resonator spectra with the qubit in the ground and excited states
   • meas_t1.py: Measure the T1 of the qubit

Citing

QICKoDeS is the work of Yoshiki Sunada, Ashish Panigrahi and Jonatan Albanese.

If you use QICKoDeS in your research, please cite it via its DOI:

Sunada, Y., Panigrahi, A., & Albanese, J. QICKoDeS: A QCoDeS driver for QICK. Zenodo: https://doi.org/10.5281/zenodo.21066164

BibTeX entry:

@software{qickodes,
author = {Sunada, Yoshiki and Panigrahi, Ashish and Albanese, Jonatan},
title = {{QICKoDeS}: A {QCoDeS} driver for {QICK}},
doi = {10.5281/zenodo.21066164},
title = {{qickodes}},
url = {https://doi.org/10.5281/zenodo.21066164},
year = {2026},
}