Scqubits: a Python package for superconducting qubits

Peter Groszkowski1 and Jens Koch2

1Pritzker School for Molecular Engineering, University of Chicago, 5640 South Ellis Avenue, Chicago, IL 60637, USA
2Department of Physics and Astronomy, Northwestern University, Evanston, IL 60208, USA

Find this paper interesting or want to discuss? Scite or leave a comment on SciRate.


$\textbf{scqubits}$ is an open-source Python package for simulating and analyzing superconducting circuits. It provides convenient routines to obtain energy spectra of common superconducting qubits, such as the transmon, fluxonium, flux, cos(2$\phi$) and the 0-$\pi$ qubit. $\textbf{scqubits}$ also features a number of options for visualizing the computed spectral data, including plots of energy levels as a function of external parameters, display of matrix elements of various operators as well as means to easily plot qubit wavefunctions. Many of these tools are not limited to single qubits, but extend to composite Hilbert spaces consisting of coupled superconducting qubits and harmonic (or weakly anharmonic) modes. The library provides an extensive suite of methods for estimating qubit coherence times due to a variety of commonly considered noise channels. While all functionality of $\textbf{scqubits}$ can be accessed programatically, the package also implements GUI-like widgets that, with a few clicks can help users both create relevant Python objects, as well as explore their properties through various plots. When applicable, the library harnesses the computing power of multiple cores via multiprocessing. $\textbf{scqubits}$ further exposes a direct interface to the Quantum Toolbox in Python (QuTiP) package, allowing the user to efficiently leverage QuTiP's proven capabilities for simulating time evolution.

In this article, we introduce an open-source Python package called $\textbf{scqubits}$, which can be used for modeling and analyzing superconducting circuits. The library provides convenient routines to obtain and explore the energy spectra of many common superconducting qubits, display matrix elements of various operators as well as easily plot qubit wavefunctions. Many of these tools are not limited to single qubits, but extend to composite Hilbert spaces consisting of coupled superconducting qubits and harmonic (or weakly anharmonic) modes. The library also includes an extensive suite of methods for estimating qubit coherence times due to a variety of commonly considered noise channels. Through a set of carefully chosen examples, this article outlines many of the key features of $\textbf{scqubits}$, as well as shows how the package can be use used by both advanced users who perform active research, as well as by students, who may be new to the field.

► BibTeX data

► References

[1] The up-to-date API documentation can be found online. URL https:/​/​​en/​latest/​api-doc/​apidoc.html.

[2] The full documentation for scqubits is located at the following address. URL https:/​/​​en/​latest.

[3] Alexandre Blais, Ren-Shou Huang, Andreas Wallraff, S. M. Girvin, and R. J. Schoelkopf. Cavity quantum electrodynamics for superconducting electrical circuits: An architecture for quantum computation. Phys. Rev. A, 69: 62320, 2004. 10.1103/​PhysRevA.69.062320.

[4] Alexandre Blais, Arne L. Grimsmo, S. M. Girvin, and Andreas Wallraff. Circuit quantum electrodynamics. Rev. Mod. Phys., 93: 025005, 2021. 10.1103/​RevModPhys.93.025005.

[5] Peter Brooks, Alexei Kitaev, and John Preskill. Protected gates for superconducting qubits. Phys. Rev. A, 87: 52306, 2013. 10.1103/​PhysRevA.87.052306.

[6] Guido Burkard, Roger H Koch, and D. P. DiVincenzo. Multilevel quantum description of decoherence in superconducting qubits. Phys. Rev. B, 69: 64503, 2004. 10.1103/​PhysRevB.69.064503.

[7] John Clarke and F. K. Wilhelm. Superconducting quantum bits. Nature, 453: 1031–1042, 2008. 10.1038/​nature07128.

[8] Joshua M. Dempster, Bo Fu, David G. Ferguson, D. I. Schuster, and Jens Koch. Understanding degenerate ground states of a protected quantum circuit in the presence of disorder. Phys. Rev. B, 90: 94518, 2014. 10.1103/​PhysRevB.90.094518.

[9] M. H. Devoret. Quantum fluctuations in electrical circuits. In S Reynaud, E Giacobino, and J Zinn-Justin, editors, Quantum Fluctuations, Les Houches, Session LXIII, chapter 10. Elsevier Science, 1995.

[10] M. H. Devoret and J. M. Martinis. Implementing qubits with superconducting integrated circuits. Quantum Inf. Process., 3: 163–203, 2004. 10.1007/​s11128-004-3101-5.

[11] Peter Groszkowski, A. Di Paolo, A. L. Grimsmo, A. Blais, D. I. Schuster, A. A. Houck, and Jens Koch. Coherence properties of the 0-pi qubit. New J. Phys., 20: 043053, 2018. 10.1088/​1367-2630/​aab7cd.

[12] G. Ithier, E. Collin, P. Joyez, P. J. Meeson, D. Vion, D. Esteve, F. Chiarello, A. Shnirman, Y. Makhlin, J. Schriefl, and G. Schon. Decoherence in a superconducting quantum bit circuit. Phys. Rev. B, 72: 134519, 2005a. 10.1103/​PhysRevB.72.134519.

[13] G. Ithier, E. Collin, P. Joyez, P J Meeson, D. Vion, D. Esteve, F. Chiarello, A. Shnirman, Y. Makhlin, J. Schriefl, and G. Schön. Decoherence in a superconducting quantum bit circuit. Phys. Rev. B, 72: 134519, 2005b. 10.1103/​PhysRevB.72.134519.

[14] J. R. Johansson, P. D. Nation, and Franco Nori. QuTiP: An open-source Python framework for the dynamics of open quantum systems. Comput. Phys. Commun., 183: 1760–1772, 2012. 10.1016/​j.cpc.2012.02.021.

[15] J. R. Johansson, P. D. Nation, and Franco Nori. QuTiP 2: A Python framework for the dynamics of open quantum systems. Comput. Phys. Commun., 184: 1234–1240, 2013. 10.1016/​j.cpc.2012.11.019.

[16] Jens Koch, Terri M Yu, J. M. Gambetta, A. A. Houck, D. I. Schuster, J. Majer, Alexandre Blais, M. H. Devoret, S. M. Girvin, and R. J. Schoelkopf. Charge-insensitive qubit design derived from the Cooper pair box. Phys. Rev. A, 76: 42319, 2007. 10.1103/​PhysRevA.76.042319.

[17] P. Krantz, M. Kjaergaard, F. Yan, T. P. Orlando, S. Gustavsson, and W. D. Oliver. A quantum engineer's guide to superconducting qubits. Appl. Phys. Rev., 6: 021318, 2019. 10.1063/​1.5089550.

[18] V. E. Manucharyan, Jens Koch, L. I. Glazman, and M. H. Devoret. Fluxonium: Single Cooper-Pair Circuit Free of Charge Offsets. Science, 326: 113–116, 2009. 10.1126/​science.1175552.

[19] J. E. Mooij, T. P. Orlando, L. Levitov, Lin Tian, Caspar H. C.H. H Van der Wal, and Seth Lloyd. Josephson persistent-current qubit. Science, 285 (5430): 1036, 1999. 10.1126/​science.285.5430.1036.

[20] Y. Nakamura, Yu. A. Pashkin, and J. S. Tsai. Coherent control of macroscopic quantum states in a single-Cooper-pair box. Nature, 398: 786–788, 1999. 10.1038/​19718.

[21] T. P. Orlando, J. E. Mooij, Lin Tian, Caspar H. Van Der Wal, L. S. Levitov, Seth Lloyd, and J. J. Mazo. Superconducting persistent-current qubit. Phys. Rev. B, 60: 15398, 1999. 10.1103/​PhysRevB.60.15398.

[22] Ioan M. Pop, Kurtis Geerlings, G. Catelani, Robert J. Schoelkopf, L. I. Glazman, and M. H. Devoret. Coherent suppression of electromagnetic dissipation due to superconducting quasiparticles. Nature, 508 (7496): 369–72, 2014. 10.1038/​nature13017.

[23] R. J. Schoelkopf, A. A. Clerk, S. M. Girvin, K. W. Lehnert, and M. H. Devoret. Qubits as Spectrometers of Quantum Noise. 5115: 1–31, 2002. 10.1007/​978-94-010-0089-5_9.

[24] W. C. Smith, A. Kou, X. Xiao, U. Vool, and M. H. Devoret. Superconducting circuit protected by two-Cooper-pair tunneling. npj Quantum Inf., 6: 1–9, 2020. 10.1038/​s41534-019-0231-2.

[25] Uri Vool and Michel Devoret. Introduction to quantum electromagnetic circuits. Int. J. Circuit Theory Appl., 45: 897–934, 2017. 10.1002/​cta.2359.

[26] A. Wallraff, D. I. Schuster, Alexandre Blais, L. Frunzio, R. S. Huang, J. Majer, S. Kumar, S. M. Girvin, and R. J. Schoelkopf. Strong coupling of a single photon to a superconducting qubit using circuit quantum electrodynamics. Nature, 431: 162–167, 2004. 10.1038/​nature02851.

[27] J. Q. You and Franco Nori. Superconducting circuits and quantum information. Phys. Today, 58: 42–47, 2005. 10.1063/​1.2155757.

Cited by

[1] Taha Rajabzadeh, Zhaoyou Wang, Nathan Lee, Takuma Makihara, Yudan Guo, and Amir H. Safavi-Naeini, "Analysis of arbitrary superconducting quantum circuits accompanied by a Python package: SQcircuit", Quantum 7, 1118 (2023).

[2] Ferris Prima Nugraha and Qiming Shao, 2023 IEEE International Conference on Quantum Computing and Engineering (QCE) 1360 (2023) ISBN:979-8-3503-4323-6.

[3] Adrian Copetudo, Clara Yun Fontaine, Fernando Valadares, and Yvonne Y. Gao, "Shaping photons: Quantum information processing with bosonic cQED", Applied Physics Letters 124 8, 080502 (2024).

[4] Mahadevan Subramanian and Adrian Lupascu, "Efficient two-qutrit gates in superconducting circuits using parametric coupling", Physical Review A 108 6, 062616 (2023).

[5] J. Wills, G. Campanaro, S. Cao, S.D. Fasciati, P.J. Leek, and B. Vlastakis, "Spatial Charge Sensitivity in a Multimode Superconducting Qubit", Physical Review Applied 17 2, 024058 (2022).

[6] Sourav Majumder, Tanmoy Bera, Ramya Suresh, and Vibhor Singh, "A Fast Tunable 3D-Transmon Architecture for Superconducting Qubit-Based Hybrid Devices", Journal of Low Temperature Physics 207 3-4, 210 (2022).

[7] Samuel Stein, Sara Sussman, Teague Tomesh, Charles Guinn, Esin Tureci, Sophia Fuhui Lin, Wei Tang, James Ang, Srivatsan Chakram, Ang Li, Margaret Martonosi, Fred Chong, Andrew A. Houck, Isaac L. Chuang, and Michael Demarco, 56th Annual IEEE/ACM International Symposium on Microarchitecture 539 (2023) ISBN:9798400703294.

[8] Andrew Guthrie, Christoforus Dimas Satrya, Yu-Cheng Chang, Paul Menczel, Franco Nori, and Jukka P. Pekola, "Cooper-Pair Box Coupled to Two Resonators: An Architecture for a Quantum Refrigerator", Physical Review Applied 17 6, 064022 (2022).

[9] Nathan Shammah, Anurag Saha Roy, Carmen G. Almudever, Sébastien Bourdeauducq, Anastasiia Butko, Gustavo Cancelo, Susan M. Clark, Johannes Heinsoo, Loïc Henriet, Gang Huang, Christophe Jurczak, Janne Kotilahti, Alessandro Landra, Ryan LaRose, Andrea Mari, Kasra Nowrouzi, Caspar Ockeloen-Korppi, Guen Prawiroatmodjo, Irfan Siddiqi, and William J. Zeng, "Open hardware solutions in quantum technology", APL Quantum 1 1, 011501 (2024).

[10] F. Setiawan, Peter Groszkowski, and Aashish A. Clerk, "Fast and Robust Geometric Two-Qubit Gates for Superconducting Qubits and beyond", Physical Review Applied 19 3, 034071 (2023).

[11] Yunwei Lu, Sandeep Joshi, Vinh San Dinh, and Jens Koch, "Optimal control of large quantum systems: assessing memory and runtime performance of GRAPE", Journal of Physics Communications 8 2, 025002 (2024).

[12] Sai Pavan Chitta, Tianpu Zhao, Ziwen Huang, Ian Mondragon-Shem, and Jens Koch, "Computer-aided quantization and numerical analysis of superconducting circuits", New Journal of Physics 24 10, 103020 (2022).

[13] Helin Zhang, Chunyang Ding, D.K. Weiss, Ziwen Huang, Yuwei Ma, Charles Guinn, Sara Sussman, Sai Pavan Chitta, Danyang Chen, Andrew A. Houck, Jens Koch, and David I. Schuster, "Tunable Inductive Coupler for High-Fidelity Gates Between Fluxonium Qubits", PRX Quantum 5 2, 020326 (2024).

[14] Shuxiang Cao, Mustafa Bakr, Giulio Campanaro, Simone D Fasciati, James Wills, Deep Lall, Boris Shteynas, Vivek Chidambaram, Ivan Rungger, and Peter Leek, "Emulating two qubits with a four-level transmon qudit for variational quantum algorithms", Quantum Science and Technology 9 3, 035003 (2024).

[15] A. Miano, V.R. Joshi, G. Liu, W. Dai, P.D. Parakh, L. Frunzio, and M.H. Devoret, "Hamiltonian Extrema of an Arbitrary Flux-Biased Josephson Circuit", PRX Quantum 4 3, 030324 (2023).

[16] Bryan T. Gard, Zachary Parrott, Kurt Jacobs, José Aumentado, and Raymond W. Simmonds, "Fast high-fidelity quantum nondemolition readout of a superconducting qubit with tunable transverse couplings", Physical Review Applied 21 2, 024008 (2024).

[17] Boxi Li, Shahnawaz Ahmed, Sidhant Saraogi, Neill Lambert, Franco Nori, Alexander Pitchford, and Nathan Shammah, "Pulse-level noisy quantum circuits with QuTiP", Quantum 6, 630 (2022).

[18] Leonid V. Abdurakhimov, Imran Mahboob, Hiraku Toida, Kosuke Kakuyanagi, Yuichiro Matsuzaki, and Shiro Saito, "Identification of Different Types of High-Frequency Defects in Superconducting Qubits", PRX Quantum 3 4, 040332 (2022).

[19] Jacob Bryon, D.K. Weiss, Xinyuan You, Sara Sussman, Xanthe Croot, Ziwen Huang, Jens Koch, and Andrew A. Houck, "Time-Dependent Magnetic Flux in Devices for Circuit Quantum Electrodynamics", Physical Review Applied 19 3, 034031 (2023).

[20] Alex Tritt, Joshua Morris, Joel Hochstetter, R.P. Anderson, James Saunderson, and L.D. Turner, "Spinsim: A GPU optimized python package for simulating spin-half and spin-one quantum systems", Computer Physics Communications 287, 108701 (2023).

[21] Philipp Aumann, Tim Menke, William D Oliver, and Wolfgang Lechner, "CircuitQ: an open-source toolbox for superconducting circuits", New Journal of Physics 24 9, 093012 (2022).

[22] Christoforus Dimas Satrya, Andrew Guthrie, Ilari K Mäkinen, and Jukka P Pekola, "Electromagnetic simulation and microwave circuit approach of heat transport in superconducting qubits", Journal of Physics Communications 7 1, 015005 (2023).

[23] F. Hassani, M. Peruzzo, L. N. Kapoor, A. Trioni, M. Zemlicka, and J. M. Fink, "Inductively shunted transmons exhibit noise insensitive plasmon states and a fluxon decay exceeding 3 hours", Nature Communications 14 1, 3968 (2023).

[24] Sampreet Kalita and Amarendra K. Sarma, Lecture Notes in Networks and Systems 694, 581 (2023) ISBN:978-981-99-3090-6.

[25] Halima Giovanna Ahmad, Caleb Jordan, Roald van den Boogaart, Daan Waardenburg, Christos Zachariadis, Pasquale Mastrovito, Asen Lyubenov Georgiev, Domenico Montemurro, Giovanni Piero Pepe, Marten Arthers, Alessandro Bruno, Francesco Tafuri, Oleg Mukhanov, Marco Arzeo, and Davide Massarotti, "Investigating the Individual Performances of Coupled Superconducting Transmon Qubits", Condensed Matter 8 1, 29 (2023).

[26] Feng-Ming Liu, Can Wang, Ming-Cheng Chen, He Chen, Shao-Wei Li, Zhong-Xia Shang, Chong Ying, Jian-Wen Wang, Yong-Heng Huo, Cheng-Zhi Peng, Xiaobo Zhu, Chao-Yang Lu, and Jian-Wei Pan, "Quantum computer-aided design for advanced superconducting qubit: Plasmonium", Science Bulletin 68 15, 1625 (2023).

[27] D.K. Weiss, Helin Zhang, Chunyang Ding, Yuwei Ma, David I. Schuster, and Jens Koch, "Fast High-Fidelity Gates for Galvanically-Coupled Fluxonium Qubits Using Strong Flux Modulation", PRX Quantum 3 4, 040336 (2022).

[28] Isidora Araya Day, Sebastian Miles, Hugo K. Kerstens, Daniel Varjas, and Anton R. Akhmerov, "Pymablock: an algorithm and a package for quasi-degenerate perturbation theory", arXiv:2404.03728, (2024).

[29] Elizabeth Champion, Zihao Wang, Rayleigh Parker, and Machiel Blok, "Multi-frequency control and measurement of a spin-7/2 system encoded in a transmon qudit", arXiv:2405.15857, (2024).

[30] Miha Papič, Jani Tuorila, Adrian Auer, Inés de Vega, and Amin Hosseinkhani, "Charge-parity switching effects and optimisation of transmon-qubit design parameters", arXiv:2309.17168, (2023).

[31] Thi Ha Kyaw, Tim Menke, Sukin Sim, Abhinav Anand, Nicolas P. D. Sawaya, William D. Oliver, Gian Giacomo Guerreschi, and Alán Aspuru-Guzik, "Quantum Computer-Aided Design: Digital Quantum Simulation of Quantum Processors", Physical Review Applied 16 4, 044042 (2021).

[32] Feng-Ming Liu, Ming-Cheng Chen, Can Wang, Shao-Wei Li, Zhong-Xia Shang, Chong Ying, Jian-Wen Wang, Cheng-Zhi Peng, Xiaobo Zhu, Chao-Yang Lu, and Jian-Wei Pan, "Quantum design for advanced qubits: plasmonium", arXiv:2109.00994, (2021).

[33] Matilda Peruzzo, Farid Hassani, Gregory Szep, Andrea Trioni, Elena Redchenko, Martin Žemlička, and Johannes M. Fink, "Geometric Superinductance Qubits: Controlling Phase Delocalization across a Single Josephson Junction", PRX Quantum 2 4, 040341 (2021).

The above citations are from Crossref's cited-by service (last updated successfully 2024-06-22 03:28:22) and SAO/NASA ADS (last updated successfully 2024-06-22 03:28:22). The list may be incomplete as not all publishers provide suitable and complete citation data.

1 thought on “Scqubits: a Python package for superconducting qubits

  1. Pingback: The Long of The Shorts | Week Ending 11/27/2021 | Quantum Computing – The Qubit Report