{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "e4e43895",
   "metadata": {},
   "source": [
    "# 2.31 Create a QComponent - Basic"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "884826bc",
   "metadata": {},
   "source": [
    "Now that you have become familiar with Qiskit Metal and feel comfortable using the available aspects and functionality, the next step is learning how to make your own circuit component in Metal.\n",
    "\n",
    "We will start off by going over the sample `my_qcomponent` in `qiskit_metal>qlibrary>user_components` as a basis, which we will walk through below."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "0b509299",
   "metadata": {},
   "source": [
    "## Reviewing my_qcomponent"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "5230d001",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:28.546674Z",
     "iopub.status.busy": "2026-06-02T03:56:28.546491Z",
     "iopub.status.idle": "2026-06-02T03:56:28.550837Z",
     "shell.execute_reply": "2026-06-02T03:56:28.550086Z"
    }
   },
   "outputs": [],
   "source": [
    "# -*- coding: utf-8 -*-\n",
    "\n",
    "# This code is part of Qiskit.\n",
    "#\n",
    "# (C) Copyright IBM 2017, 2021.\n",
    "#\n",
    "# This code is licensed under the Apache License, Version 2.0. You may\n",
    "# obtain a copy of this license in the LICENSE.txt file in the root directory\n",
    "# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.\n",
    "#\n",
    "# Any modifications or derivative works of this code must retain this\n",
    "# copyright notice, and modified files need to carry a notice indicating\n",
    "# that they have been altered from the originals."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "61421202",
   "metadata": {},
   "source": [
    "Always be sure to include the proper copyright and license information, and give yourself credit for any components you create!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "16e48df7",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:28.552758Z",
     "iopub.status.busy": "2026-06-02T03:56:28.552611Z",
     "iopub.status.idle": "2026-06-02T03:56:30.090260Z",
     "shell.execute_reply": "2026-06-02T03:56:30.089827Z"
    }
   },
   "outputs": [],
   "source": [
    "from qiskit_metal import draw, Dict\n",
    "from qiskit_metal.toolbox_metal import math_and_overrides\n",
    "from qiskit_metal.qlibrary.core import QComponent"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8e0d6dca",
   "metadata": {},
   "source": [
    "Import any classes or functions you will be wanting to use when creating your component. The geometries in Metal are shapely objects, which can be readily generated and manipulated through functions in `draw`. Mathematical functions can be accessed via `math_and_overrides`. Any imports that are part of the Metal requirement list can also be used.\n",
    "\n",
    "The key import is what the parent class of your new component will be. For this example, we are using `QComponent` as the parent for `MyQComponent`, which is the base component class in Metal and contains a great deal of automated functionality. All component hierarchy must have QComponent as the top base class."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "45d53626",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.092838Z",
     "iopub.status.busy": "2026-06-02T03:56:30.092691Z",
     "iopub.status.idle": "2026-06-02T03:56:30.096068Z",
     "shell.execute_reply": "2026-06-02T03:56:30.095706Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "['TOOLTIP',\n",
       " '__class__',\n",
       " '__delattr__',\n",
       " '__dict__',\n",
       " '__dir__',\n",
       " '__doc__',\n",
       " '__eq__',\n",
       " '__format__',\n",
       " '__ge__',\n",
       " '__getattribute__',\n",
       " '__getstate__',\n",
       " '__gt__',\n",
       " '__hash__',\n",
       " '__i_am_component__',\n",
       " '__init__',\n",
       " '__init_subclass__',\n",
       " '__le__',\n",
       " '__lt__',\n",
       " '__module__',\n",
       " '__ne__',\n",
       " '__new__',\n",
       " '__reduce__',\n",
       " '__reduce_ex__',\n",
       " '__repr__',\n",
       " '__setattr__',\n",
       " '__sizeof__',\n",
       " '__str__',\n",
       " '__subclasshook__',\n",
       " '__weakref__',\n",
       " '_add_to_design',\n",
       " '_check_pin_inputs',\n",
       " '_delete_evaluation',\n",
       " '_gather_all_children_metadata',\n",
       " '_gather_all_children_options',\n",
       " '_get_specific_table_values_from_renderers',\n",
       " '_get_table_values_from_renderers',\n",
       " '_get_unique_class_name',\n",
       " '_is_name_used',\n",
       " '_register_class_with_design',\n",
       " 'add_dependency',\n",
       " 'add_pin',\n",
       " 'add_qgeometry',\n",
       " 'class_name',\n",
       " 'component_metadata',\n",
       " 'connect_components_already_in_design',\n",
       " 'default_options',\n",
       " 'delete',\n",
       " 'design',\n",
       " 'get_pin',\n",
       " 'get_template_options',\n",
       " 'id',\n",
       " 'logger',\n",
       " 'make',\n",
       " 'name',\n",
       " 'options',\n",
       " 'parse_options',\n",
       " 'parse_value',\n",
       " 'pin_names',\n",
       " 'populate_to_track_table_usage',\n",
       " 'qgeometry_bounds',\n",
       " 'qgeometry_dict',\n",
       " 'qgeometry_list',\n",
       " 'qgeometry_plot',\n",
       " 'qgeometry_table',\n",
       " 'qgeometry_types',\n",
       " 'rebuild',\n",
       " 'to_script']"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "dir(QComponent)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "ae5d9ac6",
   "metadata": {},
   "source": [
    "`MyQComponent` creates a simple rectangle of a variable width, height, position and orientation."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "0def219d",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.097116Z",
     "iopub.status.busy": "2026-06-02T03:56:30.097044Z",
     "iopub.status.idle": "2026-06-02T03:56:30.099557Z",
     "shell.execute_reply": "2026-06-02T03:56:30.099244Z"
    }
   },
   "outputs": [],
   "source": [
    "class MyQComponent(QComponent):\n",
    "    \"\"\"\n",
    "    Use this class as a template for your components - have fun\n",
    "\n",
    "    Description:\n",
    "\n",
    "    Options:\n",
    "    \"\"\"\n",
    "\n",
    "    # Edit these to define your own tempate options for creation\n",
    "    # Default drawing options\n",
    "    default_options = Dict(\n",
    "        width=\"500um\",\n",
    "        height=\"300um\",\n",
    "        pos_x=\"0um\",\n",
    "        pos_y=\"0um\",\n",
    "        orientation=\"0\",\n",
    "        layer=\"1\",\n",
    "    )\n",
    "    \"\"\"Default drawing options\"\"\"\n",
    "\n",
    "    # Name prefix of component, if user doesn't provide name\n",
    "    component_metadata = Dict(short_name=\"component\", _qgeometry_table_poly=\"True\")\n",
    "    \"\"\"Component metadata\"\"\"\n",
    "\n",
    "    def make(self):\n",
    "        \"\"\"Convert self.options into QGeometry.\"\"\"\n",
    "\n",
    "        p = self.parse_options()  # Parse the string options into numbers\n",
    "\n",
    "        # EDIT HERE - Replace the following with your code\n",
    "        # Create some raw geometry\n",
    "        # Use autocompletion for the `draw.` module (use tab key)\n",
    "        rect = draw.rectangle(p.width, p.height, p.pos_x, p.pos_y)\n",
    "\n",
    "        rect = draw.rotate(rect, p.orientation)\n",
    "        rect = draw.translate(rect, p.pos_x, p.pos_y)\n",
    "\n",
    "        geom = {\"my_polygon\": rect}\n",
    "        self.add_qgeometry(\"poly\", geom, layer=p.layer, subtract=False)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "091d7180",
   "metadata": {},
   "source": [
    "The docstring at the start of the class should clearly explain what the component is, what the parameterized values of the component refer to (in a sense the 'inputs'), and any other information you believe would be relevant for a user making use of your component.\n",
    "\n",
    "`default_options` is a dictionary to be included in the class of all components. The keywords, of type string, in the default dictionary are the parameters the front-end user is allowed to modify. The keywords in the above indicate that the width and height can be modified via the components options, but have a default value of 500um and 300 um respectively. Further, the position and orientation can also be changed. The `layer` is an expected keyword in a default dictionary, as it is used by renderers to help determine further properties of the `qgeometry` of the component when rendered, eg. GDS QRenderer uses the layer # to define which layer the qgeometry is on.\n",
    "\n",
    "`component_metadata` is a dictionary which contains some important pieces of information, such as the default/shorthand name of the component (`short_name`), or indicating what types of qgeometry tables are included in this component, eg. `_qgeometry_table_poly='True'`.\n",
    "The `component_metadata` must contain the flags for each type of qgeometry table being used via `add_qgeometry` methods at the end of the `make()` function, in order for renderer options to be updated correctly. Currently the options are:\n",
    "\n",
    "`_qgeometry_table_path='True'`\n",
    "\n",
    "`_qgeometry_table_poly='True'`\n",
    "\n",
    "`_qgeometry_table_junction='True'`\n",
    "\n",
    "\n",
    "The `make()` method is where the actual generation of the component's layout is written. "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "9bad9575",
   "metadata": {},
   "source": [
    "### The make() method"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "ad026596",
   "metadata": {},
   "source": [
    "Although not required, a good first line is `p = self.parse_options()` to cut down on your amount of typing. The `parse_options()` translates the keywords in `self.options` from strings into their appropriate value with respect to the prefix included, e.g.,`p.width`=> \"500um\" -> 0.0005\n",
    "\n",
    "Following this, all code generating the shapely geometries that are to represent your circuit layout should be written, via the `draw` module or even written in directly. It is a good practice to play around with the geometries in a jupyter notebook first for quick visual feedback, such as:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "672b37d4",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.100665Z",
     "iopub.status.busy": "2026-06-02T03:56:30.100596Z",
     "iopub.status.idle": "2026-06-02T03:56:30.102850Z",
     "shell.execute_reply": "2026-06-02T03:56:30.102491Z"
    }
   },
   "outputs": [
    {
     "data": {
      "image/svg+xml": [
       "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"100.0\" height=\"100.0\" viewBox=\"-0.58 -1.08 1.16 2.16\" preserveAspectRatio=\"xMinYMin meet\"><g transform=\"matrix(1,0,0,-1,0,0.0)\"><path fill-rule=\"evenodd\" fill=\"#66cc99\" stroke=\"#555555\" stroke-width=\"0.0432\" opacity=\"0.6\" d=\"M -0.5,-1.0 L 0.5,-1.0 L 0.5,1.0 L -0.5,1.0 L -0.5,-1.0 z\" /></g></svg>"
      ],
      "text/plain": [
       "<POLYGON ((-0.5 -1, 0.5 -1, 0.5 1, -0.5 1, -0.5 -1))>"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "draw.rectangle(1, 2, 0, 0)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "1ce670c6",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.103813Z",
     "iopub.status.busy": "2026-06-02T03:56:30.103748Z",
     "iopub.status.idle": "2026-06-02T03:56:30.105923Z",
     "shell.execute_reply": "2026-06-02T03:56:30.105629Z"
    }
   },
   "outputs": [
    {
     "data": {
      "image/svg+xml": [
       "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"100.0\" height=\"100.0\" viewBox=\"-1.1455129855222068 -1.145512985522207 2.2910259710444136 2.291025971044414\" preserveAspectRatio=\"xMinYMin meet\"><g transform=\"matrix(1,0,0,-1,0,0.0)\"><path fill-rule=\"evenodd\" fill=\"#66cc99\" stroke=\"#555555\" stroke-width=\"0.04582051942088828\" opacity=\"0.6\" d=\"M 0.3535533905932737,-1.0606601717798214 L 1.0606601717798212,-0.35355339059327384 L -0.3535533905932737,1.0606601717798214 L -1.0606601717798212,0.35355339059327384 L 0.3535533905932737,-1.0606601717798214 z\" /></g></svg>"
      ],
      "text/plain": [
       "<POLYGON ((0.354 -1.061, 1.061 -0.354, -0.354 1.061, -1.061 0.354, 0.354 -1....>"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "draw.rotate(draw.rectangle(1, 2, 0, 0), 45)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "55316c76",
   "metadata": {},
   "source": [
    "Or for a little more complexity:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "8ea80b3a",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.107198Z",
     "iopub.status.busy": "2026-06-02T03:56:30.107130Z",
     "iopub.status.idle": "2026-06-02T03:56:30.110894Z",
     "shell.execute_reply": "2026-06-02T03:56:30.110535Z"
    }
   },
   "outputs": [
    {
     "data": {
      "image/svg+xml": [
       "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"100.0\" height=\"100.0\" viewBox=\"-1.08 -1.08 2.16 2.16\" preserveAspectRatio=\"xMinYMin meet\"><g transform=\"matrix(1,0,0,-1,0,0.0)\"><path fill-rule=\"evenodd\" fill=\"#66cc99\" stroke=\"#555555\" stroke-width=\"0.0432\" opacity=\"0.6\" d=\"M 0.9569403357322088,-0.29028467725446233 L 0.9238795325112867,-0.3826834323650898 L 0.881921264348355,-0.47139673682599764 L 0.8314696123025452,-0.5555702330196022 L 0.773010453362737,-0.6343932841636455 L 0.7071067811865476,-0.7071067811865475 L 0.6343932841636455,-0.773010453362737 L 0.5555702330196023,-0.8314696123025452 L 0.4713967368259978,-0.8819212643483549 L 0.38268343236508984,-0.9238795325112867 L 0.29028467725446233,-0.9569403357322088 L 0.19509032201612833,-0.9807852804032304 L 0.09801714032956077,-0.9951847266721968 L 0.0,-1.0 L -0.09801714032956065,-0.9951847266721969 L -0.1950903220161282,-0.9807852804032304 L -0.29028467725446216,-0.9569403357322089 L -0.3826834323650897,-0.9238795325112867 L -0.4713967368259977,-0.881921264348355 L -0.555570233019602,-0.8314696123025453 L -0.6343932841636454,-0.7730104533627371 L -0.7071067811865475,-0.7071067811865476 L -0.773010453362737,-0.6343932841636455 L -0.8314696123025453,-0.5555702330196022 L -0.8819212643483549,-0.47139673682599786 L -0.9238795325112867,-0.3826834323650899 L -0.9569403357322088,-0.2902846772544624 L -0.9807852804032304,-0.1950903220161286 L -0.9951847266721968,-0.09801714032956083 L -1.0,0.0 L -0.9951847266721969,0.09801714032956059 L -0.9807852804032304,0.19509032201612836 L -0.9569403357322089,0.2902846772544621 L -0.9238795325112868,0.38268343236508967 L -0.881921264348355,0.47139673682599764 L -0.8314696123025455,0.555570233019602 L -0.7730104533627371,0.6343932841636453 L -0.7071067811865477,0.7071067811865475 L -0.6343932841636458,0.7730104533627367 L -0.5555702330196022,0.8314696123025452 L -0.4713967368259979,0.8819212643483549 L -0.38268343236509034,0.9238795325112865 L -0.29028467725446244,0.9569403357322088 L -0.19509032201612866,0.9807852804032303 L -0.09801714032956045,0.9951847266721969 L 0.0,1.0 L 0.09801714032956009,0.9951847266721969 L 0.1950903220161283,0.9807852804032304 L 0.29028467725446205,0.9569403357322089 L 0.38268343236509,0.9238795325112866 L 0.4713967368259976,0.881921264348355 L 0.5555702330196018,0.8314696123025455 L 0.6343932841636456,0.7730104533627369 L 0.7071067811865474,0.7071067811865477 L 0.7730104533627367,0.6343932841636459 L 0.8314696123025452,0.5555702330196022 L 0.8819212643483548,0.471396736825998 L 0.9238795325112865,0.3826834323650904 L 0.9569403357322088,0.2902846772544625 L 0.9807852804032303,0.19509032201612872 L 0.9951847266721969,0.0980171403295605 L 1.0,0.0 L 0.9951847266721969,-0.0980171403295606 L 0.9807852804032304,-0.19509032201612825 L 0.9569403357322088,-0.29028467725446233 z M -0.7391036260090295,-0.3061467458920719 L -0.705537011478684,-0.3771173894607983 L -0.6651756898420363,-0.44445618641568174 L -0.6184083626901896,-0.5075146273309165 L -0.565685424949238,-0.5656854249492381 L -0.5075146273309163,-0.6184083626901897 L -0.4444561864156816,-0.6651756898420363 L -0.3771173894607982,-0.7055370114786841 L -0.3061467458920718,-0.7391036260090295 L -0.23222774180356975,-0.7655522685857672 L -0.15607225761290255,-0.7846282243225844 L -0.07841371226364852,-0.7961477813377575 L 0.0,-0.8 L 0.07841371226364863,-0.7961477813377575 L 0.15607225761290267,-0.7846282243225844 L 0.23222774180356986,-0.7655522685857671 L 0.3061467458920719,-0.7391036260090295 L 0.37711738946079826,-0.705537011478684 L 0.44445618641568185,-0.6651756898420362 L 0.5075146273309165,-0.6184083626901896 L 0.5656854249492381,-0.565685424949238 L 0.6184083626901896,-0.5075146273309165 L 0.6651756898420362,-0.44445618641568174 L 0.7055370114786841,-0.37711738946079815 L 0.7391036260090295,-0.30614674589207186 L 0.7413029668566793,-0.3 L -0.7413029668566793,-0.3 L -0.7391036260090295,-0.3061467458920719 z M 0.5961570560806461,0.43901806440322577 L 0.5913880671464418,0.45805693545089254 L 0.5847759065022573,0.4765366864730181 L 0.576384252869671,0.49427934736519963 L 0.566293922460509,0.5111140466039205 L 0.5546020906725474,0.5268786568327293 L 0.5414213562373095,0.5414213562373096 L 0.5268786568327292,0.5546020906725474 L 0.5111140466039203,0.5662939224605091 L 0.4942793473651995,0.576384252869671 L 0.47653668647301806,0.5847759065022573 L 0.45805693545089243,0.5913880671464418 L 0.43901806440322566,0.5961570560806462 L 0.41960342806591205,0.5990369453344394 L 0.4,0.6000000000000001 L 0.38039657193408793,0.5990369453344394 L 0.3609819355967743,0.5961570560806461 L 0.3419430645491075,0.5913880671464418 L 0.32346331352698193,0.5847759065022573 L 0.3057206526348004,0.576384252869671 L 0.2888859533960796,0.566293922460509 L 0.2731213431672709,0.5546020906725474 L 0.25857864376269046,0.5414213562373096 L 0.2453979093274526,0.526878656832729 L 0.2337060775394909,0.5111140466039205 L 0.223615747130329,0.4942793473651996 L 0.21522409349774263,0.47653668647301795 L 0.20861193285355822,0.45805693545089243 L 0.20384294391935392,0.4390180644032257 L 0.20096305466556064,0.41960342806591217 L 0.2,0.4 L 0.20096305466556064,0.3803965719340879 L 0.20384294391935392,0.3609819355967743 L 0.20861193285355825,0.34194306454910756 L 0.21522409349774266,0.32346331352698204 L 0.22361574713032903,0.3057206526348004 L 0.23370607753949094,0.2888859533960796 L 0.24539790932745262,0.2731213431672709 L 0.2585786437626905,0.25857864376269046 L 0.27312134316727094,0.2453979093274526 L 0.28888595339607964,0.23370607753949094 L 0.30572065263480047,0.223615747130329 L 0.3234633135269821,0.21522409349774266 L 0.3419430645491076,0.20861193285355822 L 0.3609819355967744,0.20384294391935392 L 0.3803965719340879,0.20096305466556064 L 0.4,0.2 L 0.41960342806591217,0.20096305466556064 L 0.43901806440322566,0.20384294391935392 L 0.4580569354508925,0.20861193285355825 L 0.476536686473018,0.21522409349774266 L 0.4942793473651996,0.22361574713032903 L 0.5111140466039205,0.23370607753949096 L 0.5268786568327292,0.24539790932745262 L 0.5414213562373096,0.2585786437626905 L 0.5546020906725474,0.2731213431672709 L 0.566293922460509,0.2888859533960796 L 0.576384252869671,0.30572065263480047 L 0.5847759065022574,0.32346331352698204 L 0.5913880671464418,0.34194306454910756 L 0.5961570560806462,0.3609819355967744 L 0.5990369453344394,0.3803965719340879 L 0.6000000000000001,0.4 L 0.5990369453344394,0.4196034280659121 L 0.5961570560806461,0.43901806440322577 z M -0.20096305466556064,0.4196034280659121 L -0.20384294391935395,0.43901806440322577 L -0.20861193285355825,0.45805693545089254 L -0.2152240934977427,0.4765366864730181 L -0.22361574713032906,0.49427934736519963 L -0.23370607753949096,0.5111140466039205 L -0.24539790932745267,0.5268786568327293 L -0.2585786437626906,0.5414213562373096 L -0.2731213431672709,0.5546020906725474 L -0.28888595339607964,0.5662939224605091 L -0.3057206526348005,0.576384252869671 L -0.323463313526982,0.5847759065022573 L -0.3419430645491076,0.5913880671464418 L -0.3609819355967744,0.5961570560806462 L -0.380396571934088,0.5990369453344394 L -0.4,0.6000000000000001 L -0.4196034280659121,0.5990369453344394 L -0.43901806440322577,0.5961570560806461 L -0.45805693545089254,0.5913880671464418 L -0.4765366864730181,0.5847759065022573 L -0.49427934736519963,0.576384252869671 L -0.5111140466039205,0.566293922460509 L -0.5268786568327292,0.5546020906725474 L -0.5414213562373096,0.5414213562373096 L -0.5546020906725475,0.526878656832729 L -0.5662939224605091,0.5111140466039205 L -0.576384252869671,0.4942793473651996 L -0.5847759065022574,0.47653668647301795 L -0.5913880671464418,0.45805693545089243 L -0.5961570560806462,0.4390180644032257 L -0.5990369453344394,0.41960342806591217 L -0.6000000000000001,0.4 L -0.5990369453344394,0.3803965719340879 L -0.5961570560806462,0.3609819355967743 L -0.5913880671464418,0.34194306454910756 L -0.5847759065022574,0.32346331352698204 L -0.576384252869671,0.3057206526348004 L -0.5662939224605091,0.2888859533960796 L -0.5546020906725474,0.2731213431672709 L -0.5414213562373096,0.25857864376269046 L -0.526878656832729,0.2453979093274526 L -0.5111140466039205,0.23370607753949094 L -0.4942793473651996,0.223615747130329 L -0.47653668647301795,0.21522409349774266 L -0.45805693545089243,0.20861193285355822 L -0.43901806440322566,0.20384294391935392 L -0.41960342806591217,0.20096305466556064 L -0.4,0.2 L -0.3803965719340879,0.20096305466556064 L -0.3609819355967744,0.20384294391935392 L -0.34194306454910756,0.20861193285355825 L -0.32346331352698204,0.21522409349774266 L -0.30572065263480047,0.22361574713032903 L -0.2888859533960796,0.23370607753949096 L -0.2731213431672709,0.24539790932745262 L -0.25857864376269046,0.2585786437626905 L -0.24539790932745262,0.2731213431672709 L -0.23370607753949096,0.2888859533960796 L -0.223615747130329,0.30572065263480047 L -0.21522409349774266,0.32346331352698204 L -0.20861193285355825,0.34194306454910756 L -0.20384294391935392,0.3609819355967744 L -0.20096305466556064,0.3803965719340879 L -0.2,0.4 L -0.20096305466556064,0.4196034280659121 z\" /></g></svg>"
      ],
      "text/plain": [
       "<POLYGON ((0.957 -0.29, 0.924 -0.383, 0.882 -0.471, 0.831 -0.556, 0.773 -0.6...>"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "face = draw.shapely.geometry.Point(0, 0).buffer(1)\n",
    "eye = draw.shapely.geometry.Point(0, 0).buffer(0.2)\n",
    "eye_l = draw.translate(eye, -0.4, 0.4)\n",
    "eye_r = draw.translate(eye, 0.4, 0.4)\n",
    "\n",
    "smile = draw.shapely.geometry.Point(0, 0).buffer(0.8)\n",
    "cut_sq = draw.shapely.geometry.box(-1, -0.3, 1, 1)\n",
    "smile = draw.subtract(smile, cut_sq)\n",
    "face = draw.subtract(face, smile)\n",
    "face = draw.subtract(face, eye_r)\n",
    "face = draw.subtract(face, eye_l)\n",
    "face"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "77be945d",
   "metadata": {},
   "source": [
    "Once you are happy with your geometries, and have them properly parameterized to allow the Front End User as much customization of your component as you wish, it is time to convert the geometries into Metal `qgeometries` via `add_qgeometry`"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8018268d",
   "metadata": {},
   "source": [
    "#### add_qgeometry"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "id": "01c94df9",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.111918Z",
     "iopub.status.busy": "2026-06-02T03:56:30.111847Z",
     "iopub.status.idle": "2026-06-02T03:56:30.128063Z",
     "shell.execute_reply": "2026-06-02T03:56:30.127658Z"
    }
   },
   "outputs": [],
   "source": [
    "import qiskit_metal as metal\n",
    "\n",
    "?metal.qlibrary.core.QComponent.add_qgeometry\n",
    "import qiskit_metal as qm"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "9c03fabd",
   "metadata": {},
   "source": [
    "`add_qgeometry` is the method by which the shapely geometries you have drawn are converted into Metal qgeometries, the format which allows for the easy translatability between different renderers and the variable representation of quantum elements such as Josephson junctions.\n",
    "\n",
    "Currently there are three kinds of qgeometries, `path`, `poly` and `junction`.\n",
    "`path` -> shapely LineString\n",
    "`poly` -> any other shapely geometry (currently)\n",
    "`junction` -> shapely LineString\n",
    "\n",
    "Both `path` and `junction` also take and input of `width`, with is added to the qgeometry table to inform renderers of, as an example, how much to buffer the LineString of a cpw transmission line to turn it into a proper 2D sheet.\n",
    "\n",
    "`subtract` indicates this qgeometry is to be subtracted from the ground plane of that layer#. A ground plane is automatically included for that layer at the dimension of the chip size if any qgeometry has `subtract = True`. As an example, a cpw transmission line's dielectric gap could be drawn by using the same LineString as previously, having the `width = cpw_width + 2*cpw_gap` and setting `subtract = True`.\n",
    "\n",
    "`fillet` is an option that informs a renderer that the vertices of this qgeometry are to be filleted by that value (eg. `fillet = \"100um\"`). "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "a81c77ea",
   "metadata": {},
   "source": [
    "#### add_pin"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "id": "bd5ecc4b",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.129270Z",
     "iopub.status.busy": "2026-06-02T03:56:30.129199Z",
     "iopub.status.idle": "2026-06-02T03:56:30.131650Z",
     "shell.execute_reply": "2026-06-02T03:56:30.131299Z"
    }
   },
   "outputs": [],
   "source": [
    "?metal.qlibrary.core.QComponent.add_pin"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "ff4e94a3",
   "metadata": {},
   "source": [
    "The final step for creating your QComponent is adding of pins. This is not necessarily a requirement for your component, but to have full functionality with Metal and be able to make use of auto-routing components with it, you will want to indicate where the \"ports\" of your component are.\n",
    "\n",
    "Following from the above docstring, pins can be added from two coordinates indicating either an orthogonal vector to the port plane of your component, or a tangent to the port plane of your component. For the former, you want the vector to be pointing to the middle point of your intended plane, with the latter being across the length of your intended plane (as indicated in the above figure). The `width` should be the size of the plane (say, in the case of a CPW transmission line, the trace width), with the `gap` following the same logic (though this value can be ignored for any non-coplanar structure). "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "27ce9b7b",
   "metadata": {},
   "source": [
    "## Example"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "2527e2e7",
   "metadata": {},
   "source": [
    "\n",
    "\n",
    "Below is a simple QComponent that implements everything we have reviewed."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "id": "45497ff2",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.132863Z",
     "iopub.status.busy": "2026-06-02T03:56:30.132796Z",
     "iopub.status.idle": "2026-06-02T03:56:30.137066Z",
     "shell.execute_reply": "2026-06-02T03:56:30.136765Z"
    }
   },
   "outputs": [],
   "source": [
    "from qiskit_metal import draw, Dict\n",
    "from qiskit_metal.toolbox_metal import math_and_overrides\n",
    "from qiskit_metal.qlibrary.core import QComponent\n",
    "\n",
    "\n",
    "class MySimpleGapCapacitor(QComponent):\n",
    "    \"\"\"\n",
    "    Inherits 'QComponent' class.\n",
    "\n",
    "    Description:\n",
    "        A simple CPW style gap capacitor, with endcap islands each coupled to their own\n",
    "        cpw transmission line that ends in a pin.\n",
    "\n",
    "    Options:\n",
    "        * cpw_width: width of the cpw trace of the transmission line\n",
    "        * cpw_gap: dielectric gap of the cpw transmission line\n",
    "        * cap_width: width of the gap capacitor (size of the charge islands)\n",
    "        * cap_gap: dielectric space between the two islands\n",
    "        * pos_x/_y: position of the capacitor on chip\n",
    "        * orientation: 0-> is parallel to x-axis, with orientation (in degrees) counterclockwise.\n",
    "        * layer: the layer number for the layout\n",
    "\n",
    "\n",
    "    \"\"\"\n",
    "\n",
    "    # Edit these to define your own tempate options for creation\n",
    "    # Default drawing options\n",
    "    default_options = Dict(\n",
    "        cpw_width=\"15um\",\n",
    "        cpw_gap=\"9um\",\n",
    "        cap_width=\"35um\",\n",
    "        cap_gap=\"3um\",\n",
    "        pos_x=\"0um\",\n",
    "        pos_y=\"0um\",\n",
    "        orientation=\"0\",\n",
    "        layer=\"1\",\n",
    "    )\n",
    "    \"\"\"Default drawing options\"\"\"\n",
    "\n",
    "    # Name prefix of component, if user doesn't provide name\n",
    "    component_metadata = Dict(\n",
    "        short_name=\"component\",\n",
    "        _qgeometry_table_poly=\"True\",\n",
    "        _qgeometry_table_path=\"True\",\n",
    "    )\n",
    "    \"\"\"Component metadata\"\"\"\n",
    "\n",
    "    def make(self):\n",
    "        \"\"\"Convert self.options into QGeometry.\"\"\"\n",
    "\n",
    "        p = self.parse_options()  # Parse the string options into numbers\n",
    "\n",
    "        pad = draw.rectangle(p.cpw_width, p.cap_width, 0, 0)\n",
    "        pad_left = draw.translate(pad, -(p.cpw_width + p.cap_gap) / 2, 0)\n",
    "        pad_right = draw.translate(pad, (p.cpw_width + p.cap_gap) / 2, 0)\n",
    "        pad_etch = draw.rectangle(\n",
    "            2 * p.cpw_gap + 2 * p.cpw_width + p.cap_gap, 2 * p.cpw_gap + p.cap_width\n",
    "        )\n",
    "        cpw_left = draw.shapely.geometry.LineString(\n",
    "            [\n",
    "                [-(p.cpw_width + p.cap_gap / 2), 0],\n",
    "                [-(p.cpw_width * 3 + p.cap_gap / 2), 0],\n",
    "            ]\n",
    "        )\n",
    "        cpw_right = draw.shapely.geometry.LineString(\n",
    "            [[(p.cpw_width + p.cap_gap / 2), 0], [(p.cpw_width * 3 + p.cap_gap / 2), 0]]\n",
    "        )\n",
    "\n",
    "        geom_list = [pad_left, pad_right, cpw_left, cpw_right, pad_etch]\n",
    "        geom_list = draw.rotate(geom_list, p.orientation)\n",
    "        geom_list = draw.translate(geom_list, p.pos_x, p.pos_y)\n",
    "        [pad_left, pad_right, cpw_left, cpw_right, pad_etch] = geom_list\n",
    "\n",
    "        self.add_qgeometry(\n",
    "            \"path\",\n",
    "            {\"cpw_left\": cpw_left, \"cpw_right\": cpw_right},\n",
    "            layer=p.layer,\n",
    "            width=p.cpw_width,\n",
    "        )\n",
    "        self.add_qgeometry(\n",
    "            \"path\",\n",
    "            {\"cpw_left_etch\": cpw_left, \"cpw_right_etch\": cpw_right},\n",
    "            layer=p.layer,\n",
    "            width=p.cpw_width + 2 * p.cpw_gap,\n",
    "            subtract=True,\n",
    "        )\n",
    "        self.add_qgeometry(\n",
    "            \"poly\", {\"pad_left\": pad_left, \"pad_right\": pad_right}, layer=p.layer\n",
    "        )\n",
    "        self.add_qgeometry(\"poly\", {\"pad_etch\": pad_etch}, layer=p.layer, subtract=True)\n",
    "\n",
    "        self.add_pin(\n",
    "            \"cap_left\",\n",
    "            cpw_left.coords,\n",
    "            width=p.cpw_width,\n",
    "            gap=p.cpw_gap,\n",
    "            input_as_norm=True,\n",
    "        )\n",
    "        self.add_pin(\n",
    "            \"cap_right\",\n",
    "            cpw_right.coords,\n",
    "            width=p.cpw_width,\n",
    "            gap=p.cpw_gap,\n",
    "            input_as_norm=True,\n",
    "        )"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "id": "119fddc5",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:30.138179Z",
     "iopub.status.busy": "2026-06-02T03:56:30.138115Z",
     "iopub.status.idle": "2026-06-02T03:56:31.197637Z",
     "shell.execute_reply": "2026-06-02T03:56:31.197147Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div style='border-left:4px solid #6929C4;padding:8px 12px;background:#f4f1fb;color:#222;font-family:sans-serif;font-size:13px;line-height:1.4;margin:4px 0;'><b>Quantum Metal — headless viewer active.</b> Rendering inline via <code>qm.view(design)</code>; <code>gui.rebuild()</code>, <code>gui.screenshot()</code>, <code>gui.edit_component(...)</code> work as in the desktop GUI.<br>For the full desktop experience (Qt window, dockable panels): <code>pip install 'quantum-metal[gui]'</code> and re-import.</div>"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "design = metal.designs.DesignPlanar()\n",
    "\n",
    "gui = qm.gui(design)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "id": "331f642d",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:31.198820Z",
     "iopub.status.busy": "2026-06-02T03:56:31.198746Z",
     "iopub.status.idle": "2026-06-02T03:56:31.481936Z",
     "shell.execute_reply": "2026-06-02T03:56:31.480981Z"
    },
    "tags": [
     "nbsphinx-thumbnail"
    ]
   },
   "outputs": [
    {
     "data": {
      "image/png": "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Qwlz6SySU6V210qi1e57vMRZ3633aXB/dRBS8xMl9HpodBQ3oxcAAACQyWRbVKutWdiWL19ux8nWv6fbG1612pqsQsvRUGCqKR+POlFq0gWNz61Z0jQNs8bqBQAAADI7zrajWmw91DTk5JNPjmXYqba2Nltjfu+999qZ0Sai9t/qIKmpaY8++mhz+umnT/v7AQAAAC+SbTXXUGdEtb1Wkw61w46DkmaN2f2Vr3zFtu8ej5qNaDIcDQeo9WBsXgAAAASTbIvaVp9zzjl2nOzzzz/f/Nd//Zcdmm861HTk0ksvtaOYaCpn1ZyrmUg0ydY42+9617vMZz/7WZucaxZKAAAAIJg2246G9dOsb0qANXLIscceaxNgdXDUhDPz5s2zHSYrGftaCbUmztFY3itXrjQf+tCHzKGHHmp+85vf2Elr/vu//9vWpB911FHmX//1X81BBx2UxKYBAAAA6SbboiH5lHBrjG0l2/qr5h3z58+3CbcmtdFfDQuoIf00rbuG89MU60rCNcKImqNounUN4afxuT/xiU/Y8bP1usblVptwjcGtxFrTtCuxVzOSF73oRUltFgAAAJB+si2qhdbsj0qCr7zySpsg67mHHnpoZGIb1UZrEhvVdKuDo9p9u2RbibZGGFGTESXWGldbz8nq1avNl770JbvMT3/603bCHP3/n//5nye5SQAAAIAfybY8+OCD5gMf+ICt2f6rv/or84Y3vMEmyEqilTyrtlu11kq058yZY2eM1MyTqrFWTbf+rec0M+SPf/xj2/FS71UzEo06cvXVV9tE/Atf+IIdCQUAAAComWRbtmzZYv7mb/7G3HzzzTYhVmfHF77whbYW++c//7n57W9/a6daV9OS6AQ0qsVeu3atueWWW2xTlFe+8pV2shzVjGuyml/84hd2SvarrrrK1nQDAAAANZdsu8T5P//zP80111xjm5CoXbUmq1HifNNNN9kJa4455pgxnSafeeYZ8+Y3v9km5694xSvsezV5zrJly2yNuZJ0tfMGAAAAajbZdtQsRKOHfOc737Htt9VERO22NcKIRizRZDRq46123GqHraYjamai59Rc5IgjjrDTwZ955plm4cKFM736AAAAgL/JtqORRlTDfdddd5l77rnHPPbYYyMdJtU5Mp/P2wRbbbcPO+wwW7OtWSnXrFlDTTYAAAC8l2qyHeVGHtEQf9u3b7f/VidIdYDUdO2q0db/AwAAAFnhTbINAAAAhCaR6doBAAAAkGwDAAAAiaFmGwAAAEgIyTYAAACQEJJtAAAAICEk2wAAAEBCSLYBAACAhJBsAwAAAAkh2QYAAAASQrINAAAAJIRkGwAAAEgIyTYAAACQEJJtAAAAICEk2wAAAEBCSLYBAACAhJBsAwAAAAkh2QYAAAASQrINAAAAJIRkGwAAAEgIyTYAAACQEJJtAAAAICEk2wAAAEBCSLYBAACAhJBsAwAAAAkh2QYAAAASQrINAAAAJIRkGwAAAEgIyTYAAACQEJJtAAAAICEk2wAAAEBCSLYBAACAhJBsAwAAZMTVV19t/vCHP8zY9/3VX/2VeeKJJ+y/b7vtNnP99dcbX3zuc58zDz30kPFdfdorAAAAAFTqox/9qMkCarYBAACAKgwPD0/6Hmq2AQAAMmT79u3mi1/8otm6datZvny5Oeecc8y8efPsa3v37jX//u//bh5//HGTy+XMH/3RH5kzzzzT1NfXm/7+fvPP//zP5plnnjFDQ0Nm2bJl5nWve51dhhQKBXP77beb3/72tyafz5uXv/zlE67HRN/V3d1t/vVf/9U8+eSTplgsmoULF5rzzz/fzJ8/39x33332e/T5pqYm88d//Mfmz//8z8cs//Of/7x52cteZl74wheOPPeNb3zDHHzwwXbd1KTmrLPOMs973vPsa2vXrjU/+clP7P5pb283r371q80xxxxjOjs77Xs/9alP2e/7r//6L3PzzTfbmvElS5bYpij63Ec+8pEJlyP/8i//YrdV+/LRRx81r3rVq8yf/umfTrifSLYBAAAyRMnqO9/5TtPW1mb+4R/+wbalfutb32qT2m9961tm9erV5uMf/7gZHBw0//iP/2h+9rOfmVe+8pX29eOPP96ce+65Npn+8Y9/bG644QbzsY99zCaQv/vd7+zjfe97n03ev//979ukspzJvuuOO+6wyftf//Vf2+R78+bNNtHV8pSwvve97zWHHHKI6e3ttUltOS94wQvstrpkW0mzEvs3vvGNY967adMm80//9E82oddyn376afPNb37TfPCDHzSLFy+2yf5TTz1ljjzySLuMBQsW2LboSrb1/4cddtiUliMPPPCAueCCC8x5551nL1omQzMSAACADPmTP/kTmyw2NDSYE044waxfv94+r787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Jtu7du0y73znO+3MhMuXLzcXX3zxpJ0pNLX1hz70IbNq1SqzZMkS87a3vc1s3bp15PU//OEP5vzzzzdr1qwxCxcuNMcff7y57rrrZmBrAACAa+Zw6KGH2rG2AR/UbLL9rne9yzzyyCPmlltuMd/73vfMXXfdZS699NIJP/PRj37U3HrrreaGG24wt912m9myZYs555xzRl5/4IEHzKJFi8w3v/lN87vf/c585CMfMVdddZX52te+NgNbBFROhdHBBx9MGzwAwdBkNs3NzUwdD2/kurq6aq7LrkZfeMELXmB+/etf29pn+dnPfmZe//rXm7Vr19ra7lJ79uwxBx10kLn++uvN6173OvvcY489Zk444QTzi1/8wpx44ollv0s14XrfT3/603HXp7+/3z6cvXv32trxDRs2mLa2tlEnkHKDyZd73k2bW8nzUtouerzn9Z16rpLnp7rupc+75em5SrfV122ayrrP1DY9++yz9rfmllOubXzSz0efm2zUmbTWsdLnK1EL2+T+PV58s7hNvj5fiTjXJXq+cnFOY5uGh4ft3AHPf/7zbdJdK+fymdgm9z3ue0PYpunESbnhihUrzKZNm0bla6VqcoiHe+65x8ydO3ck0ZZTTjnFBkY10q95zWvGfEa11pqGVu9zlBBrSDotb7xku7Oz08ybN2/C9bnmmmvMZz7zmTHPP/PMM2b27Nn23wqias137txpl+lo2fPnz7fNWXp6ekae13v1mY0bN44a1k0XEppVS8uO/qi0Hbr1po6IUatXr7YdXtavXz/ynPaTnu/t7TWbN28eeV4zEWo5uljYvn37yPP6Pn3v7t27TUdHx8jzlWyTTp5qutPe3h7MNvkQJ92d0UOfraurs8vW90W/U8vRa+M9r9hET0R6Tiei8Z4v7UDlera7591JrPR5R4WolqvlO/qM3j/e82lv02TP18I26d+hbVN03dmm0XHSfkkrTlqmzs06f+p8Vwvn8pncJjWT1fMhbdPSKuOk909FTdZsf/7znzff/e53bQIdpZrrj3/84+bCCy8c85l/+7d/MxdddJFt6x310pe+1Jx88snm6quvHvOZu+++25x++unm+9//vjn11FPHXR9qtie+ItXfp59+2v64XcEbcs3BTG6TTmh33nmnrf1x07anVbOtE5dOatRsh1uzrRiPN1tpFrfJ1+fTrNkuPY7T2CZVjCmJe8lLXjJSYRX6uXymtsmVx2p+WCqr2yTUbFfgyiuvNNdee+2E77nvvvvMTNDsVW9+85vN5ZdfPmGiLU1NTfZRyjWbKH2unLien+gWb7nnKnl+OusYXWYo2zSd5+PaJrf86HsqWXbcz4+3rmmsSxzPV6IWtsmH39h0+bbuvm1TueM4jW0arwwN9Vw+k9s0WVmcxW1yKt2m8d4fdDMSdXCMdlgsR7Wjao4QvT0huhrXrQm9Vs7ixYvtLQfdwlATFGfbtm1jPqOOl2eccYa54IILbKdKAAAA1Kagkm21xdFjMmpfraRZzUiOO+44+9yvfvUre1vhhS98YdnP6H26/XnHHXeYs846yz6nzpRqgxRtr/3www+bV7/61Tbp10gkiMdUrx4BALVN5YVygfGaLGH6+xeVqck9dsQRR5jTTjvNXHLJJebee+81v/3tb81ll11mzj777JGRSNSzVAm2Xhd1zHv7299um4UoMVei/t73vtecdNJJI8m2mo686lWvss1GVMuuhvl6lNaiozKuIwUHePxUGKkTSdr7VrfotC5x3T6Gf4hx+HyJsdqM645zueaZmB7K4+oEVbNdiW9961s2wVZzD/14Xvva19qOk9EOFo8//vioXqyf+9zn7HvPPfdc26lRSfUXv/jFkdd/+MMfmh07dpgbb7zRPhxNgqMab1RHnSTU2UVjQqd9Eg+NCqNly5aN6iWeBtcZZqpttpE9xDh8vsRYd6m7u7tHOmsiPpTH1anJ0Uh8p+FrlABNNm5jrdCJU8PuULsdPw299cQTT9i+B2nWblcyGgmyiRiHz5cYq3+VKmg0Ulh0NBJMH+VxdflaTTYjAbCPCqQnn3xyzDi1AAAgHiTbAAAAQEJItpEJbhYwhIvmI+EjxuEjxuGjPK4cPQfgPbUl1pSpCLuApiNT2Ihx+HyKsQ+jooSI8rg61GwjE51u1AlhulP4YiwVRnV1danvGsVWHW+IcbiIcfh8ibFqXtesWWNaW1tTXY8QUR5Xh2QbmTi4NVZ52ifwEKkwOvLII724LaiRURA2Yhw+Yhw2yuPqkGwDAIBgaOi/xx57zI61DfiAZBuoYZq0SZM3aRInAAiFzmncDYUvSLaRCS0tLWmvQpDUvlKzofpQKNGZKXzEOHzEOHyUx5Xzo9swMEnv56VLl7KPAubTKAZIBjEOHzEOH+VxdajZRiZqX3ft2mX/IkyqWVfHKh9q2JEMYhw+Yhw+yuPqkGwjEzo6OtJeBSSMi6nwEePw+RBj3SVbvXq1aW5uTntVgkR5XDmSbaCGqTBatWoVTTgABNXUQcOa0jQNviDZBmqYCqO2tjZbOAFACIaGhszWrVtt52/AB5SwyAQlhEhmPFpNGOTDRBQk/OEjxuHzIcZqyqLzGkOaJoPyuHLpHxXAFE7eixYt8uIkHmKyrRqgtJNtN208w4aFixiHjxiHj/K4OmQv8J6rpfCh4w2SwSgG4SPG4SPG4aM8rg7JNjKhs7Mz7VVAwriYCh8xDh8xDh/lceVItgEAQFBNHebNm8doJPAGyTZQ46ORtLe30x4eQFDnteXLlzPONrxBso1MUC0Fkhlne+XKlV7UANEBNnzEOHw+xFhNWfr6+lLv+B0qyuPKpX9UAFM4ec+fP9+Lk3hoVChpeKy0p0lnFIPwEePw+RJjjbP9xBNPmN7e3lTXI0SUx9Uhe0EmEsLNmzfT8SYBPT095rHHHkt9PFol+yog0076kRxiHD5iHD7K4+qQbCMzSSHCRqIdPmIcPmIcPsrjypFsAwAAAAkh2QYAAEFJu904EJX+EATAFE6amq6dk2fY1LEKYSPG4fMhxo2NjeaQQw4xs2fPTntVgkN5XB1qtpGJg7utrY1kOwGtra3mqKOOMg0NDSbtGKuXOxdU4SLG4SPG4aM8rg7JNjLR+3n9+vWMRhJw4cgoBuEjxuHzJcYaXenJJ5+kI18CKI+rQ7KNTBgYGEh7FYKkcWjXrVuX+tB/knYBjeQR4/D5EGOtg85tSgwRP8rjypFsAzVMM6x1d3d7UUACABAiOkgCGFNToaYlmsJdSXi5Wm91QJJys0+qg5QeSuRLp0tWcxW1Dy9drv5fDzf7XLXLHa/WRduibdIt7tLaLretel6vj7etSS03rn3o6LUk9qFbbrltdcstt63R5eo79Z5os6Wk9qFbbrltnez3Pd19ONlyp7MPZ/J3WOk+dMexvqupqSm13zc12vANyTa8pxPr0qVLU29XHCIVtM3Nzaavr2/U1MZz5841K1asMP39/ebxxx8f8zn19JennnpqzJTI+pw+v3PnTjvzZ5RGB1i5cqUtYB955JExyz3ooINsYfrss8+azs7OUa8dcMABZuHChWbPnj22DX/UrFmz7HLloYceGlMIH3rooXY7N27caDo6Oka9ppFulixZYmv41aQmSuvitrXcTJurV6+2nUy3bt1qtm/fPuq1efPmmeXLl9t9q6mjo/RbdstV29LSfahtaW9vNzt27DBbtmwZ9Zo6C+t1JU6PPvpo2X2ohOPpp582XV1do17TcbRgwQKze/dus2HDhlGvtbS0jOzDBx98cMxyFVclUPqcPh+1ePFi+9i7d6955plnxvzGDj74YBsT7cPShE+v6bu1ndreqPnz55tly5bZ/aP9FKVtdPtQv1H9VqNWrVpl95XiovhEad9qWxVPrVMpxVXJpH4PpRN4KKaKrX5H+j1F6beg5SrZe/jhh8csV+uk35R+v/odR+k3qN+ifvf6/Udpv2s/iY6b0gRV+0HHwKZNm8yuXbtGvaZjRseOtkPHa5SSZbcP165dOyaRP/DAA82cOXPMtm3b7CNqsnOEjrkkzhFaJ633ROcI7QM9fBgZJTSUx9XJdXV1cf/YMzqBqIDRiVOFBZAkFbClhawKMyWnShrKzRbmhtTSa6W1SEoMlFCUW64KPyUFSryU3JZS0qUkR4VzaUKhpE0PJUiliZU+o89KaYIp+k59txLf0mRP66p11vN6vbRgUQIl5ZrbaB9pX2l9ShNxtw+1HaXJRhz7cLzYaH213nHvQxebcvvQLbeafehiU24futiU24fR5Zbbhy421fy+J9qHLjbl9uFUf9+V7sNobJLahxP9vrN4jtB+1HIAH/I1km0PkWyPphO1astUo6GTLMJDjMNHjMNHjMNHjKvL18hckAm0wQsfMQ4fMQ4fMQ4fMa4cyTYAAACQEJJtAAAAICEk2/CeOvGodzqjkYSLGIePGIePGIePGFeHZBuZoJ7vCBsxDh8xDh8xDh8xrhzJNrynIaA03i2zHIaLGIePGIePGIePGFeHZBsAAABICMk2AAAAkBCSbQAAACAhJNvIRO/n1atXMxpJwIhx+Ihx+Ihx+IhxdUi2kQlDQ0NprwISRozDR4zDR4zDR4wrR7KNTPR+Xr9+PaORBIwYh48Yh48Yh48YV4dkGwAAAEgIyTYAAACQEJJtZEI+z081dMQ4fMQ4fMQ4fMS4crmurq5iFZ9Dgjo7O82yZcvMpk2bTFtbG/saAAAgo/ka1YXIRIeMnp4eOkgGjBiHjxiHjxiHjxhXh2QbmTi4N2/eTLIdMGIcPmIcPmIcPmJcHZJtAAAAICEk2wAAAEBCSLaRCY2NjWmvAhJGjMNHjMNHjMNHjCtXX8VngBkfZmjlypXs9YAR4/AR4/AR4/AR4+pQs41MdMjQ8Dr6izAR4/AR4/AR4/AR4+qQbCMTB/f27dtJtgNGjMNHjMNHjMNHjKtDsg0AAAAkhGQbAAAASAjJNjKhpaUl7VVAwohx+Ihx+Ihx+Ihx5RiNBJno/bx06dK0VwMJIsbhI8bhI8bhI8bVoWYb3isUCmbXrl32L8JEjMNHjMNHjMNHjKtDso1M6OjoSHsVkDBiHD5iHD5iHD5iXDmSbQAAACAhJNsAAABAQki2kQltbW1prwISRozDR4zDR4zDR4wrx2gkyETv50WLFqW9GkgQMQ4fMQ4fMQ4fMa4ONdvIRO9nTdfOaCThIsbhI8bhI8bhI8bVIdlGJnR2dqa9CkgYMQ4fMQ4fMQ4fMa4cyTYAAACQEJJtAAAAICEk28iEefPmpb0KSBgxDh8xDh8xDh8xrhyjkSATvZ/nz5+f9mogQcQ4fMQ4fMQ4fMS4OtRsIxO9nzdv3sxoJAEjxuEjxuEjxuEjxtUh2UYm9PT0pL0KSBgxDh8xDh8xDh8xrhzJNgAAAJAQkm0AAAAgISTb8F4ul7PTtesvwkSMw0eMw0eMw0eMq8NoJMjEwd3W1pb2aiBBxDh8xDh8xDh8xLg61GwjE72f169fz2gkASPG4SPG4SPG4SPG1SHZRiYMDAykvQpIGDEOHzEOHzEOHzGuHMk2AAAAkBCSbQAAACAhJNvIRIeMpUuXMhpJwIhx+Ihx+Ihx+IhxdRiNBJk4uFtaWtJeDSSIGIePGIePGIePGFeHmm1kovfzunXrGI0kYMQ4fMQ4fMQ4fMS4OiTbyMwBjrAR4/AR4/AR4/AR48qRbAMAAAAJIdkGAAAAEkKyjUx0yFi5ciWjkQSMGIePGIePGIePGFeHZBuZUF/PwDmhI8bhI8bhI8bhI8aVI9mG94rFoh2NRH8RJmIcPmIcPmIcPmJcHZJtAAAAICEk2wAAAEBCSLYBAACAhJBsIxO9n1evXs1oJAEjxuEjxuEjxuEjxtUh2UYmDA0Npb0KSBgxDh8xDh8xDh8xrhzJNjLR+3n9+vWMRhIwYhw+Yhw+Yhw+Ylwdkm0AAAAgISTbAAAAQEJItpEJ+Tw/1dAR4/AR4/AR4/AR48rlurq6mJbPM52dnWbZsmVm06ZNpq2tLe3VAQAAQJX5GtWFyESHjJ6eHjpIBowYh48Yh48Yh48YV4dkG5k4uDdv3kyyHTBiHD5iHD5iHD5iXB2SbQAAACAhJNsAAABAQki2kQmNjY1prwISRozDR4zDR4zDR4wrV1/FZ4AZH2Zo5cqV7PWAEePwEePwEePwEePq1GzN9q5du8w73/lOs3TpUrN8+XJz8cUXm66urgk/09fXZz70oQ+ZVatWmSVLlpi3ve1tZuvWrWXfu3PnTnP44Yeb2bNnm927dye0FbXTIUPD6+gvwkSMw0eMw0eMw0eMq1Ozyfa73vUu88gjj5hbbrnFfO973zN33XWXufTSSyf8zEc/+lFz6623mhtuuMHcdtttZsuWLeacc84p+973ve995phjjklo7Wvv4N6+fTvJdsCIcfiIcfiIcfiIcXVqMtl+9NFHzc9+9jNz3XXXmRe+8IXmj//4j80111xjbrrpJjvEXDl79uyxSfZnPvMZ87KXvcwcd9xx5u/+7u/M3Xffbe65555R7/37v/97W5v9/ve/f4a2CAAAAD6qyTbbSo7nzp1rjj/++JHnTjnlFNsW6Xe/+515zWteM+YzDzzwgBkcHLTvc9asWWPbEmt5J554on1OteWf/exnzR133GHWrVs3pfXp7++3D2fv3r32b6FQsA9H6xf9/4mez+Vy9lHJ81LaVGO85/Wdeq6S56e67qXP6290mSFs01TWvZa2ya1L9LWsb1O5da/lbXLHsXtvCNs0ledrbZtKj+MQtmkqz9fKNkWP41C2aTpxKve95dRksq121osWLRr1XH19vZk3b964bbC3bdtme+AqSY9avHjxyGeUMF9wwQXm05/+tE3Cp5psq1ZdNealnnnmGdvmWzQNqNZZbcHVftnROs+fP9+ug2ZZdPRefWbjxo1mYGBg5Hm1UW9pabHLjv5ItL7aB6XrvHr1ajM0NGTWr18/6ges53t7e0fdCdD+0XJ0saBmH46+T9+r2v6Ojo6R56e6TfqRd3d32zb17e3tQWxTiHGazjZpXRXjp59+euQklvVtCjFO09kmHcfq9yKhbFOIcZruNkWP41C2KcQ4VbtNOo613hLKNk0nTnr/VOS6urqC6XV25ZVXmmuvvXbC99x33322nfZ3v/tdW1sdddBBB5mPf/zj5sILLxzzuX/7t38zF110ke1YGfXSl77UnHzyyebqq682H/vYx+yP5p/+6Z/sa7/+9a/Nq171KrNhw4YxSfpkNduqNdfn9KNwuMqujZoDtok48dvjeOIcwbmc8qnofZmrJsYrVqwwmzZtGpWvBV2zrQ6O43VYjF6NaCSR6BWT6ApFV0t6rRzVYOsqSFdV0cRZNd7uM7/61a/MQw89ZH74wx+OCs6BBx5o/vIv/9JcccUVZZfd1NRkH+V+KHqUPldOXM+7H9BUnnc/zqk+X+066sfv9ruWG8I2Tff50LYpGuPS17O6TW59pvp86NtUGuMQtmkqz9fSNkm54zjL2xRinKbzvI5j5UrlztUTrbvP2zSV58fbpomOhWCTbd0eKG0eUo7aV+uEoJptdXR0ibJ+ROowWY7e19DQYNtin3XWWfa5tWvX2tsirr32d77zHXtLxLn//vvNe9/7XvMf//EfNslH9dzBjXAR4/AR4/AR4/AR48oFlWxP1RFHHGFOO+00c8kll5gvfelLtuPjZZddZs4++2zbbkd0S+DVr361HVnkBS94gW0r/Pa3v91cfvnlti2Qbhd8+MMfNieddNJIsn3wwQeP+h61IRI1CSFRBAAAqD01mWzLt771LZtgn3HGGfY2wGtf+1rz+c9/fuR1JeCPP/74qIb1n/vc5+x7zz33XNvG+tRTTzVf/OIXU9oCAAAA+C6oDpKhUI/aZcuWTdrgvlaoeY/uEixYsGDK7aOQLcQ4fMQ4fMQ4fMS4unytZmu2kR1KsKfSFh/ZRYzDR4zDR4zDR4yrQzUhMnElrdFjpjp4PLKHGIePGIePGIePGFeHZBuZEB2sHmEixuEjxuEjxuEjxpUj2QYAAAASQrINAAAAJIRkG5mgsc0RNmIcPmIcPmIcPmJcOUYjQSZ6P8+fPz/t1UCCiHH4iHH4iHH4iHF1qNlGJno/b968mdFIAkaMw0eMw0eMw0eMq0OyjUyIzuSJMBHj8BHj8BHj8BHjypFsAwAAAAkh2QYAAAASQrIN7+VyOTtdu/4iTMQ4fMQ4fMQ4fMS4OoxGgkwc3G1tbWmvBhJEjMNHjMNHjMNHjKtDzTYy0ft5/fr1jEYSMGIcPmIcPmIcPmJcHZJtZMLAwEDaq4CEEePwEePwEePwEePKkWwDAAAACSHZBgAAABJCso1MdMhYunQpo5EEjBiHjxiHjxiHjxhXh9FIkImDu6WlJe3VQIKIcfiIcfiIcfiIcXWo2UYmej+vW7eO0UgCRozDR4zDR4zDR4yrQ7KNzBzgCBsxDh8xDh8xDh8xrhzJNgAAAJAQkm0AAAAgISTbyESHjJUrVzIaScCIcfiIcfiIcfiIcXVItpEJ9fUMnBM6Yhw+Yhw+Yhw+Ylw5km14r1gs2tFI9BdhIsbhI8bhI8bhI8bVIdkGAAAAEkKyDQAAACSEZBsAgIDs3r3bbN++varPDgwM2M92d3dP6f07d+60DyCrOjs77W9+eHg4se+g1xky0ft59erVjEYSMGIcPmJsqk5++/r6zODgoJ1MRPtRHdQaGxvNrFmzvDovuhj39PSY3t5e097ebtezGnv37rXbvWDBApPPT14vqH2j79T+UtKktsX6XENDg2lpaclMpz4lfVrnuXPnmqwcx7rYchPdzJs3r+y+LhaLZteuXSPvmz9/vqmrq6tqHRTjPXv22Li2traaLMjGrw81b2hoyJ6AEC5iHD5iPHVKTrq6umzCKUpalcQoWVGyoZpnvaaEtjRpmTNnzox1KC9NChXjOGgbdc6fSqKtCxElX9pm7Yvm5mb7vJLu/v5++1BSpuQMyR7H+k3Onj27bDwLNTwTNM1I4D2dQNevX89oJAEjxuEjxpVxybQSbNUCKqlWwqhEWv+vxFHJpEsyo5RwzlRNrr7LJftxxdjV4k+lVjy6D5Tkad/orx7aZ6ppVcLu9iemZ6IYKwHXPi73Wl9fn60Nr9VKM2q2AQDwrOZQTSKUnChhLK3d1fNKvF3NrZptRG+nq822EtZFixaN+pyWqaQn2sxCSbmao0yW2Cr5VdtWLTdaS+zaa6u5h2j5Wh8tW0mwo/9375mMakGlqalp0vcqida2aH20HaW0fdqHHR0d9k6BlumaQOizWtdyzV20HWrKoosbV1MurqmKYhRt1qPvL11GtLmDXtP3af+5pFMXBO5Cxb1X9J5om3u3DpWur+KsphvaZq2D+37R5/X9iouei66b3q/XKm2ipO/VOmhborEr7L8bo9cnahet92j/aj3c71Of0bqXxkz01/072jRFsXFNr9xvXc9rm/XbTaPpFTXbAAB4RAm0KHmcqBmFS3inUmOrRFMPJT4u+VLCp8TEJWDjUcLiEnglcxM1x1Di6Wov3feMlwhPtP1azmRtepVERffVROukdYm+v1puHypxc0m0a8Yy3rL1uvafW0+tjxJLPedqgbWtbr8q5m6/6VFt22ZH6+u+S8mrvl/rqosntx5KQLVu+i6XuFfKXciU/h779v9/9KKllJJs7UPtK9cfQeuiZDq6n/Tbcom8a4/vHi6J1rbpO12y7vo26Duiy5pJ1GwjE6bSbg/ZRozDR4ynxiW/k91yV9KkfapkSo+J9q9LPlT7V1qzN1FbWiXjSoL0nql0eNTrWm8l6Ep0Ku0gqc/pMZX21dH9NNlvS+9REqbPTJT0TaZcxz53MaJa13K18e4iJfq9SnRde3I9r2Wq1lXJpft3XErvRoi7eNJ6tLW1jay3ElHdBdB6jfebGm9fu1px/dain+3r67PbNN7vWb8xXcToPeoDEF2+q8lWohy9e6D10/LK7afS2vDSZbl9PpPIYOA9HXjq/UxBHS5iHD5iPHUu+Z3KOc+9ZzrDlo33Pa5GVgmYkqDJEuc4Yuxqh6eSpFeyn1yCPN1OeuVqmfWckkx3oVBKSWFpcuf+P64OpRNxNeXlvt/V+pcmzOOt22Qxdst1tdmuKUfzBMmte69r1hLlmn1UckdC8SjXVMTd/XDNlGYSNdvwnk70uqr1bZgrxIcYh48Yp8vVOKoNrxIfJYB6jHdOVZLk2l6rRnsqHS5djKdzm16JkBuyLwnTbUKgxFH7ZbzRNfRcaUJebt9FO5Umrdz3u6R2otfKbd9kx7HipmXqt6YEfypNSAb336HQ33JNmvQ9lV6UaB2VoOtzpfs4jVFRqNmG93SgbN68mdFIAkaMw0eMp26iZKfa2l3VGrpaQiWLahqyY8cO24yg3Pe45GYqbafjirHWQ8nWVDpGVrqfXI3zdNo/axlqYuGaRSjhdO2F3cVBuW2fqJJoJpLtib6/3GuTre9kMXa1/LogUcLb2Ng44e/Txc91eCx9VJocq725mqVoHVzbevdICzXbAAB4RImbq+WbqDlFdESMyZJIvcclHEpCtGwlja5tbul42Uok9Xx0lIuk7yy62/tTbeftElw3VOBECZ2rMZ1qsl0uwVPipySztP21aB9N1tE0ST6NYe1GTtE+0f6aNUnnWNfvYOHChdP+jbnfrOKsYR+jy9Nr0dFLZhI12wAAeMTV7OpW+ERJlEscKu3s5SZ+cZ3R3FBrpVxSqYTcJU5J0vdUMhZztH2x9tVEFyWuzW90X7lEbKKa/XK14+N1gkxapeubFv2mtI/cBVDjJBdPrilLHPvQxUjfWZq4p3kxRLKNTKh2yl9kBzEOHzGeGjf2tZJbNfco1+lONYcuOZ2s5lDLKZdo6PnJEuhowq0mJ5O9P9pkoJLaVi1XNdvlkqSJRJvGlEu4lYRqvcsNpeiS+tKh6rSvynXIc7XipftSsZhOB9Uobct4y6p0fdM8jhUXjXKix2Tc79c1/RivedFUOgW710pjpPdq+WmhGQm8p4Nn5cqVaa8GEkSMw0eMK6NkRQmo69SomkIley7xcImGkpmpjEetUUXczJKKhUtu3W3+iRJcJdyidXFDxZV7v4uxElwlv0pC9W+9V69NdFFQyUQ2UdomdeDURYmSKSXcLmHXd7vllhsmznUS1f5UW2w3ZKFL+ktHrdBFh/aBvkvr6e4K6HvKvb8aWo4SZ32Hq/HVd7nxyytZ3zSP4+jMopPRtqlPgeKn37q2RZ/Vb9M1eXKdekWvaT3cHReXYLuxud2+cPvITaqjf6cxEolQsw3v6YCbSo0KsosYh48YV0bJopJcJZJKttzoIG4GSDeN+1RqGd2Mky45dCM1KDHRdyjRmYyr4VayMt752MXYLddNJFI6018c7bWjlES5KezdpCpuxBDR9qnJTLkLBDfGtPapa7bj9nm579FrbsxuNwW5lj2V0VqmQusajbce0SYilaxvlo7jWbNm2f2o7XAzqGofl5sdVPtc+8FND+/2k1snveb6HGg5Wp7+fyq17EnJdXV1kcF4Rj/kZcuWmU2bNqX64/CFDph169Yx1nbAiHH4iHE8lDi42QjVAWy6swv6EmONjKKEtbSj5nSo1lPJmBKtqVxQYHIcx9Xla9RsAwCQEUpIVai7piFxtRVOk+ugGXftrBJs1X6qdlNNWoC00GYbAIAMUVMLJdyq5Vai6lPtdjWUEC9atCj25brmBq7j5GTDAwJJIdlGJqQ5GD1mBjEOHzGOj2qBZ6qdbpZjrOS6tGMkwopxFpBsw3s6WS5dujTt1UCCiHH4iHH4iHH4iHF1uJ8C7+nWn4YD8mmGLMSLGIePGIePGIePGFeHZBuZoPEyETZiHD5iHD5iHD5iXDmSbQAAACAhJNsAAABAQki2kQlM7hM+Yhw+Yhw+Yhw+Ylw5RiNBJno/JzEGK/xBjMNHjMNHjMNHjKtDzTYy0ft5+/btjEYSMGIcPmIcPmIcPmJcHZJtZEJnZ2faq4CEEePwEePwEePwEePKkWwDAAAACaHNtoeKxaL9u3fv3rRXxZvbVl1dXfZqWu3FEB5iHD5iHD5iHD5iPJrL01zeNh6SbQ8psZQ1a9akvSoAAACYJG9rb28f9/VcV1fXxOk4Urly3Lx5s5k9e7bJ5XI1HwFdOerC47HHHjNz5syp+f0RImIcPmIcPmIcPmI8mmq0lWgvXbp0wjvv1Gx7SAFbvnx52qvhHSXajO8ZNmIcPmIcPmIcPmL8nIlqtB0awAIAAAAJIdkGAAAAEkKyDe81NTWZyy+/3P5FmIhx+Ihx+Ihx+IhxdeggCQAAACSEmm0AAAAgISTbAAAAQEJItgEAAICEkGwDAAAACSHZBgAAABJCso3U7dq1y7zzne+0051q5syLL77YTn86kb6+PvOhD33IrFq1yixZssS87W1vM1u3bi373p07d5rDDz/czJ492+zevTuhrcBMx/gPf/iDOf/8882aNWvMwoULzfHHH2+uu+46AjGDvv71r5ujjjrKLFiwwLzsZS8z995774Tv/8EPfmCOO+44+/4TTzzR3H777WOmPr766qvNIYccYmN6xhlnmCeeeCLhrcBMxXhwcNB84hOfsM8vXrzYHHrooebCCy80mzdvJggBHcdR73//+23ZW+vnZpJtpO5d73qXeeSRR8wtt9xivve975m77rrLXHrppRN+5qMf/ai59dZbzQ033GBuu+02s2XLFnPOOeeUfe/73vc+c8wxxyS09kgrxg888IBZtGiR+eY3v2l+97vfmY985CPmqquuMl/72tcIygy46aab7Pj3etx55532GDvrrLPMtm3byr7/7rvvNhdccIF5xzveYeOvRPotb3mLeeihh0be84UvfMHG70tf+pK54447TGtrq12mLryQ/Rj39PSY3//+9/bY1vK++93vmscff9y86U1vmuEtQ5LHsaPzvc7NS5curfkdzjjbSNWjjz5qXvCCF5hf//rXtmZSfvazn5nXv/71Zu3atWUP0j179piDDjrIXH/99eZ1r3udfe6xxx4zJ5xwgvnFL35hr7Sdv//7vzff//73zcc+9jF7UtiwYYOZO3fuDG4hko5xlGrC9b6f/vSn7PiEqQZM8bz22mvt/xcKBXuX4aKLLjKXXXbZmPe//e1vt8mWCnfnlFNOMc973vPMl7/8ZVurrZpO1YR94AMfGPkdHHzwwTYBf+Mb30hMMx7jcu677z7z0pe+1F6Mr1y5MsGtwUzGeNOmTXbZP/zhD83ZZ59tK730qFXUbCNV99xzj01+XRLmDtx8Pm+viMtRjaZuR+p9jk4OOlFreY5O3p/97Gdtwq3lIbwYl+rs7DTz5s2LeQtQamBgwMYoGh/FU/8/Xnz0fPT9cuqpp468/+mnn7bNhKLvaW9vtxdqE8Uc2YnxeMdsLpezsUYYMVbC/u53v9teNKt5Cki2kTIVrmoKEFVfX28TpvHaYOv2VmNj45gaarUBdJ/p7++3t7o+/elPU1sSaIzL3d7UXQy1DUey1A9ieHjYxmOq8Sn3O4i+3/2tZJnIVoxLqXmQ2nDrrkVbW1uMa480Y6xacp3j1TcH+1Ddh0RceeWVtlPERA/d7k/KX//1X9uaULUlQ5gxjlJ7wTe/+c223aFqWQD4TXeu1CRBzYe++MUvpr06iIlqyr/61a/aTpe6Y4F96vf/BWKlzm/jdVh0Vq9ebUeZ2L59+6jnh4aGTEdHh32tHF1F6/aXRhaJ1nyqNtR95le/+pVNwNReTHRClwMPPND85V/+pbniiiumvY21Lu0YR5sLqT2+7mSo4xWSp1EI6urqxnSiKhcfp9zvIPp+91fPHXDAAaPec+yxxyawFZjpGEcT7fPOO888++yz5ic/+Qm12gHF+De/+Y19/Ygjjhh5fXh42FaEaESShx9+2NQiaraRCN1mUs3yRA81E1BHNyVUuhp2lCirzdcLX/jCssvWkEMNDQ12tAJHHe3Wr18/0nHuO9/5jvntb39rD3w93LBD//Ef/2H+4i/+gqgHEGPRiftVr3qVTfo1EglmhuKqGEXjo3jq/8frvKrno++XX/7ylyPvV4dYFdjR96g9r4YhG2+ZyFaMo4n2k08+aX70ox/ZhA/hxFh3k9Wkz5W9eixdutR88IMfHKn8qkXUbCNVuvo97bTTzCWXXGKH+9KJWD2g1XvZjVKhXs2vfvWrbUdHdZZSRxrdftSVstr9qq3fhz/8YXPSSSeNHPAawaC0bZooAWQ0kjBirDsX+szLX/5yW8vu2gyqg09pm0LET/F8z3veYzu+apQYXdBqlIJzzz3Xvq7xk5ctW2Y++clP2v9X+83TTz/djljwile8wo5mcP/994+MYKBbzhqt4G//9m/tONu6C/WpT33K/kbOPPNMQhhAjHXs67Ma/k+vKbFzx62OcyV/yHaMdfFUegHV0NBgL6Q130WtItlG6r71rW/Z5EtNAZQovfa1rzWf//znR17XCVpjseoE4Hzuc5+z79UJQZ0h1U6Xdn+1FWPVkuzYscPceOON9uFoEpxavVU5k3SxpP2vhFgJk5p63HzzzSO3k3UXIjoK0Ite9CI7lKMmrdFdCCXUitvRRx89aujG7u5ue/GkYf9e/OIX22U2Nzenso21Lu4Y66JazUZEsY3ScJ0nn3zyjG4fkjmOMRbjbAMAAAAJoc02AAAAkBCSbQAAACAhJNsAAABAQki2AQAAgISQbAMAAAAJIdkGAAAAEkKyDQAAACSEZBsAAABICMk2AAAAkBCSbQAAACAhJNsAAACAScb/BxfuyOy2m3VzAAAAAElFTkSuQmCC",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "my_cap = MySimpleGapCapacitor(design, \"my_cap\")\n",
    "gui.rebuild()\n",
    "gui.autoscale()\n",
    "gui.screenshot()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "0d6d12a6",
   "metadata": {},
   "source": [
    "You should now see *my_cap* in the Metal gui. One can work on the layout of the component through these cells by changing the above class, such as how the parameterized values are used. By enabling `overwrite_enabled` (which should normally be kept to False), the code can quickly be iterated through until you, the component designer, is happy with the qcomponent you have just created."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "id": "87ad7447",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:31.485634Z",
     "iopub.status.busy": "2026-06-02T03:56:31.485398Z",
     "iopub.status.idle": "2026-06-02T03:56:31.488652Z",
     "shell.execute_reply": "2026-06-02T03:56:31.487518Z"
    }
   },
   "outputs": [],
   "source": [
    "design.overwrite_enabled = True"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6c4e2263",
   "metadata": {},
   "source": [
    "We will delve into more complex QComponent topics in the next notebook, `Creating a QComponent - Advanced` </br>\n",
    "\n",
    "Use the command below to close Metal GUI."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "id": "c7e6e7e8",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-06-02T03:56:31.493022Z",
     "iopub.status.busy": "2026-06-02T03:56:31.492773Z",
     "iopub.status.idle": "2026-06-02T03:56:31.495867Z",
     "shell.execute_reply": "2026-06-02T03:56:31.495064Z"
    }
   },
   "outputs": [],
   "source": [
    "gui.main_window.close()"
   ]
  }
 ],
 "metadata": {
  "celltoolbar": "Tags",
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.11.14"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}