Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/iqm-finland/KQCircuits

KLayout Python library for integrated quantum circuit design.
https://github.com/iqm-finland/KQCircuits

eda gds gds2 gdsii klayout quantum quantum-computing qubits superconducting superconducting-qubits unitaryhack

Last synced: 2 months ago
JSON representation

KLayout Python library for integrated quantum circuit design.

Host: GitHub
URL: https://github.com/iqm-finland/KQCircuits
Owner: iqm-finland
License: gpl-3.0
Created: 2020-08-10T08:49:35.000Z (almost 4 years ago)
Default Branch: main
Last Pushed: 2024-04-12T12:00:42.000Z (3 months ago)
Last Synced: 2024-04-12T17:25:19.137Z (3 months ago)
Topics: eda, gds, gds2, gdsii, klayout, quantum, quantum-computing, qubits, superconducting, superconducting-qubits, unitaryhack
Language: Python
Homepage:
Size: 62.1 MB
Stars: 116
Watchers: 15
Forks: 60
Open Issues: 12
Metadata Files:
- Readme: README.rst
- Contributing: docs/contributing.rst
- License: LICENSE
- Support: docs/support.rst

Lists

awesome_photonics - KQcircuits - Quantum circuits pdk. (layout)

README

.. image:: /docs/images/logo-small.png
:target: https://github.com/iqm-finland/KQCircuits
:alt: KQCircuits
:width: 300
:align: center

**KQCircuits** is a Python library developed by IQM for automating the design of
superconducting quantum circuits. It uses the `KLayout `__ layout design program
API.

.. image:: https://github.com/iqm-finland/KQCircuits/actions/workflows/ci.yaml/badge.svg
:target: https://github.com/iqm-finland/KQCircuits/actions/workflows/ci.yaml
:alt: Continuous Integration

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4944796.svg
:target: https://doi.org/10.5281/zenodo.4944796
:alt: DOI

.. image:: https://img.shields.io/badge/License-GPLv3-blue.svg
:target: https://github.com/iqm-finland/kqcircuits/blob/master/LICENSE
:alt: License

.. image:: https://img.shields.io/pypi/v/kqcircuits
:target: https://pypi.org/project/kqcircuits/
:alt: PyPI Package

.. image:: https://img.shields.io/badge/click-for%20documentation%20%F0%9F%93%92-lightgrey
:target: https://iqm-finland.github.io/KQCircuits/index.html
:alt: Click for documentation

----

KQCircuits generates multi-layer 2-dimensional-geometry representing common structures in quantum
processing units (QPU). It includes definitions of parametrized geometrical objects or “elements”,
framework to easily define your own elements, framework to get geometry from the elements by setting
values to parameters and a framework to assemble a full QPU design by combining many of the elements
in different geometrical relations. Among other templates, are also structures to combine QPU
designs to create optical mask layout and EBL patterns for fabrication of quantum circuits and
export a set of files for a mask as needed for QPU fabrication.

.. image:: /docs/images/readme/design_flow.svg
:alt: QPU design workflow
:width: 700

⠀

.. image:: /docs/images/readme/single_xmons_chip_3.png
:alt: Example layout

Getting started
---------------

KQCircuits is a KLayout extension. KLayout can be used either using a graphical user interface or as
a standalone python module. KQCircuits supports both modes of operation. For the first time users,
the graphical user interface (GUI) mode is recommended.

Video tutorials for the GUI installation can be found on YouTube.

.. raw:: html

Windows

Ubuntu

MacOS

Install
^^^^^^^

KQCircuits can be used in either Salt package or developer setup mode.
The Salt package is easier to install and get started, but the built-in elements cannot be modified.
The developer setup is recommended for advanced users and to contribute to the project.

Salt installation and getting started
"""""""""""""""""""""""""""""""""""""

Follow the instructions in the `getting started documentation `__.

Developer setup
"""""""""""""""

`Install KLayout `__ and run:

.. code-block:: console

python setup_within_klayout.py

then KLayout will contain KQCircuits.
You may have to write ``python3`` or ``py`` instead of ``python`` depending on your OS and Python installation,
just make sure that the command refers to Python 3. For further details see the `developer setup
documentation `__.

For stand-alone mode run

.. code-block:: console

python -m pip install -e "klayout_package/python[docs,tests]"

Then scripts may be run and documentation can be built. For further details see the `documentation
`__.

Documentation
-------------

Documentation for KQCircuits can be found `here `__.

It may also be generated from the sources with ``make html`` in the docs directory.

Tutorials
^^^^^^^^^

Follow the `User Guide `__ for tutorials.

.. image:: /docs/images/gui_workflows/converting_gui_elements_to_code.gif
:target: https://iqm-finland.github.io/KQCircuits/user_guide/gui_features.html#converting-elements-placed-in-gui-into-code
:alt: Example of GUI elements
:width: 600

Simulations
-----------

.. image:: /docs/images/readme/xmon_animation.gif
:alt: Animation of simulations
:width: 350

KQC currently supports exporting to **Ansys HFSS/Q3D (also with pyEPR)**, **Sonnet**, and **Elmer**.

Parameter sweeps are easy to implement, for example

.. code-block:: python

simulations = sweep_simulation(layout, sim_class, sim_parameters, {
'cpl_length': [160, 180, 200],
'arm_width': [24, 28, 32, 36],
})

exports simulations with the given individual parameters varied roughly as in the animation.

A sweep of all possible combinations between the given parameters is done by changing the function to
``cross_sweep_simulation``.
Check `klayout_package/python/scripts/simulations `__
for example simulation exports.

Support
-------

If you have any questions, problems or ideas related to KQCircuits, please start
a
`discussion in GitHub `__
or create a `GitHub issue `__.

Contributing
------------

Contributions to KQC are welcome from the community. Contributors are expected to accept IQM
Individual Contributor License Agreement by filling `a form at IQM website
`__. See also section `Contributing
`__ in the
documentation.

Citation
--------
Please see the
`documentation `__
for instructions on how to cite KQCircuits in your projects and publications.

This code is part of KQCircuits

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see
https://www.gnu.org/licenses/gpl-3.0.html.

The software distribution should follow IQM trademark policy for open-source software
(`meetiqm.com/developers/osstmpolicy `__).
IQM welcomes contributions to the code. Please see our contribution agreements for individuals
(`meetiqm.com/developers/clas/individual `__)
and organizations (`meetiqm.com/developers/clas/organization `__).

Trademarks
----------

KQCircuits is a registered trademark of IQM. Please see
`IQM open source software trademark policy `__.