Skip to main content

SuperGrad differentiable Hamiltonian simulator

Project description

SuperGrad: Differentiable Simulator for superconducting quantum processors

GitHub actions Docs PyPI License

SuperGrad is an open-source simulator designed to accelerate the development of superconducting quantum processors by incorporating gradient computation capabilities.

Notice: This package is currently in its early development stages. Please be aware that breaking changes to the API may occur.

Why SuperGrad?

Superconducting processors offer significant design flexibility, including various types of qubits and interactions. With the large number of tunable parameters in a processor, gradient optimization becomes crucial. SuperGrad fills the gap in open-source software by providing a tightly integrated library capable of efficient backpropagation for gradient computation.

Key Features

  • Efficient backpropagation for gradient computation based on JAX.
  • User-friendly interface for constructing Hamiltonians
  • Computation of both static and dynamic properties of composite systems, such as the unitary matrices of simultaneous gates

These features help us to speedup tasks including

  • Optimal control
  • Design optimization
  • Experimental data fitting

Installation

We suggest using python version >= 3.10.

pip install supergrad

Examples

Typical workflow

First, one need to define an interaction graph which describes qubits and their connectivity. This is done with creating an instance of Networkx.Graph class. There is a work-in-progress GUI for creating such graphs available at https://github.com/iqubit-org/supergrad-gui.

We consider Hamiltonians of the form

H_{\mathrm{idle}}\left(\vec{h}\right)+\sum_{k=1}^{N_c}f_{k}\left(\vec{c},t\right)C_{k}\left(\vec{h}\right)

The parameters about only a single qubit are stored in the nodes of the graph. These include parameters of superconducting qubits such as $E_C$, $E_J$, and parameters $\vec{c}$ of control pulses. The couplings of qubits are stored in the edges between qubits, which is a subset of $\vec{h}$. Then, some Helper classes will parse the graph, and create functions $f(\vec{h},\vec{c})$ which compute time-evolution unitary $U(\vec{h},\vec{c})$ or the energy spectrum of $H_{\mathrm{idle}}(\vec{h})$. One can construct objective functions based on these results. JAX can then be used to compute the gradient of an objective function and use it to run gradient optimization.

In general, we will use GHz and ns as units for energy and time parameters.

Fluxonium with multi-path coupling (Main example)

The jupyter notebook

This example is based on Nguyen, L. B. et al. Blueprint for a High-Performance Fluxonium Quantum Processor. PRX Quantum 3, 037001 (2022). We simulate a 6 Fluxonium qubit system from an underlying periodic lattice. Idling hamiltonian of the system is

H(0) = \sum_i H_{\mathrm{f},i}  + \sum_{\langle i,j \rangle } H_{ij}

Hamiltonian of single Fluxonium is

H_{\mathrm{f},i} = 4E_{\mathrm{C},i} n_i^2 + \frac{1}{2} E_{\mathrm{L},i} (\varphi_i +\varphi_{\mathrm{ext},i})^2
    -E_{\mathrm{J},i}\cos \left( \varphi_i \right)

The coupling terms have the form

H_{ij} = J_{\mathrm{C}} n_i n_j - J_{\mathrm{L}} \varphi_i \varphi_j

The couplings are chosen in a way such that the idling $ZZ$-crosstalk is almost zero. We compute the time-evolution and the Pauli error rates for simultaneous single-qubit X gates and two-qubit CR gates. More details can be found in Ni, X. et al. Superconducting processor design optimization for quantum error correction performance. arXiv:2312.04186.

Transmon with tunable couplers

The jupyter notebook

This example is based on Xu, Y. et al. High-Fidelity, High-Scalability Two-Qubit Gate Scheme for Superconducting Qubits. Phys. Rev. Lett. 125, 240503 (2020). We simulate a 5 transmon qubit system, where 3 of them are computational qubits and the other 2 are the couplers. We compute the time-evolution and the Pauli error rates for simultaneous single-qubit X gates.

Fluxonium parameter fitting from experimental spectrum data

The jupyter notebook

This is a quite different application compared to above ones. Here we try to infer the parameters of the system from spectrum data from experiments. We will consider the simplest case which is fitting the parameters of one Fluxonium. But the procedure can be applied to more complex systems as well.

Citation

If this project is helpful to you in your research, the use of SuperGrad in research publications is appropriately acknowledged by citing:

@misc{supergrad_2024,
      title={SuperGrad: a differentiable simulator for superconducting processors},
      author={Ziang Wang and Feng Wu and Hui-Hai Zhao and Xin Wan and Xiaotong Ni},
      year={2024},
      eprint={2406.18155},
      archivePrefix={arXiv},
      primaryClass={quant-ph}
}

which is also a good introduction to the simulator.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

supergrad-0.2.5.tar.gz (104.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

supergrad-0.2.5-py3-none-any.whl (110.4 kB view details)

Uploaded Python 3

File details

Details for the file supergrad-0.2.5.tar.gz.

File metadata

  • Download URL: supergrad-0.2.5.tar.gz
  • Upload date:
  • Size: 104.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for supergrad-0.2.5.tar.gz
Algorithm Hash digest
SHA256 fb8080ffdbf10af84f600ad9442c57f697c88aae9065c7975e97520c032b2204
MD5 3d41ae3df757fa02f8f9f37247764dfd
BLAKE2b-256 89c30a3d2d98fa7d60694e144ac40c135467aa72ed4cab17746ab50f1d6f08f0

See more details on using hashes here.

File details

Details for the file supergrad-0.2.5-py3-none-any.whl.

File metadata

  • Download URL: supergrad-0.2.5-py3-none-any.whl
  • Upload date:
  • Size: 110.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for supergrad-0.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 dce18c38d21e03fe5f6e8316a2796ebd44d5b89f89fa437cd326a0e8cc681bc6
MD5 e12756df2d556889a787fe4e3c04f8db
BLAKE2b-256 798ea17c8a23ea42ae2f1196c914097f9ef52cd42d51b63bb15afa8142f95d9d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page