SQuADDS#

A validated design database and simulation workflow for superconducting qubits

SQuADDS gives you a well-characterised starting point for superconducting hardware. Ask for the Hamiltonian you want and get the closest pre-simulated designs from an experimentally validated database, an interpolated best guess, and, from version 0.5, the full capacitance matrix of any planar layout straight from its GDS file.

pip install SQuADDS

Python 3.11 or newer. For the capacitance models: pip install "squadds[ml]". From source with uv sync: installation guide.

Where to start#

Qubit designers

Find a design for your Hamiltonian

Give target parameters, get the closest pre-simulated designs and an interpolated best guess to simulate.

Tutorial 1Tutorial 2

db = SQuADDS_DB()
db.select_system("qubit")
db.select_qubit("TransmonCross")
db.create_system_df()
Analyzer(db).find_closest(
    {"qubit_frequency_GHz": 4,
     "anharmonicity_MHz": -200}, num_top=3)

Layout to capacitance

Capacitance matrix from a GDS file

The full N × N Maxwell matrix of every conductor, ground included, in about a second on a CPU. Nets are never merged.

ML models guideTutorial 11

predictor = CapacitancePredictor(
    load_model("QCap"))
res = predictor.predict("chip.gds")
res.to_dataframe()   # fF, ground first

Contributors

Add your designs and data

Simulated or measured devices, capacitance data and models. The validator checks every matrix before a pull request opens.

Contribution portalTutorial 3Tutorial 15

validate_capacitance_contribution(
    "my_batch/")
contribute_capacitance("my_batch/")

AI agents

Connect an assistant with MCP

The SQuADDS MCP server lets a coding assistant search designs, find the closest match and interpolate parameters.

MCP server guideChat with the codebase

uv sync --extra mcp
uv run squadds-mcp

Learn more about our latest paper#

QCap: a physics-corrected graph neural network for the capacitance matrix of any planar superconducting device layout

Tutorials#

  1. Using the SQuADDS Web UI

  2. Getting started with SQuADDS

  3. Simulating interpolated designs

  4. Contributing validated simulation data

  5. Contributing measured data

  6. Designing a fab-ready chip

  7. Adding airbridges

  8. Simulating designs with Palace

  9. Machine learning with SQuADDS

  10. Driven-modal capacitance extraction

  11. Unified driven-modal Hamiltonian extraction

  12. Predicting capacitance matrices from GDS

  13. Planar capacitance families

  14. From layout to Hamiltonian with ML

  15. Training on your own designs

  16. Contributing capacitance data and models

  17. Inverse design by ML screening

Contents#

Citing SQuADDS and QCap#

If SQuADDS helps your research, please support its continued development and maintenance by citing the paper: Shanto et al., Quantum 8, 1465 (2024). If you use QCap (the planar capacitance models or their dataset), please also cite Shanto, Das and Levenson-Falk (2026).

@article{Shanto2024squaddsvalidated,
  doi = {10.22331/q-2024-09-09-1465},
  url = {https://doi.org/10.22331/q-2024-09-09-1465},
  title = {{SQ}u{ADDS}: {A} validated design database and simulation workflow for superconducting qubit design},
  author = {Shanto, Sadman and Kuo, Andre and Miyamoto, Clark and Zhang, Haimeng and Maurya, Vivek and Vlachos, Evangelos and Hecht, Malida and Shum, Chung Wa and Levenson-Falk, Eli},
  journal = {{Quantum}},
  issn = {2521-327X},
  publisher = {{Verein zur F{\"{o}}rderung des Open Access Publizierens in den Quantenwissenschaften}},
  volume = {8},
  pages = {1465},
  month = sep,
  year = {2024}
}

@misc{Shanto2026planarcapacitance,
  title = {{QCap}: a physics-corrected graph neural network for the capacitance matrix of any planar superconducting device layout},
  author = {Shanto, Sadman Ahmed and Das, Saikat and Levenson-Falk, Eli},
  year = {2026},
  url = {https://lfl-lab.github.io/SQuADDS/ml-paper/paper/}
}