{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Bird's eye view of Qiskit Metal" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "#### You'll use Qiskit Metal in 4 stages\n", "\n", "1. Choose a design class to instantiate.\n", " \n", "2. Add and modify pre-built components (qubits, coplanar wave guides, etc.) from the QComponent library to your design. (Or, [create your own components](../2-From-components-to-chip/2.31-Create-a-QComponent-Basic.ipynb)) \n", " \n", " \n", " \n", "3. Render to Simulate & Analyze \n", " * Current Rendering Options:\n", " * Ansys \n", " * HFSS Renderer - for high frequency simulations (eigenmode, modal, terminal)\n", " * EPR Analysis - Uses eigenmode simulation to perform energy participation ratio analysis\n", " * Q3D Renderer - for extracting equivalent circuit values of a layout, such as capacitance\n", " * LOM Analysis - Uses the capacitance matrix from Q3D to determine the parameters of a transmon qubit\n", " \n", " \n", " \n", "4. Render for Fabrication\n", " * Current Rendering Options:\n", " * GDS \n", " \n", "\n", "\n", "\n", "These steps are shown visually below in the following diagram" ] }, { "attachments": { "dc5dd3ac-561d-44fc-a612-e29d93666336.jpg": { "image/jpeg": "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TcR/NH8f8j8XKK/aP/hjL9nD/oV5v/Btqf8A8lUf8MZfs4f9CvN/4NtT/wDkqj/iKeB/59z/AA/zD/U3EfzR/H/I/Fyiv2j/AOGMv2cP+hXm/wDBtqf/AMlUf8MZfs4f9CvN/wCDbU//AJKo/wCIp4H/AJ9z/D/MP9TcR/NH8f8AI/Fyiv2j/wCGMv2cP+hXm/8ABtqf/wAlUf8ADGX7OH/Qrzf+DbU//kqj/iKeB/59z/D/ADD/AFNxH80fx/yPxcor9o/+GMv2cP8AoV5v/Btqf/yVR/wxl+zh/wBCvN/4NtT/APkqj/iKeB/59z/D/MP9TcR/NH8f8j8XKK/aP/hjL9nD/oV5v/Btqf8A8lUf8MZfs4f9CvN/4NtT/wDkqj/iKeB/59z/AA/zD/U3EfzR/H/I/Fyu5+Fv/JVvAf8A2Mei/wDpfBX61f8ADGX7OH/Qrzf+DbU//kqtLRf2SfgB4f1nT/EGk+GpYr/SrmG7tnbU9QkCT27iSNtklyyNtdQcMCDjkGuXG+JmCq0Z01Tldprp1XqbYfhHEQqRm5R0a7/5H0fRRRX4ifoYUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAf/Q/fyiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooA//R/fyiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooA//S/fyiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooA//Z" } }, "cell_type": "markdown", "metadata": {}, "source": [ "![QDesign Data Flow_accurate.jpg](attachment:dc5dd3ac-561d-44fc-a612-e29d93666336.jpg)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### *_This tutorial is for steps 1 and 2._*" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Using this Tutorial" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "Metal can be used three different ways: \n", " * Jupyter Notebooks\n", " * For interactive code\n", " * To Use:\n", " 1. Just press run :D \n", " * Python scripts\n", " * For setting internal breakpoints\n", " * To Use: \n", " 1. Copy snippets of code from these Notebooks and save as a Python file. \n", " 2. Run in your favorite editor. (We like VS Code!)\n", " * Metal GUI\n", " * _In the future, we anticipate Metal GUI to have full functionality._\n", " * To Use: \n", " 1. You _must_ first use either Jupyter Notebooks or Python Scripts to add components to your QDesign. \n", " 2. Use the GUI to visualize and manually edit your components.\n", "\n", "\n", "Let's dive in!\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### QDesign (need-to-know)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Each time you create a new quantum circuit design, you start by instantiating a QDesign class. \n", "\n", "There are different design classes in the design library `qiskit_metal.designs` for different design layouts. For example the design class `DesignPlanar` is best for 2D circuit designs. \n", "\n", "Every design class (except `QDesign`) inherits from the base `QDesign` class. `QDesign` defines basic functionality for all other design classes and should not be directly instantiated. " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### QDesign (in-depth)\n", "\n", "QDesign keeps track of each of the components (qubits, coplanar wave guides, etc.) that you add to your circuit and the relationships between them. \n", "\n", "As you can see below, QDesign keeps track of many things:" ] }, { "attachments": { "5e897a72-0dcd-4df0-83f7-ca0bbc6a3d95.jpg": { "image/jpeg": "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rw5/4KLP/wCNUf8AChPgZ/0Trw5/4KLP/wCNV6xRR9drfzv72H1en/KvuPJ/+FCfAz/onXhz/wAFFn/8ao/4UJ8DP+ideHP/AAUWf/xqvWKKPrtb+d/ew+r0/wCVfceT/wDChPgZ/wBE68Of+Ciz/wDjVH/ChPgZ/wBE68Of+Ciz/wDjVesUUfXa387+9h9Xp/yr7jyf/hQnwM/6J14c/wDBRZ//ABqj/hQnwM/6J14c/wDBRZ//ABqvWKKPrtb+d/ew+r0/5V9x5P8A8KE+Bn/ROvDn/gos/wD41R/woT4Gf9E68Of+Ciz/APjVesUUfXa387+9h9Xp/wAq+48n/wCFCfAz/onXhz/wUWf/AMao/wCFCfAz/onXhz/wUWf/AMar1iij67W/nf3sPq9P+VfceT/8KE+Bn/ROvDn/AIKLP/41R/woT4Gf9E68Of8Agos//jVesUUfXa387+9h9Xp/yr7jyf8A4UJ8DP8AonXhz/wUWf8A8ao/4UJ8DP8AonXhz/wUWf8A8ar1iij67W/nf3sPq9P+VfceT/8AChPgZ/0Trw5/4KLP/wCNUf8AChPgZ/0Trw5/4KLP/wCNV6xRR9drfzv72H1en/KvuPJ/+FCfAz/onXhz/wAFFn/8ao/4UJ8DP+ideHP/AAUWf/xqvWKKPrtb+d/ew+r0/wCVfceT/wDChPgZ/wBE68Of+Ciz/wDjVH/ChPgZ/wBE68Of+Ciz/wDjVesUUfXa387+9h9Xp/yr7jyf/hQnwM/6J14c/wDBRZ//ABqj/hQnwM/6J14c/wDBRZ//ABqvWKKPrtb+d/ew+r0/5V9x5P8A8KE+Bn/ROvDn/gos/wD41R/woT4Gf9E68Of+Ciz/APjVesUUfXa387+9h9Xp/wAq+48+0L4S/CrwtqkWt+GfBmi6RqNvuEdzZ6dbW86B1KttkjjVhlSQcHkEivQaKKxqVZTd5O5cYKOiQUUUVBQUUUUAFFFFABRRRQAUUUUAFFFFABRRRQB//9D9/KKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/9H9/KKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/9L9/KKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/9k=" } }, "cell_type": "markdown", "metadata": {}, "source": [ "![QDesign Data Flow_accurate_inside.jpg](attachment:5e897a72-0dcd-4df0-83f7-ca0bbc6a3d95.jpg)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "* QComponents - do *not* directly instantiate\n", " * Components of your design\n", " * Example:\n", " * Transmon Qubits\n", " * CPWs\n", " * etc.\n", " * Upon creation, the QComponent's `make` function runs and adds the QComponent's geometries (rectangles, line segments, etc.) to the QGeometryTables\n", "\n", "\n", "* QGeometryTables - instantiate during init of QDesign\n", " * Stores backend information about components\n", " * Populated when QComponents are added to QDesign \n", " \n", " \n", "* QNet.net_info - instantiate during init of QDesign\n", " * Stores backend information on existing connections between components \n", " * Instantiated in the backend by QDesign\n", " * Populated during connections of QComponents\n", " \n", "* QRenderer - instantiate during init of QDesign\n", " * This is what allows you to export your designs into Ansys, GDS, etc.\n", " * `qiskit_metal/config.py` contains list of all instantiated renderers\n", " \n", " " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Coding Time!\n", "\n", "Today we'll be creating a 2D design and adding a single qcomponent\n", "\n", "So, let us dive right in. For convenience, let's begin by enabling [automatic reloading of modules](https://ipython.readthedocs.io/en/stable/config/extensions/autoreload.html?highlight=autoreload) when they change." ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "%load_ext autoreload\n", "%autoreload 2" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Import Qiskit Metal" ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [ { "data": { "text/html": [ "\n", "