quantum_search.ipynb

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "8abdf70b-d128-46b5-8d44-1f340db2698f",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Common imports\n",
    "\n",
    "from qiskit import QuantumCircuit, transpile\n",
    "from qiskit.circuit import Gate\n",
    "from qiskit_aer import Aer\n",
    "from qiskit.visualization import plot_distribution"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "4f91632b-e3c7-49e0-aba1-198eb7e4825f",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Common tools\n",
    "\n",
    "from math import sqrt\n",
    "\n",
    "def run_simulation(qc: QuantumCircuit, shots: int = 2000):\n",
    "    # Running given QuantumCircuit on a simulator\n",
    "    backend_sim = Aer.get_backend('qasm_simulator')\n",
    "    job_sim = backend_sim.run(transpile(qc, backend_sim), shots=shots)\n",
    "    return job_sim.result().get_counts()\n",
    "\n",
    "def optimal_iterations(input_qubits: int) -> int:\n",
    "    return round(sqrt(2 ** (input_qubits - 1)))\n",
    "\n",
    "def generate_password(input_qubits):\n",
    "    # Generates a sequence of '0's and '1's of length given by input_qubits\n",
    "    return ''.join(random.choices(\"01\", k=input_qubits))\n",
    "\n",
    "def validate_password(password):\n",
    "    # A valid password is not empty and contains only '0' and '1' chars\n",
    "    # Returns: password length\n",
    "    if (len(password) == 0):\n",
    "        raise ValueError(f'Wrong password length: {len(password)}')\n",
    "    if (any(c not in \"01\" for c in password)):\n",
    "        raise ValueError(f'Wrong password contains chars other than 0 and 1')\n",
    "    return len(password)\n",
    "\n",
    "def reverse(s: str) -> str:\n",
    "    # String reverse\n",
    "    return s[::-1]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "6072f8ef-7280-4d22-a4ef-84b057597a45",
   "metadata": {},
   "outputs": [],
   "source": [
    "import random\n",
    "\n",
    "def StaticPredicateGate(password: str) -> Gate:\n",
    "    # Creates gate working as a predicate statically configured with given password.\n",
    "    # The number of qubits required by the gate equals password length plus one ancilla qubit.\n",
    "    # The ancilla qubit must be set to '0' at input.\n",
    "    # The gate sets the ancilla qubit to '1' for the input equal to password and '0' for all other inputs.\n",
    "    return StaticPredicateQC(password).to_gate()\n",
    "\n",
    "def StaticPredicateQC(password: str) -> QuantumCircuit:\n",
    "    input_qubits = validate_password(password)\n",
    "    all_qubits = input_qubits + 1\n",
    "    ancilla_qubit = all_qubits - 1\n",
    "    classical_bits = 0\n",
    "    \n",
    "    qc = QuantumCircuit(all_qubits, classical_bits, name='StaticPredicate')\n",
    "    password_to_gates(qc, password)\n",
    "    qc.mcx(list(range(input_qubits)), ancilla_qubit)\n",
    "    password_to_gates(qc, password)\n",
    "    return qc\n",
    "\n",
    "def password_to_gates(qc, password):\n",
    "    # Putting XGate (negation) for every '0' char and IGate (identity) for every '1' char\n",
    "    # Note: adding identity gate is optional\n",
    "    for i, k in enumerate(reverse(password)):\n",
    "        qc.x(i) if k == '0' else qc.id(i)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "72be5a33-ffb4-4582-b191-a5fc68ed2ea6",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Example password is '011'\n",
      "Number of all qubits is 3 input qubits plus 1 ancilla qubit\n",
      "Optimal number of quantum search iterations is 2\n"
     ]
    }
   ],
   "source": [
    "# Example: Generating a random search password for use in all following examples\n",
    "# Note: you need only change it here to update all examples\n",
    "# Note: when using input_qubits > 10 you should disable drawing the circuit CompleteCircuitWithOptimalIterationsQC down below\n",
    "\n",
    "input_qubits = 3\n",
    "password = generate_password(input_qubits)\n",
    "\n",
    "print(f\"Example password is '{password}'\")\n",
    "print(f\"Number of all qubits is {input_qubits} input qubits plus 1 ancilla qubit\")\n",
    "print(f\"Optimal number of quantum search iterations is {optimal_iterations(input_qubits)}\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "ca7117a6-2459-4e43-be4c-fedd4fb12fc8",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAATEAAAEvCAYAAAAtufaDAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8g+/7EAAAACXBIWXMAAA9hAAAPYQGoP6dpAAAb/klEQVR4nO3df3AU553n8XePhBASUvgh7AEkJLAQSICkBBmblNdeEcjBYkg2/sUeJnaWunKlzEElLHLiVMqVuqpgfmS9IaQSvFeON7tlTmc7l8IobOxEvkRmHa+IjM0PGQFGMiNpgAFho0ECjabvjzmwFQRohpnpeVqfV5WL0nQ/01/zPHzU/czTPZZt2zYiIobyOF2AiMitUIiJiNEUYiJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNEUYiJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNEUYiJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGS3e6ABmcbdtcDPc7XcaQZXnSsCzL6TJcw7T+B+fGgEIsRV0M9zO2/g2nyxiyrgWLyE7TcIoX0/ofnBsDupwUEaMpxETEaAoxETGaQkxEjKYQExGjKcRExGgKMRExmkJMRIymEBMRoynERMRoCjERMZpCTESMphATEaMNixALBALU1NRQXFxMZmYmBQUFrFu3jmAwyOrVq7Esi+3btztdpiSYHYa+XghdAtt2uhqJF9c/O2X//v0sWbIEv99PdnY2ZWVldHR0sG3bNo4fP865c+cAqKysdLbQJAm/9z79G76D57+tJu2hB5wuJyk+7gTffjh1BMKhyGsjRsHkcsivgMxcR8tLOreNAVeHWCAQYNmyZfj9ftavX88zzzxDTk4OAJs3b+app54iPT0dy7IoLy93uFqJt3AIDr8O/sPXbuvrgdZ3oPU/oeSvYcrcpJcnceLqy8m1a9fi8/lYs2YNW7duvRpgADU1NVRUVBAKhSgqKiI3d5j9OnY5OwwH6gYPsIE7Qsub0NaYlLIkAVwbYs3NzdTW1pKXl8fGjRsH3Wfu3Miv34qKigGvnzhxguXLl5OTk8PYsWP5+te/ztmzZxNes8RP+/tw5ujQ9z/6B+g+k7h6JHFcG2I7d+4kHA6zcuVKRo8ePeg+o0aNAgaG2IULF6iursbn87Fz506ef/55GhoauP/++wmHw0mpXW6NbcPJ/dG3870X91IkCVw7J1ZfXw9AdXX1dffx+XzAwBB7/vnnaW9v549//CNTpkwBID8/ny9+8Yvs2rWLr371q4krWuLi4w4IBqJv13kIpt8LaRnxr0kSx7Uh1tbWBkBhYeGg20OhEHv37gUGhtju3bu55557rgYYwPz585k2bRqvvfZaTCFWVVWF3++Pqo2dkQE7fhr1sZxSMr0E6/Jlp8sA4L7Z/5VvLNwcdbv+Prhr7r34uz5MQFXRMa3/4dbGgNfrZd++fTG1dW2IBYNBAHp6egbdXltbSyAQICcnh6lTp159/fDhwzz00EPX7D9r1iwOH77ZLPHg/H4/7e3t0TXKHMmImI7mjI7ODui95HQZAAQLL8bctuvsx7R3RtlXiWBY/4NzY8C1Ieb1eunq6qKpqYn58+cP2NbZ2cmGDRsAKC8vH/BdeV1dXYwZM+aa9xs3bhxHjhyJuZZo2RkZmDTPPGnipJQ5E0sbGf3cpW3bWJbFqJx0JnsmJ6CqKOsxrP/h1sZALP9GrnBtiC1cuJDm5mY2bdrEokWLKCkpAaCxsZFVq1YRCEQmTZKxyDWW0+Rgf8io7x1sOdqSMt872dcLDT//dGHrUFiWxecmwcEjf05cYVEwrf/BuTHg2k8na2pqGD9+PCdPnmTWrFnMmTOH6dOnM2/ePKZNm8aCBQuAa5dXjB07lvPnz1/zfufOnWPcuHHJKF1u0YhMmFgWfbv8yriXIkng2hDLz8+noaGBpUuXkpmZSWtrK+PGjWPHjh3U1dXR0tICXBtipaWlg859HT58mNLS0qTULreu8E5IHzn0/XNug9tKElePJE5qnP8nSGlpKbt3777m9e7ublpbW/F4PMyePXvAtvvvv5+nn34an89Hfn4+AO+88w7Hjx9ny5YtSalbbl3WWKj8W9j/fyI3fN9I9nio/BqkyNWwRMmy7eF3P/8777zD3XffzYwZM/jggw8GbPvkk0+YM2cOeXl5/OAHP6C3t5eamhomTJjA22+/jceTnJNX0+ZEuhYsSpk5sc8KnoXje+HMscitSJ+VPhImzoJpX4xcgqYS0/ofnBsDqTfqkuDAgQPAtZeSALm5udTX17Nu3TpWrFhBeno6999/P88991zSAkziJ3s8lC+HS92Rp1gcfyuyHix9JPzVE1rY6gYKsUHccccdg16GirlGjo48qaKtMRJiaSMUYG4xLE8tbhZiImKOYXkmduW+ShEx37A8ExMR91CIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNEUYiJitGF576QJsjxpdC1Y5HQZQ5blSXO6BFcxrf/BuTGgEEtRlmWl5EMGJTnU/0Ony0kRMZpCTESMphATEaMpxETEaAoxETGaQkxEjKYQExGjKcRExGgKMRExmkJMRIymEBMRoynERMRoCjERMZpCTESMphATEaMpxETEaAoxETGaQkxEjKbn36Yo27a5GO53uowhy/KkYVmW02W4hmn9D86NAYVYiroY7mds/RtOlzFkXQsW6ZnwcWRa/4NzY0CXkyJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNGGRYgFAgFqamooLi4mMzOTgoIC1q1bRzAYZPXq1ViWxfbt250uU0Ri4PoQ279/P3PmzGHLli34/X7Kysro6+tj27ZtPPLIIzQ3NwNQWVnpbKFJEn7vffq+/Df0v/yq06UkjW1D10lofgP6eiKvhS5B8JyzdTnFbWPA1c9OCQQCLFu2DL/fz/r163nmmWfIyckBYPPmzTz11FOkp6djWRbl5eUOVyuJcPYEtPxfCJ4d+Hp/H7z9AowrhJkLIWusI+VJHLj6TGzt2rX4fD7WrFnD1q1brwYYQE1NDRUVFYRCIYqKisjNzXWwUkkEfzO8+6trA+yzzrVB40vQfSZ5dUl8uTbEmpubqa2tJS8vj40bNw66z9y5cwGoqKi4+tqV0Js3bx4jR47U00oN9XEnHNoD2Dfft68nEnahSwkvSxLAtSG2c+dOwuEwK1euZPTo0YPuM2rUKGBgiB07doxXX30Vr9fLnXfemZRaJf7aGsEOD33/Sxeg41Di6pHEcW2I1dfXA1BdXX3dfXw+HzAwxO699146OzvZtWsXCxcuTGyRkhCXuuHM0ejb+fZHPgQQs7g2xNra2gAoLCwcdHsoFGLv3r3AwBDzeFz7VzJsnG2LLYwunoPeT+JfjySWaz+dDAaDAPT09Ay6vba2lkAgQE5ODlOnTk1oLVVVVfj9/qja2BkZsOOnCaoo/kqml2Bdvux0GQAsrPgGj1b/j5jafumvv8xHZw7HuaLomdb/cGtjwOv1sm/fvpjaujbEvF4vXV1dNDU1MX/+/AHbOjs72bBhAwDl5eUJn7z3+/20t7dH1yhzJCMSU05CdHR2QG9qzIz7J0X5d/0ZbSc/pONs7O3jxrD+B+fGgGtDbOHChTQ3N7Np0yYWLVpESUkJAI2NjaxatYpAIAAkZ5Gr1+uNuo2dkYFJn/pPmjgpZc7Eui5FphJs247qF9THwTOkZ/UzOXNyokobMtP6H25tDMTyb+QK14ZYTU0NL730EidPnmTWrFnMnDmT3t5ejh07xpIlSygqKuK3v/3tgPmwRInlNDnYHzLqewdbjrak1PdO7tsJ59ujO8OuWDCBtmdOJKii6JjW/+DcGHDtLHZ+fj4NDQ0sXbqUzMxMWltbGTduHDt27KCuro6WlhaApISYJF/B3Oj296TBZN20YaTU+dWZAKWlpezevfua17u7u2ltbcXj8TB79mwHKpNEu70EPq6Cj4ZyEmzB7KUw6nMJL0sSwNUhdj2HDh3Ctm1KSkrIysq6Zvsrr7wCwOHDhwf8XFRURFVVVfIKTQBPRTme13/jdBlJMf0+GJEJH74Ndv/g+4wYBbMWQ94dya3NSW4bA8MyxA4cOABc/1LyoYceGvTnxx57jBdffDGhtUn8WBZMvTtymdhxMHIvZXcAsMHyQNliuK0EUmgqT2IwLLvvZiFma9m2q2RkQdG8yH8NP4+s6M/IgollTlcm8eDaif0buVmIiYg5huWZ2JX7KkXEfMPyTExE3EMhJiJGU4iJiNEUYiJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImK0YXkDuAmyPGl0LVjkdBlDluVJc7oEVzGt/8G5MaAQS1GWZaXUF29Icqn/h06XkyJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNEUYiJiNIWYiBhNISYiRlOIiYjRFGIiYjQ9OjJF2bbNxXC/02UMWZYnDcuynC7DNUzrf3BuDCjEUtTFcD9j699wuowh61qwSI9TjiPT+h+cGwO6nBQRoynERMRoCjERMZpCTESMphATEaMpxETEaAoxETGaQkxEjKYQExGjKcRExGgKMRExmkJMRIymEBMRow2LEAsEAtTU1FBcXExmZiYFBQWsW7eOYDDI6tWrsSyL7du3O11mQvS/8CJ9X/4bwv/++jXbbNsm9A9P0bd0OfaJ1uQXl0S2DR93Qn8o8nM47Gw9yeT2MeD6Z6fs37+fJUuW4Pf7yc7OpqysjI6ODrZt28bx48c5d+4cAJWVlc4WmiCeVSsJ/+kd+nf8M9bcL2BNyLu6LfyrX2O/fwDP3z+ONbXIuSITKHQJ2t8H33vQc/7T1/suwr6dkF8Jt88ENz8Kze1jwNVnYoFAgGXLluH3+1m/fj2dnZ00NTXh9/vZtGkTdXV1NDY2YlkW5eXlTpebENaIEaRvWA+9vfT/4z9dfd0+6SP84i+xZs7A89ADzhWYQL2fQONLcPQPAwPsivPtcLAODuz69AzNjdw+BlwdYmvXrsXn87FmzRq2bt1KTk7O1W01NTVUVFQQCoUoKioiNzfXwUoTy5pejGfFw9h/biJctwe7v5/+zVvBtknbsB4rLc3pEuOurxfefQWCZ2++7+mjcHhP5JLTrdw8BlwbYs3NzdTW1pKXl8fGjRsH3Wfu3LkAVFRUXH3tlVde4YEHHqCwsJCsrCxmzpzJ9773Pbq7u5NSd6J4Vv4dTJtG/z//T8I//Tn2kRY8j38dqyDf6dIS4qN9EDw39P1PHYFzbYmrJxW4dQy4NsR27txJOBxm5cqVjB49etB9Ro0aBQwMsa1bt5KWlsYPf/hD9uzZwze/+U1+9rOfsXjxYsIGzwZb6emkb/g2XO4jvLsOa/YsPF/7qtNlJUS4PzIPFi3f/riXklLcOgZcO7FfX18PQHV19XX38fl8wMAQe+2115gwYcLVn++77z4mTJjAypUreeutt7j33nsTVHESZGfDiBEQCmHdWYXlcefvsLOtcPli9O3OHIe+HhgxKu4lpQ4XjgHXhlhbW+TaoLCwcNDtoVCIvXv3AgND7LMBdkVVVRUA7e3tMdVSVVWF3++Pqo2dkQE7fhrT8QZ9P9um/0fPQagPphQQful/4bnvXqxJE+Py/iXTS7AuX47Le92q6vJVPLZg8CmEG7Lhnru/RPvZI/EvKtpS4tz/kNpjwOv1sm/fvpjaujbEgsEgAD09PYNur62tJRAIkJOTw9SpU2/4Xm+++SYApaWlMdXi9/ujD8DMkYyI6WiDC/96F/Z77+P5xmN45t9N6Mn/Tv+PniNt66a4fM1WR2cH9F6KQ6W37vyU8zG3PXXKT/up2H5ZxVWc+x/cOwZcG2Jer5euri6ampqYP3/+gG2dnZ1s2LABgPLy8ht2YHt7O9///vdZvHhxzGvJvF5v1G3sjAzOxHS0Qd6rvZ3wCy9izSjB8/CDWGlpeB5dSfgX/0L417tI+9uv3PIxJk2clDJnYmFPMKZ2/eEQI7MtJk+eHOeKohfP/ofUHwOx/Bu5wrUhtnDhQpqbm9m0aROLFi2ipKQEgMbGRlatWkUgEABuvMi1u7ubr3zlK2RkZPDCCy/EXEssp8nB/lBcvnfQDofp3/KPEA6TtuHbVz9K9zz8IPbe/yD8wot47pp3y5cULUdbUuZ7J8P98NbzcDnKLPPOSOfI8YOJKSpK8ep/cP8YMH9W7zpqamoYP348J0+eZNasWcyZM4fp06czb948pk2bxoIFC4CB82Gf1dPTw7Jlyzhx4gSvv/46EyfGZ94g2cKv/Ar7cDOexx7FmjLl6utWWhpp//BtCPfT/6PnsF20SMqTBpNjWLtcUBn3UlKC28eAa0MsPz+fhoYGli5dSmZmJq2trYwbN44dO3ZQV1dHS0sLMHiI9fX18eCDD7Jv3z727NlDWVlZssuPC/ujjwj/y79ilc7E88DXrtluFRXieXQl9oGDhH+9y4EKE6ewCrLzbr7fFd5SGDvl5vuZZjiMAcs2NX5vQXd3N7m5uViWxYULF8jKyrq6LRwOs2LFCnbt2sVvfvObq2dsyRbPy4lkcOor7G/kUje8+yp032Ry6faZMGsxeFKofNP6H5wbAynUbclz6NAhbNumpKRkQIABPPnkk7z88st85zvfISsriz/96U9Xt91xxx2DLsGQ1DRyNFT9HXQcjCxkvfgXK/jHFkRuAL+txN03gLvdsAyxAwcOAINfSu7ZsweAZ599lmeffXbAtl/84hc8/vjjCa9P4ic9A6Z8AQo+DxdOQ9PLEOqFjCyY+4jT1Uk8KMT+Qmtra5KrkWSwLMi9HdLSIQRYrp0NHn6GZVfeKMRExCzD8kzsyn2VImK+YXkmJiLuoRATEaMpxETEaAoxETGaQkxEjKYQExGjKcRExGgKMRExmkJMRIymEBMRoynERMRow/LeSRNkedLoWrDI6TKGLMuT5nQJrmJa/4NzY0AhlqIsy0q5J6VK8qj/h06XkyJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNEUYiJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNH07Zzian29cOEUfHIKLp6L/Hzl9ZPvQq4XRudB2ghn65TYWbZt204XIRJPdhjOnoCT+yN/3ownHbylkF8JubcnujqJN4WYuMrZNvjgDeg5H1v7sQVQ+mXIGhvXsiSBFGLiCqHLcPQP0P7erb+XJx2K/woKvgCWdevvJ4mlEBPjXQ5C06vQfTq+7+stg7L/Ap60+L6vxJc+nRSjXe6BP//v+AcYgP8wHNoTmWOT1KUQE2PZNhzYBcGziTvGqQ/gw/9I3PvLrdMSCzGW713oOhldm3mPQkZ25BL0P/9taG1a34EJxZHlGJJ6hsWZWCAQoKamhuLiYjIzMykoKGDdunUEg0FWr16NZVls377d6TIlCj3n4egfo2+XkQ2ZOZE/h8q24dC/Q7g/+uNJ4rn+TGz//v0sWbIEv99PdnY2ZWVldHR0sG3bNo4fP865c+cAqKysdLZQiUrbPgiHkne8YABOHwXvzOQdU4bG1WdigUCAZcuW4ff7Wb9+PZ2dnTQ1NeH3+9m0aRN1dXU0NjZiWRbl5eVOlytDFLoMnYeSf1zf/uQfU27O1SG2du1afD4fa9asYevWreTk5FzdVlNTQ0VFBaFQiKKiInJzcx2sVKLhb4b+vuQf97wvsR8iSGxcG2LNzc3U1taSl5fHxo0bB91n7ty5AFRUVFx9raGhgYULFzJx4kRGjhxJfn4+jzzyCM3NzUmpW24u2sl8txxbBufaObGdO3cSDodZuXIlo0ePHnSfUaNGAQNDrKurizlz5vDEE09w22234fP52LhxI/Pnz+fgwYPk5+cnpX65vgunnDv2Jw4eWwbn2hCrr68HoLq6+rr7+Hw+YGCILV++nOXLlw/Y784772TGjBm8+uqrrFu3LgHVylCFLsHFLueOrxBLPa4Nsba2NgAKCwsH3R4Khdi7dy8wMMQGM378eADS02P766qqqsLv98fUVgbKyy1g69+/fd3tV9aBXc/I7E//vOeJ6+93vXVkbcc7eDB/3hCrlaHyer3s27cvprauDbFgMAhAT0/PoNtra2sJBALk5OQwderUa7b39/cTDodpa2vju9/9Ll6vl4cffjimWvx+P+3t7TG1lb9wKeuGm6+sA7sZyzO0/f6ShzT1ZYpxbYh5vV66urpoampi/vz5A7Z1dnayYcMGAMrLy7EGeVTBfffdd/VMrbi4mPr6eiZMmBBzLRIf43Nu/Iycy8Ebtx+ZHQkwOwyXbrDv9d6n3+5j8uTJN6lSonUr/0Zc+xSLtWvX8pOf/ISCggJ+97vfUVJSAkBjYyOrVq3iww8/pK+vjyeffHLQ1fpHjhzh/PnznDhxgi1btnD69Gn27t3LlClTkv2/Ip8RDsGb22K/KfueJyJnYL0X4K0d0bcfkw9VK2I7tiSGa5dY1NTUMH78eE6ePMmsWbOYM2cO06dPZ968eUybNo0FCxYA158PmzFjBnfddRcrVqzg97//PRcuXGDz5s3J/F+QQXjSYXRsJ8RxkaMnv6Yc14ZYfn4+DQ0NLF26lMzMTFpbWxk3bhw7duygrq6OlpYW4OaT+gBjxoyhuLiYY8eOJbpsGQInHyGtx1enHtfOiQGUlpaye/fua17v7u6mtbUVj8fD7Nmzb/o+p0+f5siRI9x1112JKFOilHcHtL+f/ONaHhg/+Ifd4iBXh9j1HDp0CNu2KSkpIStr4Kddjz76KMXFxVRWVjJmzBiOHj3Kc889R3p6Ot/61rccqlg+K2/qp/NayXRbSXRPv5DkGJYhduDAAWDwS8m7776bX/7yl/z4xz+mt7eXgoICqqurefrpp6+75kySy/LA5Ao4/lZyj5tfmdzjydAoxP7CmjVrWLNmTbJLkigVfCFySdn7SXKON2E6jNHKipTk2on9G7lRiIkZ0jOgbHFyjjUiE2Yu1DcfpapheSZ25b5KMdu4KTBlLnz056G3ubKI9WaLYj9r5qJPb1eS1OPaxa4yPNjhyDcS+RP0pKQZX4KCzyfmvSU+FGJiPDsMH/wuvssuLCtyBjZZD/xNeQoxcY1TRyJh1jf4Pf9DNnpCZL5NC1vNoBATV7kchGNvRS4vo/0ikYwsyP88FM3Tt36bRCEmrtTXAx0Hwf8BdJ+5/g3jaSPgcxNh0hy4bXrk3kwxi0JMXC8cgu4ABM/9/7MzK7JEY/QEyBqrpROmU4iJiNGG5WJXEXEPhZiIGE0hJiJGU4iJiNEUYiJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNEUYiJiNIWYiBhNISYiRlOIiYjRFGIiYjSFmIgYTSEmIkZTiImI0RRiImI0hZiIGE0hJiJGU4iJiNEUYiJiNIWYiBhNISYiRvt/sROtJqw7PlMAAAAASUVORK5CYII=",
      "text/plain": [
       "<Figure size 371.107x367.889 with 1 Axes>"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Example: internal structure of a StaticPredicate gate\n",
    "\n",
    "qc = StaticPredicateQC(password)\n",
    "qc.draw(\"mpl\", style=\"clifford\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "ad45081b-1a7a-4d85-8f75-f316d1811747",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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sSfOad3m0rQxXhs3TNC32PnMnICUlpVhy/cHsPTTbfgz46a5yyEigRjapysctDw7pZDb4On+PSw6yAGAj2dzhHXw07pt8JNhFh3kgIduo2v5d27V3AXdOwaaoSrTerJrCNy0DO4pH/0t/GclGeYEJOHCVdy7nw+ZzErn7nAiqr/ktjYY+VSvKuuf7t8D9oqaPyAvZAN6dUGTRpWf4/LzbonQQF8zVWRaLVybIjysfaV11jIrjBzYS+fby0IkkWgf4NKvRyc4OzUyU1WGY/n/gjoqKyvD5s2b0bdvXzg5OcHa2hotWrRA//798cUXX6CsrOzxjRhBaVkZYn8t7yLu1bkdrKw4doWIas67lTvCOvhrlkMDfeGvwxQMQiezkmL0wH96p+zktni6n+X3Sj6s9xMd4O7spFkeHPEEGunwlgOha9bEEf17dtIst2rugm4W0ivJMPeQvLw89OnTB+PHj8eBAwcgk8kQHBwMlUqF/fv346WXXsL9+/fNUltFr5y9nRyd9HhQmYhoQK/OmtcUDXqydlMwCFFz16YIf6K8d+rp/vpPKitUD/dO+Xl7ICTAx9wlmVzFhNLWMiuMGthL661nIeIAiIeMHDlSM3v1pk2bKo1SunnzJtavX4/IyEid3zv38Vc7cF9ZWIvK1LifXwi1Wg0baxlkVla1aIuI6rOysjKoUf7Ko/pIrVajpKQUMln9/T5aXFIKqVRiMUFGVyqVCmUqVZ1704m9nS1en/C0XscyzP0tISEBoaGhkEqlOHfunEHnd1v8yVbkKfMN1h4RERFZFgc7Bea8NkavY+tWLDWjnTt3AgAGDhxo8Il67e1q05XPXjkiIiJLV5uswDD3t8uXyydUDAsz/HMk+nabAsCpxCv4/udjsLeTI2rSsxz4QERERJUwGfwtL6/8VR/GeAWJ/s/MlffKAUBJSSmWr4sxbGFERERUJ9TmmTmGub85OJRPGnnvnvYZsmvjvrKw1s/MFT0ofuz7FYmIiKj+YZj7m7+/P3bs2IETJ04YvG397oPzWTkiIqL6ojbPzHE069/OnTuHDh06wMrKComJifDz0/7qF1Phs3JERERUE5w0+G/t27fHqFGjUFJSggEDBuDo0aOVtt+8eRNLlixBfr7xpxgpLSvD4RN82wMRERE9HnvmHpKXl4ehQ4fiyJEjAAA3Nze4uroiKysLGRkZUKvVyM3NRcOGDY1aB3vliIiIqKbYM/cQBwcHHDx4EOvXr0evXr1QUFCA8+fPQywWo1+/fli/fj3s7Y3/HjuZlRQOdgr2yhEREdFjsWeujiopLYUIIkil9fOVO0RERFQzDHNEREREAsbbrEREREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQCxjBHREREJGAMc0REREQC9v+f5ZhWCyojQQAAAABJRU5ErkJggg==",
      "text/plain": [
       "<Figure size 789.163x451.5 with 1 Axes>"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Example: a result measured for the gate alone\n",
    "# Note: all input and output combinations have equal probability\n",
    "# Note: the function result is represented as value 0 or 1 in the last (ancilla) qubit\n",
    "\n",
    "def StaticPredicateAloneQC(password: str) -> QuantumCircuit:\n",
    "    input_qubits = validate_password(password)\n",
    "    all_qubits = input_qubits + 1\n",
    "    classical_bits = all_qubits\n",
    "    \n",
    "    pr = StaticPredicateGate(password)\n",
    "    qc = QuantumCircuit(all_qubits, classical_bits)\n",
    "    for i in range(input_qubits):\n",
    "        qc.h(i)\n",
    "    qc.append(pr, range(all_qubits))\n",
    "    qc.measure(range(all_qubits), range(classical_bits))\n",
    "    return qc\n",
    "\n",
    "qc = StaticPredicateAloneQC(password)\n",
    "qc.draw(\"mpl\", style=\"clifford\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "56b2495e-06eb-482d-a91e-ddc6b81f90b1",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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sWXLFgghYGFhgRo1aiApKQnbtm3Db7/9hn79+mH9+vXyL7c0NKN2xSV46enpqF69ern3UbAeANSpUwcnT55ESEgIdu3ahRMnTqBu3br49NNP4ePjg8GDBz91xM3a2hrW1taFyi0tLWFpqX0xViqVUCoLvxmLi1VZYljRNP3QV5+ejJWu5cZgyD4pFIoih/iLKzcWQ/apuPdYceXGUpa+lrVPlekaYajrXmW4FhRUsF3GukaYAs2ETGNdI0yFqVz3dH5XhIaG4qeffkL79u3x+++/4/Hjx0hMTMTjx48RHR2Ndu3aYcuWLZg3b16Z9lvw/rwnJSUlISMjo9h7+zR8fX2hUCiKvVewuPsMa9eujZUrV+LOnTvIyclBXFwcpk+fjsuXLwMAmjdvXqa+EBEREZkinRPA1atXo1GjRti3bx/atm0rZ60KhQLt2rXDvn370KBBA6xatapM++3YsSMA9X1zT4qMjNSqUxxbW1sEBATgypUruHXrltY2IQT27t0Le3v7UiV0+fn52LhxIywsLNCvX7/SdoOIiIjIZOmcACYmJqJPnz4lDmf36dMHiYmJZdpv165d4evri/Xr12vdDJmWloa5c+fCysoKw4cP12pHTExMoa97g4ODAQAzZszQut9i+fLluH79OoYOHSo/AxBQz9LKysrS2odKpcK0adNw5coVTJw4sUw3VxIRERGZKp1vGqlbty4yMjJKrJOZmQkvL6+yNcjCAitXrkT37t3RoUMHraXgbt26hbCwMPj4+Mj1Z8yYgTVr1mD16tUYOXKkXD5ixAhERERgw4YNuHHjBjp27Ihr167h559/Rr169fDZZ59pHffevXt47rnnEBgYiHr16iEnJweRkZGIiYlBr169EBoaWqZ+EBEREZkqnUcA//Of/2DTpk3FjvDduXMHERER+M9//lPmfXfu3Bl//PEH2rZti4iICCxduhTu7u7YuHFjqdYBBtRfRW/duhWzZ89GSkoKvv76axw+fBhjxozB0aNHtdYBBtQTQvr27YszZ85g0aJFWLVqFapXr44VK1Zg27ZtRU7uICIiIqqMSj0CWPBZMwAwcOBAHD58GP7+/pg0aRLatWsHd3d33Lt3D7///ju++eYbtGvXDgMGDNCpYQEBASU+ckUjPDy82GXprK2tERISgpCQkKfux9HRET/88ENZm0lERERU6ZQ6AfTx8dFaU1dDCIGPPvqoyPJt27Zh+/bthZ7tQ0RERETGU+oEcPjw4UUmgERERERUuZQ6ASzua1YiIiIiqlxM4/HgRERERFRhmAASERERmZlyLR758OFDfPfdd9i3bx/u3r2L7OzsQnUkSUJcXFx5DkNEREREeqRzApiSkoI2bdogLi4OTk5OSE9Ph7OzM3JycuQVNTw9PU12cW4iIiIic6XzV8CzZ89GXFwcfvjhB/zzzz8AgMmTJyMzMxPHjx9HQEAAfHx8cOnSJb01loiIiIjKT+cEcOfOnejatSuGDRtW6PEwLVq0wK5du3Dz5k3MmTOn3I0kIiIiIv3ROQFMTEyEv7+//FqpVMpf/QJA9erV0aNHD2zatKl8LSQiIiIivdI5AXR2dkZubq78unr16rh9+7ZWHScnJ9y7d0/31hERERGR3umcAPr6+uLmzZvya39/f+zduxd///03ACArKwu//fYbvLy8yt1IIiIiItIfnRPAwMBA7N+/H48ePQIAjB07FsnJyWjatCkGDBiA559/HnFxcRg5cqS+2kpEREREeqBzAvj2229jxYoVcgL4xhtvYP78+cjMzMSWLVuQlJSEKVOm4P3339dbY4mIiIio/HR+DmCtWrUwaNAgrbKpU6di0qRJSE1NhZubW6HZwURERERkfOVaCaQoSqUS7u7u+t4tEREREelJuRPAxMREbNy4EWfPnkVaWhqcnZ3h7++PwYMHo1atWvpoIxERERHpUbkSwMWLF+P9999HdnY2hBBy+dq1a/HRRx8hLCwM48aNK3cjiYiIiEh/dE4AN27ciIkTJ6JmzZr46KOP0L59e7i7u+PevXuIjo7GN998I28fOHCgPttMREREROWgcwL45ZdfombNmjh37hw8PT3l8oYNG6JDhw4YOXIk/P398cUXXzABJCIiIjIhOj8G5vLlyxg4cKBW8ldQnTp1MGDAAFy+fFnnxhERERGR/umcAFarVg329vYl1nFwcEC1atV0PQQRERERGYDOCeCrr76K3377DXl5eUVuz83NxW+//Ya+ffvq3DgiIiIi0j+dE8Avv/wS9vb2CAwMxLFjx7S2HT16FIGBgXB0dMS8efPK3UgiIiIi0p9STwLx9fUtVJaTk4MzZ86gbdu2sLCwQM2aNZGamiqPCtaqVQsvvvgi4uLi9NdiIiIiIiqXUieAKpWq0NJulpaW8PLy0ip7clKISqUqR/OIiIiISN9KnQDevHnTgM0gIiIiooqi8z2ARERERFQ5lXstYADIy8vDlStXkJ6eDicnJzRs2BAWFnrZNRERERHpWblGAO/fv4+goCA4OzujSZMmaNeuHZo0aYJq1aohODgYf//9t77aSURERER6ovMw3f3799GqVStcu3YNLi4uaN++PWrVqoWkpCScOnUKK1euxKFDh3D06FG4uLjos81EREREVA46jwD+3//9H65du4b3338ft27dwu7du7F69Wrs2rULt27dwvTp0xEbG4vPP/9cn+0lIiIionLSOQHcunUrOnXqhC+++KLQknB2dnYIDQ1Fp06d8Msvv5S7kURERESkPzongHfv3kXr1q1LrNO6dWvcvXtX10MQERERkQHonAA6Ozvj1q1bJda5desWnJ2ddT0EERERERmAzglgx44dsXnzZuzbt6/I7fv378fmzZvRqVMnXQ9BRERERAag8yzgkJAQ7NixA927d0fPnj3RsWNHuLu74969ezh48CB27doFOzs7zJo1S5/tJSIiIqJy0jkBfO655xAZGYmRI0dix44d2LFjByRJghACAPDMM88gPDwczz33nN4aS0RERETlV67lOtq1a4fY2FgcPnwYZ8+elVcC8ff3R9u2bSFJkr7aSURERER6onMCOHr0aLzwwguYPHky2rVrh3bt2umzXURERERkIDpPAlm/fj2Sk5P12RYiIiIiqgA6J4DPPPMMEhMT9dkWIiIiIqoAOieAo0ePxo4dO3Dnzh19toeIiIiIDEznewD79euHqKgotGnTBh988AFatGgBd3f3Iid+eHl5lauRRERERKQ/OieAvr6+8mNf3n333WLrSZKEvLw8XQ9DRERERHqmcwI4fPhwPuaFiIiIqBLSOQEMDw/XYzOIiIiIqKLoPAmEiIiIiCqncq0EAgDZ2dnYuXMnzp49i7S0NDg7O8Pf3x89e/aEtbW1PtpIRERERHpUrgRw27ZtCA4ORkpKirwGMKCe+OHm5ob//ve/6NOnT7kbSURERET6o3MCuH//fvTr1w9KpRKjR49G+/bt4e7ujnv37iE6Ohpr167FG2+8gcjISHTp0kWfbSYiIiKictA5AQwJCYGtrS2OHDmC559/Xmvb8OHD8e6776Jt27YICQlhAkhERERkQnSeBHL27FkMGjSoUPKn0aRJEwwcOBBnzpzRuXFEREREpH86J4B2dnZwdXUtsY6bmxvs7Ox0PQQRERERGYDOCeDLL7+Mffv2lVhn37596Natm66HICIiIiID0DkBDAsLQ3JyMoYPH46EhAStbQkJCXjrrbeQmpqKsLCwcjeSiIiIiPRH50kgb731FqpXr45169Zh48aN8PLykmcBx8fHIz8/H02aNMGwYcO0fk6SJOzfv7/cDSciIiIi3eicAB48eFD+d15eHq5fv47r169r1fnzzz8L/RzXDyYiIiIyLp0TQJVKpc92EBEREVEF4VrARERERGZGbwlgfHw8oqOj9bU7IiIiIjIQvSWAq1evRufOnfW1OyIiIiIyEH4FTERERGRmmAASERERmRmTTQBPnjyJnj17olq1arC3t0erVq2wadOmMu0jOzsbn376Kfz8/GBjYwNPT08EBwcjOTm52J/JycnBggUL0Lx5czg6OsLR0RHPP/88xo8fX94uEREREZkEnR8D8yRnZ2d4eXnpZV9RUVHo3r07bGxsMHjwYDg6OmLLli0YNGgQEhISMHXq1KfuQ6VSoW/fvoiMjESrVq3Qr18/xMbGYuXKldi/fz+OHTtWaC3jf/75B6+88gpOnDiBNm3aYOzYsQCAGzduICIiAosXL9ZL/4iIiIiMSW8J4KRJkzBp0qRy7ycvLw9BQUFQKBSIjo5Gs2bNAACzZs1CQEAAZs6cif79+8Pb27vE/axZswaRkZEYMmQI1q1bJz+AetmyZXjnnXfw8ccfY/ny5Vo/M3r0aJw8eRLr1q3Dm2++WahdRERERFWByX0FfODAAcTFxeHNN9+Ukz9APcI4c+ZM5OTkYM2aNU/dz4oVKwAAoaGhWquPjB07Fr6+vli3bh2ysrLk8mPHjuHXX3/FsGHDCiV/AGBhobdcmYiIiMioSp3VaJ7xFxAQABsbmzI9869Dhw6lrqtZYi4wMLDQtu7duwMADh06VOI+Hj9+jOPHj6Nhw4aFRgolSUK3bt2wfPlynDp1Cu3btwcAREREAAAGDBiA1NRUbNu2Dffu3UPdunXRo0cP1KhR46ltz87ORnZ2tvw6PT0dAJCbm4vc3FwAgEKhgFKpRH5+vtZqKpryvLw8CCHkcqVSCYVCUWy5KcjPz9drnzSx0tAk30+OwmqXW+q7WzrRb5/+ZWlpCZVKhfz8fLlMkiRYWFg8UW78OJS2r6Xv07/lxb3HtMtNKwb66VPZzydTioO+r3tlO5+Mv/xobm6uga57/3ra+WQK4z2afuv/ule68wlQ6rtLOjHMdQ9lzglKnQB26tQJkiTh8uXLaNCggfy6NAp26GliY2MBAH5+foW2eXh4wMHBQa5TnLi4OKhUqiL3UXDfsbGxcgJ4+vRpuWzYsGFy8gYADg4OWLlyJQYNGlTicUNDQzFnzpxC5Xv27IGdnR0AwMvLC/7+/jh//jzi4+PlOg0bNkSjRo1w4sQJpKSkyOXNmjWDt7c3oqOj8fDhQ7m8devWcHNzK7E9FeX8+fN67dOePXu0LgSdO3eGra0tdu7cqXXcnj17IisrC1FRUQD6Gq6DZaDfPqlZWFigV69eSE1NxdGjR+VyR0dHdOnSBQkJCTh37tz/So0fB/33CXB1dUWbNm0QGxuLK1euyOVFn0+mFQP99Kns55MpxUHf172ynE+mkAjv3LnTQNc9tdKcT0DJt01VhIcPHxroule68wnwN1jfysIw1z31+eTp6VnqdkhC+yNjsWbPng1JkjBx4kS4uLjIr0sjJCSk1A0KDAzE3r17ERsbi/r16xfaXrt2bWRkZCAtLa3YfRw5cgRt27bF0KFDsXbt2kLbV6xYgeDgYCxYsACTJ08GADRq1AhXrlyBUqnE0KFDERISAhcXF+zYsQPjxo1DVlYWTp06hSZNmhR73KJGAOvWrYvU1FQ4OTkB0P8n4aCFxTanwiybaPwRwHGLjX+RXzHJ+COAphCHJeONOwJoajEw1gigKcXBmCOAwd8YfwRwyXjjjwCO/db4I4D/fc+4I4BvLzL+COCKSYYdAczMzISzszPS0tLkvKM4pR4BnD17domvKztNEF944QWEh4fLye3QoUORnp6OcePG4dtvv8XKlSuL3Ye1tTWsra0LlVtaWsLSUvtirFQqoVQWfjMWd6+hKd+DqOmHvvr0ZKx0LTcGQ/ZJoVAUOcRfXLmxGLJPxb3Hiis3lrL0tax9qkzXCENd9yrDtaCggu0y1jXCFGj+rhrrGmEqTOW6ZxrvigKcnZ0BoNgRvvT0dLlOefZRsF7Bf/fp06fQyOarr74KADh16tTTmk9ERERk8nROAB8+fIjr168XGraOiIjA0KFDMWbMGJw5c6bM+y14f96TkpKSkJGRUey9fRq+vr5QKBTF3itY1H2GDRs2BABUq1atUH1NWcFZw0RERESVlc4J4AcffICmTZtqJYBLly7Fm2++iQ0bNmD16tVo3749YmJiyrTfjh07AlBPnHhSZGSkVp3i2NraIiAgAFeuXMGtW7e0tgkhsHfvXtjb26N58+ZyeZcuXQAAf/31V6H9acp8fHxK3xEiIiIiE6VzAnjo0CG8/PLL8uxWAJg3bx5q166N6OhobNq0CUIIzJ8/v0z77dq1K3x9fbF+/Xqt2TBpaWmYO3curKysMHz4cLk8MTERMTExhb7uDQ4OBgDMmDFD64bb5cuX4/r16xg6dChsbW3l8v79+6NmzZpYt24dLly4IJfn5OTIk1gGDhxYpr4QERERmSKd7xpOTEzEK6+8Ir++fPkyEhIS8OWXX6Jdu3YAgJ9++qlMzwsE1DfIrly5Et27d0eHDh20loK7desWwsLCtEbiZsyYgTVr1mD16tUYOXKkXD5ixAhERERgw4YNuHHjBjp27Ihr167h559/Rr169fDZZ59pHdfJyQkrVqxA//790apVK/Tv3x/Vq1fHvn37cOnSJfTs2VNr/0RERESVlc4jgNnZ2bCyspJfHzp0CJIkaT3A2dfXF3fu3Cnzvjt37ow//vgDbdu2RUREBJYuXQp3d3ds3LixVOsAA+rZNFu3bsXs2bORkpKCr7/+GocPH8aYMWNw9OjRQusAA8Brr72GQ4cOoUOHDti2bRuWLl0KAPjiiy+wdetWk5pFRERERKQrnUcA69Sp878HK6pt374dLi4uWs/J+/vvv+Hg4KDT/gMCArBr166n1gsPD0d4eHiR26ytrRESElKm5xC2bdu2VMclIiIiqqx0TgB79OiBxYsXY9q0abCxscHu3bu17s0DgKtXr8LLy6vcjSQiIiIi/dE5AZwxYwZ+++03LFiwAABQq1YtfPrpp/L25ORkHD58GBMmTCh/K4mIiIhIb3ROAD08PHDp0iXs378fANChQwetZUdSU1Mxf/58dO/evfytJCIiIiK9KdfaQba2tujdu3eR2xo3bozGjRuXZ/dEREREZAAmtxQcERERERlWuUYA8/PzsWnTJuzbtw93795FdnZ2oTqSJMlfExMRERGR8emcAGZmZiIwMBDHjh2DEAKSJGmtuKF5LUmSXhpKRERERPqh81fAn332GY4ePYo5c+YgNTUVQgjMnj0biYmJiIiIgK+vLwYMGFDkqCARERERGY/OCeDPP/+MVq1a4eOPP4aLi4tc7u7ujgEDBiAqKgr79u0r81rARERERGRYOieA8fHxaNWq1b87Uii0Rvvq1KmDXr16Yc2aNeVrIRERERHplc4JoL29PRSKf3/c2dkZiYmJWnU8PDwQHx+ve+uIiIiISO90TgC9vb21krvnn38eBw4ckEcBhRDYv38/atWqVf5WEhEREZHe6JwAdu3aFVFRUcjLywMAjBgxAvHx8WjdujXef/99tGvXDufOnUO/fv301lgiIiIiKj+dHwMTFBSEGjVqICUlBbVq1cLo0aNx9uxZLFmyBOfOnQMA9OvXD7Nnz9ZTU4mIiIhIH3ROAP38/DB9+nStskWLFmHWrFm4fv06vL294eHhUe4GEhEREZF+lWslkKK4urrC1dVV37slIiIiIj3hWsBEREREZkbnEUBfX99S1ZMkCXFxcboehoiIiIj0TOcEUKVSFbnOb1paGh48eAAAqFWrFqysrHRuHBERERHpn84J4M2bN0vcNmXKFNy7dw979+7V9RBEREREZAAGuQfQx8cHERER+Oeff/DRRx8Z4hBEREREpCODTQKxtLREt27dsGnTJkMdgoiIiIh0YNBZwI8ePcL9+/cNeQgiIiIiKiODJYC///47NmzYgIYNGxrqEERERESkA50ngXTp0qXI8ry8PNy5c0eeJDJr1ixdD0FEREREBqBzAnjw4MEiyyVJQvXq1REYGIgpU6agW7duuh6CiIiIiAygXM8BJCIiIqLKp9xrAScnJ+POnTtQqVSoXbs2PDw89NEuIiIiIjIQnSaBZGdn48svv4Sfnx9q1aqF5s2bIyAgALVr10bNmjUxefLkEh8UTURERETGU+YEMCEhAS1atMCMGTMQFxeHWrVqISAgAAEBAahVqxbu37+Pb775Bs2bN8e+ffvkn0tMTOQzAYmIiIhMQJkSwNzcXPTs2RMXL17EkCFDcPnyZdy+fRtHjx7F0aNHcfv2bVy+fBlDhw7F/fv38dprr+HmzZuIi4tDu3btEBMTY6h+EBEREVEplekewOXLl+PSpUsICQlBSEhIkXUaNmyIH3/8EQ0aNEBISAiGDh2KmzdvIjU1FS+99JJeGk1EREREuivTCOCmTZtQv379Uj3b7+OPP4afnx+OHj2Kx48fIzIyEr169dK5oURERESkH2VKAP/66y8EBgZCkqSn1pUkSa57/PhxdOrUSdc2EhEREZEelSkBzMjIgLOzc6nrOzk5wcLCAvXr1y9zw4iIiIjIMMqUALq5ueHatWulrh8XFwc3N7cyN4qIiIiIDKdMCWDr1q2xa9cuJCUlPbVuUlISduzYgXbt2uncOCIiIiLSvzIlgG+//TYyMjLw+uuvIzU1tdh6f//9N15//XU8evQIY8eOLXcjiYiIiEh/yvQYmM6dOyMoKAgrVqzAs88+i7Fjx6JLly6oW7cuAPVDovfv348VK1YgNTUVwcHBnPxBREREZGLKvBbwkiVL4OTkhK+//hqhoaEIDQ3V2i6EgEKhwLRp0wptIyIiIiLjK3MCqFQqMX/+fAQHByM8PBxHjx6V7wn08PBAmzZtMGLECPj5+em9sURERERUfmVOADX8/Pzw+eef67MtRERERFQByjQJhIiIiIgqPyaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZoYJIBEREZGZYQJIREREZGaYABIRERGZGSaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZsZkE8CTJ0+iZ8+eqFatGuzt7dGqVSts2rSpTPvIzs7Gp59+Cj8/P9jY2MDT0xPBwcFITk4uVPfKlSsICgqCv78/XF1dYW1tDR8fH/Tu3Rv79+/XV7eIiIiIjM7C2A0oSlRUFLp37w4bGxsMHjwYjo6O2LJlCwYNGoSEhARMnTr1qftQqVTo27cvIiMj0apVK/Tr1w+xsbFYuXIl9u/fj2PHjsHV1VWuf+HCBfz8889o3bo12rRpAycnJ9y5cwdbt27Fjh078Nlnn+Gjjz4yZLeJiIiIKoTJJYB5eXkICgqCQqFAdHQ0mjVrBgCYNWsWAgICMHPmTPTv3x/e3t4l7mfNmjWIjIzEkCFDsG7dOkiSBABYtmwZ3nnnHXz88cdYvny5XL9Pnz7o16+fXE/j7t278Pf3x5w5czB+/HhUq1ZNr/0lIiIiqmgm9xXwgQMHEBcXhzfffFNO/gDA2dkZM2fORE5ODtasWfPU/axYsQIAEBoaqpXUjR07Fr6+vli3bh2ysrLkcmtr60LJHwB4enqibdu2yM3Nxa1bt8rRMyIiIiLTYHIjgAcPHgQABAYGFtrWvXt3AMChQ4dK3Mfjx49x/PhxNGzYsNBIoSRJ6NatG5YvX45Tp06hffv2Je7r77//xvHjx2FnZwdfX98S62ZnZyM7O1t+nZ6eDgDIzc1Fbm4uAEChUECpVCI/Px8qlUquqynPy8uDEEIuVyqVUCgUxZabgvz8fL32SRMrDQsL9ds0Ly+vhHJLfXdLJ/rt078sLS2hUqmQn58vl0mSBAsLiyfKjR+H0va19H36t7y495h2uWnFQD99Kvv5ZEpx0Pd1r2znU+EP9hUtNzfXQNe9fz3tfDKF8R5Nv/V/3Svd+QQo9d0lnRjmuocy5wQmlwDGxsYCAPz8/Apt8/DwgIODg1ynOHFxcVCpVEXuo+C+Y2NjCyWAV69exfr165Gfn4+7d+9i27ZtePDgAZYtWwZHR8cSjxsaGoo5c+YUKt+zZw/s7OwAAF5eXvD398f58+cRHx8v12nYsCEaNWqEEydOICUlRS5v1qwZvL29ER0djYcPH8rlrVu3hpubW4ntqSjnz5/Xa5/27NmjdSHo3LkzbG1tsXPnTq3j9uzZE1lZWYiKigLQ13AdLAP99knNwsICvXr1QmpqKo4ePSqXOzo6okuXLkhISMC5c+f+V2r8OOi/T4CrqyvatGmD2NhYXLlyRS4v+nwyrRjop09lP59MKQ76vu6V5XwyhUR4586dBrruqZXmfAJKvm2qIjx8+NBA173SnU+Av8H6VhaGue6pzydPT89St0MS2h8ZjS4wMBB79+5FbGws6tevX2h77dq1kZGRgbS0tGL3ceTIEbRt2xZDhw7F2rVrC21fsWIFgoODsWDBAkyePFlr2/bt29GnTx/5tYODA5YuXYphw4Y9te1FjQDWrVsXqampcHJyAqD/T8JBC5/aLINbNtH4I4DjFhv/Ir9ikvFHAE0hDkvGG3cE0NRiYKwRQFOKgzFHAIO/Mf4I4JLxxh8BHPut8UcA//uecUcA315k/BHAFZMMOwKYmZkJZ2dnpKWlyXlHcUxuBNDYevfuDSEEcnJycPPmTaxYsQLDhw/HiRMn8O2335b4s9bW1rC2ti5UbmlpCUtL7YuxUqmEUln4zag5EUpbbgo0/dBXn56Mla7lxmDIPikUiiKH+IsrNxZD9qm491hx5cZSlr6WtU+V6RphqOteZbgWFFSwXca6RpgCzX32xrpGmApTue6Z3BXD2dkZAIod4UtPT0f16tXLvY+C9YpiZWWFBg0aYP78+Xj06BEWLVqEHj16oEePHk/tAxEREZEpM42PBQUUvD/vSUlJScjIyCj23j4NX19fKBSKYu8VLOk+w6JoJqRoJqgQERERVWYmlwB27NgRgHrixJMiIyO16hTH1tYWAQEBuHLlSqFHtwghsHfvXtjb26N58+alatPdu3cBmO7XC0RERERlYXIJYNeuXeHr64v169drzYZJS0vD3LlzYWVlheHDh8vliYmJiImJKfR1b3BwMABgxowZWjfcLl++HNevX8fQoUNha2srl58+fRpFzYe5desWQkNDAYBf/xIREVGVYHL3AFpYWGDlypXo3r07OnTooLUU3K1btxAWFgYfHx+5/owZM7BmzRqsXr0aI0eOlMtHjBiBiIgIbNiwATdu3EDHjh1x7do1/Pzzz6hXrx4+++wzreNOnToV165dQ8uWLeHl5QWFQoG4uDjs2rULOTk5mDZtGtq2bVtBUSAiIiIyHJNLAAH184/++OMPhISEICIiArm5uXjhhRfwxRdfYNCgQaXah0KhwNatWzFv3jz8+OOP+Prrr+Hi4oIxY8bgs88+01oHGAAmTJiATZs24fTp04iMjEROTg7c3NzQu3dvBAcHyw+hJiIiIqrsTDIBBICAgADs2rXrqfXCw8MRHh5e5DZra2uEhIQgJCTkqfvp378/+vfvX9ZmEhEREVU6JncPIBEREREZFhNAIiIiIjPDBJCIiIjIzDABJCIiIjIzTACJiIiIzAwTQCIiIiIzwwSQiIiIyMwwASQiIiIyM0wAiYiIiMwME0AiIiIiM8MEkIiIiMjMMAEkIiIiMjNMAImIiIjMDBNAIiIiIjPDBJCIiIjIzDABJCIiIjIzTACJiIiIzAwTQCIiIiIzwwSQiIiIyMwwASQiIiIyM0wAiYiIiMwME0AiIiIiM8MEkIiIiMjMMAEkIiIiMjNMAImIiIjMDBNAIiIiIjPDBJCIiIjIzDABJCIiIjIzTACJiIiIzAwTQCIiIiIzwwSQiIiIyMwwASQiIiIyM0wAiYiIiMwME0AiIiIiM8MEkIiIiMjMMAEkIiIiMjNMAImIiIjMDBNAIiIiIjPDBJCIiIjIzDABJCIiIjIzTACJiIiIzAwTQCIiIiIzwwSQiIiIyMwwASQiIiIyM0wAiYiIiMwME0AiIiIiM8MEkIiIiMjMMAEkIiIiMjNMAImIiIjMDBNAIiIiIjPDBJCIiIjIzDABJCIiIjIzTACJiIiIzAwTQCIiIiIzwwSQiIiIyMwwASQiIiIyM0wAiYiIiMwME0AiIiIiM8MEkIiIiMjMMAEkIiIiMjNMAImIiIjMDBNAIiIiIjPDBJCIiIjIzJhsAnjy5En07NkT1apVg729PVq1aoVNmzaVaR/Z2dn49NNP4efnBxsbG3h6eiI4OBjJycnF/sy6desQEBAAe3t7VK9eHb1798aZM2fK2x0iIiIik2GSCWBUVBTatm2LP/74AwMHDsTbb7+NpKQkDBo0CF999VWp9qFSqdC3b1+EhISgZs2amDRpElq3bo2VK1eidevWSElJKfQzn3/+OYYNG4bk5GS8/fbbGDBgAKKjo9GmTRscPnxY390kIiIiMgoLYzfgSXl5eQgKCoJCoUB0dDSaNWsGAJg1axYCAgIwc+ZM9O/fH97e3iXuZ82aNYiMjMSQIUOwbt06SJIEAFi2bBneeecdfPzxx1i+fLlcPzY2FrNnz0aDBg1w4sQJODs7AwDGjRuHVq1aISgoCBcvXoRCYZI5MxEREVGpmVw2c+DAAcTFxeHNN9+Ukz8AcHZ2xsyZM5GTk4M1a9Y8dT8rVqwAAISGhsrJHwCMHTsWvr6+WLduHbKysuTy1atXIy8vDx999JGc/AFAs2bNMGTIEFy+fBl//PGHHnpIREREZFwmlwAePHgQABAYGFhoW/fu3QEAhw4dKnEfjx8/xvHjx9GwYcNCI4WSJKFbt27IzMzEqVOn9HpcIiIiosrA5L4Cjo2NBQD4+fkV2ubh4QEHBwe5TnHi4uKgUqmK3EfBfcfGxqJ9+/byvx0cHODh4VFi/ZJkZ2cjOztbfp2WlgYAuH//PnJzcwEACoUCSqUS+fn5UKlUcl1NeV5eHoQQcrlSqYRCoSi2POdxiU2qEP/8k6/XPmlipWFhoX6b5uXlFVue89hS7/0qq/R06LVPBVlaWkKlUiE/P18ukyQJFhYWWuWmEIe//y5dX0vbp4Llxb3HCpabWgz00aeC5aU9n0wpDvq+7pXlfMp5LMHY/v471yDXvYKedj7lPDb+eE9amrrf+r7uFSwv6XzKeazUe5/KKj0dBrnuacozMzMBQOs9VhyTSwA1SVPBr2ELcnJykuuUZx8F62n+7ebmVur6RQkNDcWcOXMKlderV6/En6vsfphh7BaYBsZBjXFgDDQYBzXGQY1xqLgYPHz4sNgcSMPkEsDKbMaMGZgyZYr8WqVS4f79+6hRo4bWfYimJD09HXXr1kVCQoKc6JobxkCNcVBjHNQYB8ZAg3FQqwxxEELg4cOH8PT0fGpdk0sANRlrcaNt6enpqF69ern3UbCe5t9lqV8Ua2trWFtba5VVq1atxJ8xFU5OTib7hq4ojIEa46DGOKgxDoyBBuOgZupxeFquomH8mwKeUNL9dklJScjIyCj23j4NX19fKBSKYu/ZK+o+Qz8/P2RkZCApKalU9YmIiIgqK5NLADt27AgA2LNnT6FtkZGRWnWKY2tri4CAAFy5cgW3bt3S2iaEwN69e2Fvb4/mzZvr9bhERERElYHJJYBdu3aFr68v1q9fj3PnzsnlaWlpmDt3LqysrDB8+HC5PDExETExMYW+vg0ODgagvi+v4GyY5cuX4/r16xg6dChsbW3l8lGjRsHCwgKff/651r7OnTuHDRs24Nlnn0W7du303V2js7a2RkhISKGvrs0JY6DGOKgxDmqMA2OgwTioVbU4SKI0c4UrWFRUFLp37w4bGxsMHjwYjo6O2LJlC27duoWwsDBMnTpVrjty5EisWbMGq1evxsiRI+VylUqFnj17IjIyEq1atULHjh1x7do1/Pzzz/Dx8cHx48fh6uqqddzPP/8cH3/8Mby9vdGvXz88fPgQGzduRE5ODvbv34+2bdtWVAiIiIiIDMbkRgABoHPnzvjjjz/Qtm1bREREYOnSpXB3d8fGjRu1kr+SKBQKbN26FbNnz0ZKSgq+/vprHD58GGPGjMHRo0cLJX8A8NFHH2Ht2rVwdXXF0qVLsWnTJrRv3x5Hjhxh8kdERERVhkmOABIRERGR4ZjkCCARERERGQ4TQCIiIiIzwwSQiIiIyMwwASQiIiIyM0wAiYiIiMwME0CSaSaEc2K4eSv4+zfn9wLjQBpPvhf4fqCqgAkgySRJ0vo/wD985qjg77/gv1UqlTGaYzSMg3kreO2TJAk5OTnyvzXvh/z8fKO0jUgf+BxAM5eXl4crV65gz549sLe3h6WlJdzc3NCsWTPUrl3b2M2jCpSVlYUjR45g3759sLS0hCRJqFevHtq3b49nnnnG2M2rMIwDaaSlpeHnn3/G4cOHkZ+fD5VKhcaNG6NXr154/vnn5XpCCK0PCVWVufTTXDABNGM3btzAV199hSVLlmiV29raws/PD507d0afPn3QqlUr2NnZ8eSvwmJiYvDZZ59h/fr1AAA7Ozs8evQIAODs7IyuXbti8ODBCAwMhJOTkzGbalCMg1pubi6USiUUirJ9SVSVrhHnzp3DrFmzsH37dgBAzZo1kZqaKm/39/dHUFAQBg4cCBcXF2M10+DS09NhYWEBOzu7Mv1cVXovVFVMAM3YgAED8OuvvyIoKAgtW7aEhYUF0tLSEB0djT179uDBgweoVasWRo0ahffee6/I5fMqu6+++gr+/v5o27ZtlVngWxd9+/ZFZGQkPvjgA7Ru3RqOjo548OABIiMjsXnzZiQnJwMA3nzzTbz//vto2rSpkVtsGIyD2qxZs+Dt7Y0OHTqgTp06sLW1ferPVLU/+D169MDvv/+OTz/9FO3bt0etWrWQmpqK7du3Y+vWrTh9+jQAoHXr1vjoo4/Qs2dPI7fYMN577z04OTmhc+fOaNSoEdzc3GBhYVHiz6hUqjJ/eKgMkpKS4OLiAisrqzL9nMmeG4LM0o0bN4RSqRTTpk0TKpWq0PY7d+6IpUuXihYtWghJkkSXLl1EbGysEVpqODdu3BCSJAlJkkTjxo1FSEiIOH/+fJF18/PzhRDquPz888/iypUrFdlUg7p586ZQKBRi5syZxdbZvn27CAwMFBYWFqJZs2bi1KlTFdjCisE4qN28eVM+L7y9vUVQUJDYtm2buH37tsjJydGqqzkvbt68Kb799lvxxx9/GKPJeqd5L4SEhBRb5+jRo2Lw4MHC0tJS+Pj4iMjISCGEKPJ6WlkVfC/UqFFD9O7dW3z77bfi2LFjIjU1Vauupt+xsbFi+vTp4tdffzVGkw3m9u3bokePHuLrr78Whw8fFsnJycX+rjXl2dnZFdnEMmMCaKa+++47YWtrK3bs2CGEKP6NeuXKFTFu3DghSZIYPXq0yMvLq8hmGtS3334rJEkSL774onB3d5cvdO3btxdLliwR8fHxcl3NCf3NN98ISZLEli1bjNVsvVu+fLmwsbERv/zyixBCyH/kVSqV1u/74cOHIiwsTEiSJHr06CEyMjKM0VyDYRzUlixZIn/oCwgIEFZWVkKSJPHCCy+ImTNniujoaJGSkiInf0KoryeSJIkNGzYYseX6s2rVKmFtbS0iIiKEEP++F/Lz8wtdA7ds2SIsLS2Fv7+/SE5OrvC2GtLy5cuFJEnijTfeEAMGDJCvk15eXuKtt94SP/zwg7hw4YJIT0+Xf2bp0qVCkiSxZs0aI7Zc/z755BMhSZKwtLQUnp6eYvDgweL7778X586dEw8ePNCqq/l78fPPP4ugoCBx7do1YzT5qZgAminNiR0VFSWEKPlTa1ZWlggKChKSJFWpka9x48YJhUIhTpw4IWJiYsRnn30mOnXqJOzs7IQkScLOzk7069dPbNq0STx8+FDk5eWJwYMHC0mSqtQf/Z9++klIkiS2bt361Lr5+fnio48+EpIkiePHj1dA6yoO46A2efJkIUmSOHbsmLh7965YtWqVGDlypPDz8xOSJAlra2vRqVMnERYWJi5cuCCSkpLEgAEDqtR5sX//fiFJkli5cmWxdfLy8uTr5oIFC4QkSWLXrl0V1cQK8cEHHwhJksSRI0dERkaG2LVrl5gzZ47o1KmTcHR0FBYWFuL5558X7777rti+fbu4cOGC6NevX5V6L2h069ZN2NnZicmTJ4vu3buLatWqCaVSKRo1aiTGjRsnfvrpJ3H16lW533l5eeKNN94QVlZW4tGjR0ZufdGYAJqpP//8U9jZ2Yn27dvLX+0+OdIhxL+ffDdv3iyUSqUIDw+v8LYaQlpamujVq5eQJEkr+c3MzBT79u0T06ZNE/7+/vKooKenp+jfv7+wt7cXvXr1MmLL9S8uLk64uLiIZ599Vhw5ckQuL/gHTgghcnNzhRBC7N69WyiVSrF48eIKb6shMQ5CpKeni9dee01IkiQeP34slz9+/FicOnVKLFy4ULz++uvCw8NDSJIkXFxcRNeuXYWVlVWVOi8SExOFl5eX8PDwEL/++qvIysoqsp7mvXDo0CFhZWUl5s+fX5HNNKjMzEwxevRoYW1trTXClZubK65duya2bNkiJk+eLPz9/YWVlZWws7MTL774opAkSfTu3duILde/pKQk8eKLLwo/Pz8hhPr2oa1bt4oPPvhAtGjRQtjY2Ahra2vRsmVLMXPmTPH777+LX3/9Vbi5uYlXXnnFyK0vHhNAM/Xo0SMRHBwsD++fPXtWa3t+fr7WH73w8HBhYWEh9u7dW8EtNYycnByxaNEi8dZbb4n79+8LlUql9ZWWEELcu3dPbNq0SYwaNUo888wzcjKo+dq8qsjPzxdz5swRkiSJtm3bim3btmltf3J0eM2aNcLCwkK+56mqYBzUMVi7dq0YMWKE/HXmk+fFP//8I/bv3y9mz54tunbtKhwcHIQkSWLnzp3GaLLBrFy5UkiSJHx9fcWiRYvEvXv3iq27Zs0aoVQqq9QIoEqlEr/99puYOnWqSElJkcsKyszMFH/++adYtWqVGDNmjPwVcVV7L/z111+iTp064vXXX9cqz8rKEhcvXhQ//vijCAoKEg0aNBBKpVJUr15dPPvss0KSJPHbb78ZqdVPxwTQjOXk5Ih3331XTmx69OghNmzYoHU/hxDqTz8dO3YUbm5uRmqp4WRnZxe6qD35B08IIU6cOCH8/PxEtWrVKqppFW7+/PmiRo0aQpIk0bRpU7Fo0SJx9+5dIYT6Qi+EepSsZcuWolatWsZsqkExDkUr6rw4f/68eP7554Wzs3PFN6gCbNy4Uf5D7ufnJ2bOnCmOHDkibt++Le7evSuys7PF6dOnRdOmTUXdunWN3dwKU9QtQ1evXhUvvfRSlXwvZGVliUWLFom1a9fKo75PxuDBgwfi2LFjYvny5aJv375CkiRRvXp1YzS31JgAminNxfzevXti4cKFwtfXV04E7e3tRbdu3cSMGTPEwIEDhaenp7C3txcLFiwwcqsrlkqlkifHHDx4UDg6OooxY8YYuVX6p7mQpaeniw0bNoiuXbvK7wVJkkRAQIAYNmyY6NChg7CzsxPOzs5V6mtPDc05kZaWJtavXy+6dOlilnF4cqZvSXX2798v7Ozsqtx5oTkncnJyxP79+8Xo0aO1Joo1bNhQdOjQQTRq1EhIkiTc3d3F999/b+RW619pJv1pEqI9e/YIa2vrKvdeeJqikuENGzYIhUIhgoODjdCi0mMCaIaKm/Dx66+/itdee03UrFlTKJVKeTJE8+bNRUREhDz6URUUNZohRPGxmTp1qpAkSZw8edKQzTIZhw4dEu+9955o3ry5fC+UhYWF6Nmzp9izZ0+pkoTKpLjf+4EDB8TEiRPNPg7FnS+zZ88WkiSJEydOGLJZJuH06dNi3rx5on///qJ169aiQYMGwtXVVYwaNUqcOHGiSj3+RRdfffWVUCqVVfK9UNQtQkXV0bwHNJNnTP3vBR8Ebabu3LmD2rVrIysrC7m5uVqrGmRkZODMmTMAgNq1a8PBwQHu7u7GaqrBaGKQk5ODvLy8Yp90L4TAjh078NNPPyE8PLxiG1mBxP8WuS/4ANfHjx8jNjYWtra2qF69OmxsbGBvb2/EVhpObGws3Nzc8ODBA9jY2Gi95x89eoTY2FjY29ubTRwePnwIW1tb1KhRo9i60dHR2L17N+bOnVuBLaxYTz7UOCcnB/fu3UO1atVgaWkJa2tr03zIbwU7e/YsDh8+jAkTJhi7KUaVkpKC4OBgXL58GTExMcZuTomYAJoRIQS2b9+O77//HhcuXEBGRgaaNGmCJk2awN/fHy+88ALq169fZf+wASXH4MUXX4S/vz+eeeYZWFtbm+7T2/UoPz8fCoWiUD/z8/MhSVKVfJp/QdnZ2di8eTOWLFmCs2fPQqFQwM/PD/Xr18eLL76IVq1awd/fH9WrVzd2Uw2qpDi89NJLaNu2LZo1a1all78D1NeH/Px8KJXKQueESqWCJEmFyqvidaKkOFDJcnNzsX//flhYWODll182dnNKxATQjMyaNQthYWGws7ND3bp1kZubi5ycHCQkJEAIgaZNm6J///5466234OHhYezmGkRpYzB8+HCtESDNxbCqSEhIQN26deXXKpUKQogi+1gV/8BpTJ06Fd988w28vb3h5+cHS0tLPHjwABcvXkRaWhrq1q2L3r17Y9SoUWjevLmxm2swpY3D6NGj8dJLL8k/V5XOi7i4ODzzzDPya5VKBZVK9dRlz6oaxkFNc92r0v2v2G+cyVhu3Lgh7OzsRM+ePcXly5eFEEKkpKSIM2fOiM2bN4uJEyeKBg0aCEmSRLNmzeRp/E+776EyYQzUNEvgde/eXYSHhxda0ikvL0/uc2VZ0kgX169fFzY2NmLAgAHyI0/S09NFfHy8OH78uJg/f75o06aNvNSXZmWDqnavF+MgxLVr14QkSeLZZ58V8+fPF4mJiVrb8/Ly5AkRmn5nZGSIpKQkeRJEVcA4/CstLU3cunVLq6xg/6sCJoBm4tNPPxUuLi5i3759QghR6GRNS0sTR44cEZMmTRKSJAkPD49Czwas7BgDtblz52rNbq1Zs6YYMWKE2LFjR6GYaBK/ZcuWia5du1aplWA+//xz4eLiIvbv3y+EKDzjMTc3V1y/fl0sXLhQuLq6CkmSxO7du43RVINiHIT44osvtM4JSZJEp06dxNq1awtN9Cl4TgQEBIgzZ84Yo8kGwTj8a8qUKfLSoKtWrSo0CTI3N7fQ4EBiYqK4d+9epflwxATQTAwfPlzUqlVLJCUlCSH+/fRW1Bt148aNwtnZWbRq1apC22hojIFa7969haOjo1i5cqUYMWKEPNtbkiRRv359MW3atEIz+d54440qt7zTuHHjRLVq1URCQoIQouQRrT179ohatWqJhg0baq2QURUwDkL069dP2NraivXr14tZs2aJxo0by+eEpaWlGDx4sJwga1TFc4Jx+NcLL7xQKBl+/fXXCy0EUPAxWkOHDhXdu3evNKOhTADNhGbx+s2bN8tlT356KXjhHzVqlKhZs6aIiYmpsDYaGmMgRHJysggICBC1a9eWy7KyssS6desKPf+vRYsW4ttvvxWbNm0StWrVEn369DFiy/Xv+++/F5IkicWLF8u/9yeXfStoxowZwsHBocqNdJh7HFJSUkSbNm2Eh4eHXJadnS127dolxowZI2rVqiWfE66uruLDDz8Ua9eurXLnBOPwr7i4OOHq6io6duwooqOjxTvvvCO8vLzk/levXl2MGzdO6xw4e/asqF69uujYsaPxGl5GTADNRHR0tHBwcBCNGjUq9Gyigs840vx/7ty5wt7evko904kxECI+Pl60b99eXrf1yXv77t69K8LCwrQ+/drY2FTJJfAuXLggateuLVxcXAot11RwXWzN+2HBggXCxsZGa53gqsDc45CUlCReeeUV0a1bN5Gbm1voq86UlBTxww8/iFdffVXY29trfUiqSucE4/CvPXv2CEmSxNSpU+WyBw8eiIiICDFgwADh7Ows9/2ZZ54R8+bNE9OnTxeSJInt27cbseVlwwTQDGg+ya9YsUIolUohSZIIDg4W+/btK7TsmxDqdYKHDBkiatSoUdFNNRjGQC0nJ0ccOHBAHDlyRGuiR8GJHxpXrlwR48ePF5IkCRcXF2M012A074ddu3aJOnXqyJNiNm3aJO7fv1+ofkZGhhg4cGCVez8wDmqxsbHi4sWLhc6JJ0dB4+Pjxaeffirs7OxMfpkvXTAOakeOHBF169YV//3vf4UQhe8Xv3Xrlli0aJHo1KmTViJc2WLBBNCMZGRkiKVLlwo3NzchSZJwc3MTffv2FXPnzhX79u0T9+/fF8ePHxdjx44VVlZWWp9+qgrGQK2klVByc3PlUZ8TJ04IOzs7k1/SSFe5ubnip59+Ek2aNJEv4k2bNhXjx48XW7ZsEZcvXxY///yzGDRokFAqleLDDz80dpMNgnEoniYJ0pwTR48erdLnRHHMKQ45OTni0qVL8v3iQmiPhhd09epVMWzYMCFJkhg/fnxFNrPcmACagSc/vWVkZIiFCxeK1q1bCwsLC/mCr1AohJWVlZAkSYwaNUrcvn3bSC3WP8ZAreAjHErzOIMJEyYISZLEqVOnDN00o/vll19Er169Cr0fJEkSVlZWYvLkyVp/EKoqxqFkmlFxczgnSmLOcXjy+jlnzpxKGQs+CNqMpaam4urVqzh27Bh+//135Ofno0GDBnj22WcxZswYYzevQjAGxUtPT8fYsWMRFRWFpKQkYzfHIIQQUKlUWg8zTkpKQlRUFA4fPgxLS0t4enqiUaNG6NOnjxFbaliMQ+lkZmZi/Pjx2LlzJ5KTk43dHKOp6nHQLP9X0oPOxf8eFH316lX06dMHeXl5iIuLq+CWlg8TwCouOTkZFy5cwNWrV5GRkYGAgAA0atQINWvWLPTGzs7OhrW1tfxaVJEVIBgDteLiUKNGDfkp909e8LKzs5GcnKy1akhl9+TariV5Mh5V6f3AOJQtBgWlp6dXqWXxGAfdXblyBa+99hr69OmDL7/80tjNKRMmgFXYrl278Nlnn+Ho0aNa5S4uLujatSsGDRqEPn36wNLSUt6m64XAVDEGaiXF4eWXX5bjUCWXOypBcb/rgmsk5+XlVfm4MA6lO+/z8vIgSVKVWf6uKOYeh927d+PixYs4d+4c3Nzc0KJFC9SvXx/e3t6oUaMGlEplkR+AKuP5wQSwikpISECnTp2QmZmJkSNHonPnzrh+/TrOnj2LP//8E+fPn0d2djYaN26MmTNnon///rCysqoyn+wBxkCjtHF47rnnMGPGDDkOVS0RvnfvHr788ksEBgaiZcuWqFatmrxNcxmsSr/34jAOjIEG4/CvBw8eIDQ0FPPnz4dSqUR+fr68zcXFBW3btsXrr7+O1157TStOlXo97Iq84ZAqzkcffSSqV68utmzZUmhbQkKCiIiIEEOHDpVv8v7iiy+M0ErDYgzUGAe1WbNmCUmSRL169USvXr3E/PnzxYkTJwqtaJGfny/f4B0VFSV27dpljOYaDOPAGGgwDv/68ssvhZ2dnXj99ddFVFSUuHLliti4caOYM2eO6N27t7wM4osvvih++eUXYzdXL5gAVlEtW7YUnTp1EikpKUIIofVoj4IOHDgg/P39hbW1tfj+++8rupkGxRioMQ5qzZo1E1ZWVqJVq1byTG8fHx8xdOhQsXLlSnH58mWt+pmZmeLVV18VCoVCZGVlGanV+sc4MAYajMO/vL29Ra9evURqamqhbXfu3BHbt28XwcHB8uz4FStWGKGV+sUEsAp6+PChePnll0WjRo3kBawLPvet4KoXQghx5swZUb16dfHqq6/K2ys7xkCNcVCLj48XPj4+4qWXXhI5OTni6NGj4pNPPhFNmzYVkiQJpVIpmjRpIiZMmCA2bdok0tLSxIkTJ4SHh0eVWuaKcWAMNBiHf12+fFk4ODiImTNnymX5+fmFnpeanZ0tduzYIXx9fYWLi0ulXw2HCWAVpVmWpqiRnIJ/1DVv8L59+4oGDRqImzdvVlgbDY0xUGMchDh+/LhwcXERI0aMEEIIeeWTe/fuiV27dom3335beHt7C0mShJ2dnejQoYO8NvKTy6NVZowDY6DBOPzrr7/+EnXq1BGDBg0SQqi/JXnyg3LBa+Wvv/5aJW6XYQJYRd2+fVtez3XixIni9OnThYbsNcvbpKWliQEDBggvLy9jNNVgGAM1xkG9xNUbb7wh1q1bV+T2nJwccfPmTfHjjz+KgQMHChcXl0q5tNPTMA6MgQbjoK1ly5bC0dFR7Ny5s9A2TfKnSQr//vtvUa9ePdG/f/8KbaO+MQGswn755RdRr149IUmSaN68ufi///s/ERUVJW7evKmVAKxdu1a4urqKsWPHGrG1hsEYqDEO6sXci7q/pyDNBX7ZsmVCkiQxbty4imhahWIcGAMNxuHf5O748eOidu3aQpIkMWnSJHH8+PFCH5Q1k2OOHDkiPD09xbvvvlvh7dUnJoBVzJP3bP39999i2rRpwsvLS177tkuXLmLYsGEiODhYvPXWW8La2lo0atRIxMTEGKnV+sUYqDEOakXdx6j5uqs477//vpAkSZw+fdqQTatQjANjoME4FJaXlyfCw8NFrVq1hCRJ4rnnnhOTJ08WmzdvFpcuXZJjc/v2bTFkyBBhYWFR6WPB5wBWQeJ/z7G7ffs2PD09oVAocPHiRWzfvh0HDx7E5cuXkZCQAACoXr06mjVrhm+//RbPPfeckVuuP4yBGuOgpolDUlIS3NzctJ5vWPBhxwBw+/Zt9OrVC3fv3kVKSoqxmmwQjANjoME4FC0lJQXfffcdNm3ahKtXr8LOzg61a9eGg4MDXFxcEBMTg5SUFIwaNQpLliwxdnPLhQlgFZKXl4fDhw9j1apVuHr1KiRJgp2dHVq0aIGBAwfC398fQggkJCQgKysL169fR6NGjVC3bl1YWFhUiQcgMwZqjIPak3FQKBSwtbVF06ZN0a9fP7Rp06bQz6SmpuLHH3+Ep6cnBg0aZIRW6x/jwBhoMA5FEwXWw87KykJsbCxOnjyJw4cP4/jx44iJiYGrqyvq1q2L//znPxg2bBjs7e2N3ezyqeghRzKc+fPnCycnJyFJkvDz8xONGjWSH+6rGdJevHixuHfvnrGbajCMgRrjoPa0ODz77LNiwYIFIjExUevnsrOzS/w6rLJhHBgDDcah9PLz80VmZqbIzc0Vqamp4uLFi8Zukl4xAawirl+/Luzt7UX79u3F9evXxe3bt0Vubq5ISEgQS5YsEZ07d5ZP8C5duoiTJ08au8l6xxioMQ5qZYlD165dK/39PMVhHBgDDcbhX48ePRIxMTHi0aNHhbbl5+dr3Sf55D2TVSURZgJYRXzyySfCzc1N7Nu3Ty578k17/vx5MXz4cGFjYyMaNmwoTp06VdHNNCjGQI1xUCtPHKrKA7CFYByEYAw0GId/hYaGiubNm4u5c+eKAwcOiDt37hRaIenJ5/8lJyfLj8yqCpgAVhFvvPGG8PX1Fbdu3RJC/PtcN5VKVehNvXDhQiFJkhg5cmSFt9OQGAM1xkGNcVBjHBgDDcbhX5pHvlhYWIgaNWqIPn36iEWLFokTJ04U+WicjIwMMW3aNDFq1KgqMwKoePpdglQZ+Pv748aNG8jIyAAAWFhYAAAkSYJSqQSgvskVAN577z288cYbOHDgAK5fv26cBhsAY6DGOKgxDmqMA2OgwTioXb16FWlpaWjdujUWLlyIdu3a4fjx43j33XcxYMAATJ06FWvXrsWlS5fw4MEDAMDFixexYsUK3L9/X2vGdGVWNXpB6Ny5MwBg6NChOHDgAHJycoqsl5+fDwBo2LAhUlNT5QtBVcAYqDEOaoyDGuPAGGgwDmpXr17F48ePERgYiPHjx+Obb77Bjz/+iJCQEHh7e2PLli0YNWoU3nzzTcyZMweRkZHYsmUL0tPTERQUZOzm648RRx9Jj/Ly8sTUqVPlWVzfffedSEpKKrLu/fv3xfDhw4Wrq2sFt9KwGAM1xkGNcVBjHBgDDcZBbfPmzUKSJBEREaFVnpOTI2JjY8VPP/0k3nvvPdG0aVNhZWUl7O3thZ2dXZVbBo8JYBWzbNky8cwzzwhJkkTt2rXFhAkTxI4dO8T58+fFpUuXxJ07d8SHH34obGxsxJQpU4zdXINgDNQYBzXGQY1xYAw0zD0OKpVK/PXXX+L69evy6ydlZGSIM2fOiA0bNojAwEB5LfWqhAlgFaNSqcTVq1fF+++/L+rWrStP6Xd3dxd16tQRSqVSSJIk3nzzTZGQkGDs5hoEY6DGOKgxDmqMA2OgwTgUr6hkcOLEiUKSJHHmzBkjtMhwuBJIFZaZmYkTJ05g27ZtuHv3LpKTk+Hk5ISBAweiX79+sLGxMXYTDY4xUGMc1BgHNcaBMdBgHIqmUqmgUChw8+ZN9O3bF//88w/i4+ON3Sy9YgJoJnJzc2FpaWnsZhgVY6DGOKgxDmqMA2OgwTgUdvjwYQQFBWH48OH48MMPjd0cvWICSERERFQEIQRu374NFxeXyr/27xOYABIRERGZGT4HkIiIiMjMMAEkIiIiMjNMAImIiIjMDBNAIiIiIjPDBJCIiIjIzDABJCIiIjIzTACJiIiIzAwTQCIiIiIzwwSQiIiIyMz8Px5slyJZOKoxAAAAAElFTkSuQmCC",
      "text/plain": [
       "<Figure size 700x500 with 1 Axes>"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "plot_distribution(run_simulation(qc))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "id": "ee2517a0-c766-4956-962d-7d4812909d35",
   "metadata": {},
   "outputs": [],
   "source": [
    "def StubFunctionGate(password: str) -> Gate:\n",
    "    # Creates gate working as a predicate statically configured with given password.\n",
    "    # The number of qubits required by the gate equals password length plus one ancilla qubit. \n",
    "    # The gate switches phase for the input equal to password and leaves it unchanged for all other inputs.\n",
    "    # The ancilla qubit must be set to '0' at input.\n",
    "    # The ancilla qubit is untangled and always set to '0' at output.\n",
    "    return StubFunctionQC(password).to_gate()\n",
    "\n",
    "def StubFunctionQC(password: str) -> QuantumCircuit:\n",
    "    input_qubits = validate_password(password)\n",
    "    all_qubits = input_qubits + 1\n",
    "    ancilla_qubit = all_qubits - 1\n",
    "    classical_bits = 0\n",
    "    \n",
    "    pr = StaticPredicateGate(password)\n",
    "    qc = QuantumCircuit(all_qubits, 0, name='StubFunction')\n",
    "    qc.append(pr, range(all_qubits))\n",
    "    qc.z(ancilla_qubit)\n",
    "    qc.append(pr.inverse(), range(all_qubits))\n",
    "    return qc"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "id": "7703a77f-92be-4108-a170-6e7ec00c6ec1",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAnMAAAEvCAYAAAAuFEcfAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8g+/7EAAAACXBIWXMAAA9hAAAPYQGoP6dpAAAq0ElEQVR4nO3de1hVZd7/8c8GRAEhUVAwVA4KiooWatpBwyCz0ikrs8ysp3zmaYa0UnFqaqymdDTn14xjmU45ZqUx09E0KxNzCMsTaaakeEBF2CmCKQhx2r8/HBm3G5WTbO7N+3VdXdew1r3u9d3b8etn32vthcVms9kEAAAAI7k5uwAAAADUHWEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAIMR5gAAAAxGmAMAADAYYQ4AAMBghDkAAACDEeYAAAAMRpgDAAAwGGEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAIMR5gAAAAxGmAMAADAYYQ4AAMBghDkAAACDEeYAAAAMRpgDAAAwGGEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAIMR5gAAAAxGmAMAADAYYQ4AAMBghDkAAACDEeYAAAAMRpgDAAAwmIezC0DN2WxSZZmzqwAktxaSxeLsKlAb9A/Akav0MsKcQSrLpLVznV0FIMVNlNw9nV0FaoP+AThylV7GZVYAAACDEeYAAAAMRpgDAAAwGGEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAIMR5gAAAAxGmAMAADAYYQ4AAMBghDkAAACDNYswl5eXp6SkJHXt2lWtWrVSp06dNGnSJBUVFemhhx6SxWLRvHnznF0mAABArXk4u4BLbevWrRo+fLisVqt8fHwUHR2tnJwczZ07V3v37lV+fr4kqW/fvs4ttAFUVlbqw6//qpXfLpC1IEttfAI1uM9ojR/2vLw8fZxdHoAmjh4CmMmlV+by8vI0YsQIWa1WTZ48Wbm5uUpPT5fVatWsWbO0cuVKbdq0SRaLRTExMc4ut97mf/K4XvvkCXXuEK3E2/6mwTF36aOv5+oPi0aosrLS2eUBaOLoIYCZXHplbuLEicrOzlZiYqLmzJljty8pKUlLly7Vtm3bFBYWJj8/PydV2TCyrDv0cdrfdG2vUZo+/v2q7UFtw/TKxxP11bZ3NfSKe51YIYCmjB4CmMtlV+YyMjKUnJysgIAAzZw5s9oxsbGxkqQ+ffrYbd+/f79GjhwpX19f+fv76/7779exY8cuec31sXbrMtlsNo267jG77TdfNUGtWnjry/S3nVMYACPQQwBzuWyYW7ZsmSorKzV27Fi1bt262jFeXl6S7MPcyZMnFRcXp+zsbC1btkwLFy5Uamqqbr311iZ9mWHXoU1ys7gpqvMAu+2eLVopvGNf7T60yUmVATABPQQwl8teZk1JSZEkxcXFnXdMdna2JPswt3DhQh0+fFj//ve/1blzZ0lSSEiIrr76ai1fvly33XbbpSu6Ho6dyJGfT4A8PVo67Au47HLtPLBeZeWlauHh6YTqADR19BDAXC4b5g4cOCBJ6tKlS7X7y8vLlZaWJsk+zK1YsULXXnttVZCTpEGDBik8PFyffPJJncJcv379ZLVaa33cuTw9vLQwMbPafb+UnlKLaprw6eNanR5TdopGjAbRLbKbSsuLnV0GauFC/UOih6B5akq9LCgoSJs3b67TsS4b5oqKiiRJxcXV/yElJycrLy9Pvr6+CgsLq9q+c+dO3XXXXQ7je/bsqZ07d9apFqvVqsOHD9fp2LO1auF93n0tPb1VXHik2n2l5SWnx1zgeKA2cnNyVFJ2ytlloBYu1D8kegiaJ1fpZS4b5oKCglRQUKD09HQNGjTIbl9ubq6mTp0qSYqJiZHFYqnaV1BQoDZt2jjM17ZtW+3atavOtTQETw+v8+5r59dRB3/aqdLyXxwuk+T9fFiX+QTwiRoNJrhjxybzaRY1c6H+IdFD0Dw1pV5Wn6zgsmEuPj5eGRkZmjVrlhISEhQZGSlJ2rRpk8aNG6e8vDxJjfOw4Loum56rolRaO7f6fVGd+mvL7i+06+BG9Q6/rmp7aVmJ9uVsVe/wwQ1SAyBJmbsz5c6/60a5UP+Q6CFonlyll7nst1mTkpLUrl07HTp0SD179lTv3r3VrVs3DRgwQOHh4Ro6dKgkx8eS+Pv76/jx4w7z5efnq23bto1Rep1c3+duWSwWfZD6F7vtn274u0rKTmnoFWOdUxgAI9BDAHO57MpcSEiIUlNTNXXqVK1bt05ZWVmKjo7WggULNGHCBEVEREhyDHM9evSo9t64nTt3avDgpvvJNCy4t0Ze/Vt9nDZPz745SgO636yDRzL00ddzFRM+hId9ArggeghgLpcNc9LpYLZixQqH7YWFhcrKypKbm5t69eplt+/WW2/VU089pezsbIWEhEiSNmzYoL179+qll15qlLrr6pGRf1EH/1B9umGhNmaslJ9PgG675lGNH/a83NxcdhEWQAOhhwBmsthsNpuzi2hsGzZs0MCBAxUVFaUff/zRbt+JEyfUu3dvBQQE6LnnnlNJSYmSkpIUGBiob775xqkN7WL3vACNJW6iXOI+k+aE/gE4cpVe1iw/am3fvl2S4yVWSfLz81NKSoqCg4M1ZswYPfzww7r66qu1YsUKPpkCAIAmx6Uvs57PhcKcJEVERFR7eRYAAKCpaZZLTRcLcwAAAKZolitzZ35vKwAAgOma5cocAACAqyDMAQAAGIwwBwAAYDDCHAAAgMEIcwAAAAYjzAEAABiMMAcAAGAwwhwAAIDBCHMAAAAGI8wBAAAYjDAHAABgMMIcAACAwQhzAAAABiPMAQAAGIwwBwAAYDDCHAAAgMEIcwAAAAYjzAEAABiMMAcAAGAwwhwAAIDBCHMAAAAGI8wBAAAYjDAHAABgMMIcAACAwQhzAAAABiPMAQAAGIwwBwAAYDDCHAAAgMEIcwAAAAYjzAEAABiMMAcAAGAwwhwAAIDBCHMAAAAGI8wBAAAYjDAHAABgMMIcAACAwQhzAAAABiPMAQAAGIwwBwAAYDDCHAAAgMEIcwAAAAYjzAEAABiMMAcAAGAwwhwAAIDBCHMAAAAGaxZhLi8vT0lJSeratatatWqlTp06adKkSSoqKtJDDz0ki8WiefPmObtMAACAWvNwdgGX2tatWzV8+HBZrVb5+PgoOjpaOTk5mjt3rvbu3av8/HxJUt++fZ1baANYljJTmYfTlZm9Rdb8/erg30VvP5Xl7LIAGIIeApjJpcNcXl6eRowYIavVqsmTJ2v69Ony9fWVJM2ePVvTpk2Th4eHLBaLYmJinFxt/S1a9ZR8vduq2+VXqqj4uLPLAWAYeghgJpcOcxMnTlR2drYSExM1Z84cu31JSUlaunSptm3bprCwMPn5+Tmpyoaz5Hd7FdwuXJI0YU4vFZcWOrkiACahhwBmctl75jIyMpScnKyAgADNnDmz2jGxsbGSpD59+lRtOxP+BgwYoJYtW8pisTRKvQ3hTBMGgLqghwBmctkwt2zZMlVWVmrs2LFq3bp1tWO8vLwk2Ye5PXv26P3331dQUJD69+/fKLUCAADUlcuGuZSUFElSXFzcecdkZ2dLsg9zgwcPVm5urpYvX674+PhLWyQAAEA9uWyYO3DggCSpS5cu1e4vLy9XWlqaJPsw5+bmsm8JAABwQS77BYiioiJJUnFxcbX7k5OTlZeXJ19fX4WFhV3SWvr16yer1VrveTw9vLQwMbMBKgLqp1tkN5WWV/93C00T/QNw1JR6WVBQkDZv3lynY102zAUFBamgoEDp6ekaNGiQ3b7c3FxNnTpVkhQTE3PJv+RgtVp1+PDhes/TqoV3A1QD1F9uTo5Kyk45uwzUAv0DcOQqvcxlw1x8fLwyMjI0a9YsJSQkKDIyUpK0adMmjRs3Tnl5eZIa52HBQUFBDTKPp4dXg8wD1Fdwx45N5tMsaob+AThqSr2sPlnBZcPcmefIHTp0SD179lT37t1VUlKiPXv2aPjw4QoNDdXnn39ud7/cpVLXZdNzVZRKa+c2yFRAvWTuzpS7p7OrQG3QPwBHrtLLXDbMhYSEKDU1VVOnTtW6deuUlZWl6OhoLViwQBMmTFBERIQkNUqYayyrt7ylIwWnv/hxvOioyitK9c6XL0iS2vt3UULsOGeWB6CJo4cAZnLZMCdJPXr00IoVKxy2FxYWKisrS25uburVq5cTKrs0Ptv4hr7ft85u2+LPn5EkxYQPoREDuCB6CGAmlw5z57Njxw7ZbDZFRkbK29vxpuD33ntPkrRz5067n0NDQ9WvX7/GK7SW/vzIV84uAYDB6CGAmZplmNu+fbuk819iveuuu6r9efz48Vq8ePElrQ0AAKA2CHPVsNlsjVkOAABAnTXLX3dwsTAHAABgima5Mnfm97YCAACYrlmuzAEAALgKwhwAAIDBCHMAAAAGI8wBAAAYjDAHAABgMMIcAACAwQhzAAAABiPMAQAAGIwwBwAAYDDCHAAAgMEIcwAAAAYjzAEAABiMMAcAAGAwwhyanMnzr9d9M0KdXUa9zX73ASVMtVx0G4CGRx9xHffNCNXk+dc7u4wmzcPZBaBpyD22T++u/ZO27/u3jhw/qBYeLeXvG6TunQboxn4PqG/XOEnSki+eVUTHvrqm1231Ot8HqX+RT6s2Gtb/gfoXf5bJ86/X9/vWVf3s7uahNq3bq3f4YI294WmFBvVs0PM1VWk/fKS9OVt1/43POrsUNCP0EddCHzEHYQ7adWizpswfInf3FkqIvV9dOvRUaXmxso9makvmF/Jq6VvVhN9a/ZwSYsc3SBPu4B9abRP+04QvZJOtznO38GipJ+58XZJUWl6sjIMbtHrzm9qYsVLzJm5Sp/ZRdZ67vp646+967I7XLvl50n74SKu3vEkTRqOhjzQe+gjORZiD3l79nErKTum1xK2K6NjHYX/+CWuj1tPCw7Nex7u7eSg+9r6qn2++aoI6t++hhSum6MOv52riqFeqPa6iskJl5b+olad3vc5/IR7uLST3FpdsfsBZ6COn0UfgDIQ56HBepvy821XbgCWprV+QrPlZGjczTJK0esubWr3lzar9q186/en3q63JWvPdO9qbs1XHT/4kr5a+6hV2rcbf+LzCO8ZUjT9zr8dPBQfs7vt468n9Cmp7+t6Inwqy9PZTWefUuUdL17yo9MzVOl54RH4+AYoK6a/7Ev6gyJDYC77GflHDtHDFFOUc2yNJ+nzTYs3554OaNWG1dh74Rl9sXqwjxw/q8Tv/rmH9H5DNZtOKb17Tqo2v6+CRDFksborq1F/3xf+hanXhjNKyEi3+/Bmt+e4dFZ4qUFhwbz0w7IVq65j97gOn37+X7FcM8k9YtSxlhr7NWKFjPx+WT6vLFN6xj0Zfn6TYyARJ0o8HN2r5+le188B65f2cLTc3d4UFxeiuIVN0be/bq+Y6+xLR2e/vlNH/qFrBOHYiV2+vfl4bflypgpNW+fkEaGCPW/XATS/Iv3X7C76XQHXoI/SR+vaRI8cPacEnk7V59+eSzaaY8CF6ZORfqh1bUVmhZWtmaNXG11VQ+JNCAiJ17w2/18EjGXpr9XNV/z9oLghzUHC7CB06ukup2z/Qdb1HVTvmstaBmjbmLc16d5x6h12nm6/6X4cxH6+fJz/vdrrlqv+Vv2+Qco/t1coNC/XYq9fo1UnpCgnsJkmaNuYtvfbJ4/LzCdC9Q39vd47z2XVos5IW3qCKijLdNOAhhXbopZPF+fp+7zrtzFp/0SZ8+Gjm6XP4BNhtX7Biiioqy3TzVRPk3cpPnQJPXzqZtWyc1m5dputi7tSN/R9UWfkvSvnuHU37e4Km3/+Bru45smqOGe/co7QdH2lg9Aj1ixym3GN79dySUQpqG3bBms6w5mfpsVeuUUHhT0qIvV+RIf1UUlqkjAPfKj3zy6omnPbDhzp09EcN6TNaHfy76ETRMX2x5U09t2SUnrz3HQ294l5J0r03/F42W6W270/VtDFvVZ2nZ+jVkqQjBQc1cd4glVeU6qYBD6ljuwgdztujFd/M19a9a/XqxM3y8bqsRrUDZ9BH6CP16SOFxcc1+dXBOvLzId068P/UpUO0vt+3TlMWxKm0rNhh/LwPE7Xi29fUNyJOdw2ZouNFRzX3w9/U+P1yNYQ5aOwNTys9c7WeX3KHLg/opl5h1yoqpL9iIq5Xlw49JElenj6Kj71Ps94dp6C24XaXH86Y8fBn8vL0sdsWH3u/Hnm5rz5IfVkTR736n233afHnT8u/dYdq5zmXzWbTnOQHVFb+i+Y9utHu0/k9Q59UZWWlwzE/F+VJkn4pK9aPBzfoteWPV9VzttLyYs1/7Du7SyJfb/9Qa757R4/dsUC3DPzvPzajrp2kR+cN1PyPJ2lQ9AhZLBZt3vWF0nZ8pITY8Uoas7hqbO/wwXr2zdtVE3M//I2OncjRjIc/U/+oYXb7zn5t98Y/rYdunmm3/7ZrJ+qRv1yhd758oaoJx0YmaE36O9q+P7Xa93feR4+qoqJM8x/7ToFtQqq2D465SxPnDdT7qS9zjwxqjT5CH5Hq3keSv5ota0GWJo9epJv6PyhJGnn1b/Tqx4/pw6//ajc2y7pDK759Tf0ih+nFhz6Vm9vpB3MMiblL//dy3xqf05XwaBIoOnSQXp20RQmx41VU8rM+3/QPzf3wN3p4TrSeeHWwco/tq9E8ZxqwzWZTUckJ/VyUpzatAxUSGKUfD26oc317c7Yq66cdGtbvQbsGfMaZv8hnlJQW6c5nA3Xns4Ea+2Jn/fGtu1RRWa6pdy92aHIjBj3icG/LmvS35d3SV1f3uk0/F+VV/VdYclyDeoyQtSBLh/NOf0Jfv+MjSdLo66fazXFNr9uqPp1fyIlT+dq86zP1j7rJobZzX9vZ/8CVlJ7SiaJj+qXslPpGDNXBIxkqKjlx0fMVFf+sDRkrNLDnSHm2aGX3+oLahurydl21ZfcXF50HOBd9hD5Snz6y/oeP5N+6gxLOCcp3x01zGPttxgpJ0u3XTbJ7bWHBvRVbzetvDliZg6TTfwnOfCL8qeCAvt+7Tqs2vq7t+1P1h8W/0quTtlz0huI9h7/T4s+f0ba9X6mktMhuX32Wvs80vK6XX1Gj8Z4erfTHBz+RJLm7e6hN6w7qFBjl0Kwl6fKASIdtB49k6NQvJzX6uQ7nPUfByZ8UEhip3GP75GZxU0ig4zyd2/fQoaO7LlhrTt4e2Ww2RdTgtRUUHtHiz57W+h0f63jhEYf9RcXH5dPK74JzHDq6S5W2Sn228Q19tvGNascEtw2/aC1Adegj/0UfqV0fyc3fp6hO/eXu5m63vZ1fsFp7tbHbZs3fL0nVBt1OgVHa9OOqWp3bFRDm4KCDfxcl9Ltf8bHj9Pir12lHVpp2HdqoXmHXnveYIwUH9cT8wfJu6aex8c+oU2CUWnn6yCKL5i9/TMWlhY1Wv5ubu66MjK/R2Oq+cWaTTW18AvXkvUvPe1xoUK8611cXNptNv1t4ow4dydDt105SZKd+8m51mdwt7vp88z+U8t1SVdocLxM5zPOfRzXccOV9ujF2fLVjPFt4NWjtaJ7oI/QRNB7CHM7LYrGoe+ertCMrTXk/H77g2K9/+FDFvxTq+QeWO3xL68SpY2rh0dJ+btX86eVnPvXuzdla42Pq4/KAbtp4dLd6dBkor5atLzg2uF24KndXKvvobocHiR48knHRc3UM6CqLxXLR17Yv93vty92m++L/oPHDnrPbt2rj6w7jLZbq39/L250+X3lFaY3/oQLqgz5CH6mJ4LbhOnw0UxWVFXarc8dO5Kqw+Ljd2CD/UEmnVwiD29mvAF5sFdNVcc8ctGX3alVUlDts/6WsuOq+hy4doiVJXi1b62RxvsNYt//85Tv3IZ2fbvi78k86Pl+qVcvWOnnKcZ7qRHTso9AOPfXZpkXKsu5w2G+z1f3BoNVJiL1flbZKvbHqyWr3F5z8qep/D+r5K0nSP796yW5M2g8f1aip+Hm3Vf+o4dr04yql7/7SYf+Z13a+93e/9Qel/fChw3Fn/vE4cc577OfTTgO636yvt3+gnQe+rfZ8xwuPXrRu4Fz0EXv0kdr1kat7/koFhT9p9ZYldtuT185yGDsweoQk6cPUv9p9uWN/7nZt2fV5rc7rKliZg15b/rhOnDqmQdEjFRrcW61aeOvo8UNK2bpU2Ud3KyH2foUF95Yk9eg8UN9lfql3185S+zadZbFYFNd3jAZEDdcbLbw1a9k4/eqaRLX28teOrDRt/PFTdWwXoYpK+ybfo/NAfbbpDS3+7Bl17tBDFoubBkaPcPgWm3T60+GUu/+hpAU36NG5A04/UiColwqLj+v7fevUP+om3Xbtow32fgyOuVPD+j+oj9PmKTM7XQOjb9VlPgE6ejxbOw98o5xje/TWk6dv5u4fNUwDo0do9ZY3dbI4X/2jblLOsb1a+e0ChQb1Upb1h4ueL/H2eXps3tV66o3hSug3XpGXx57+9tyhDergH6oJt8xS5/Y9FNqhp/751Wz9UnpKndpHKfvo7tPnCe6tzOwtdnP26DxQH6fN098++I0G9LhFHu4t1L3zVQpuG6aJo+br8Veu1eT5gxUfe7+6drxCNlulcvP3af2Oj5UQez/fZkWt0Ufs0Udq10dGX5+klO+W6uX3Jigze4tCO/TUtn1faeeBbxweBRMa1FO3XPW/WrlhoaYtjNc1vW7X8aKjWr7+FUVcfoUys7ecd1XRVRHmoF+P+H9av+Nj7cj6Wqnb31dhyfHTD5sMjtHd10/Tjf0eqBr76O2v6m8f/lbL1ryoU7+clCTF9R2jjgERevHhVVq06iktS5khN4u7eoZeoz8/sk7zPkzUTwVZdud8cPiLOnkqX8vXv6LCkuOy2Wx668n98mrr2IQlKapTf82buEnvfPlHrdv2T6349jX5+QSoe6cB6hl6TYO/J1NGL1KfiDh9umGh3k2ZqbKKUrX1DVLXy6/UQ8Ptv9b/9H3J+sdnTysl/R2l716tsODemn7/B0r5bmmNmnBw2zC9Mmmz3v7yj9r446f6cssStfbyV3hwn6rncLm7ueuFh1ZqwYopWr3lTZWUFik0qJem3v2m9uVuc2jCcX3v0Z7D3+mrbe/q39//S5W2Sk0Z/Q8Ftw1T+zad9OpjW5S8dpbW7/hYa9LflqdHKwW26aSB0SM0pM/ohnsj0WzQRxzRR2rO19tfL/8mVa998oS+/M/qXEz4EM359VolLbzBYfyjo15VO7+OWrXpDS1cMUUhgVGaNGq+fjy4UZnZW5rdPXsWW0OvLeOSqSiV1s51dhWAFDdRcq/fb0tCI6N/oDl4ZtEIbd2Too9eOOHwzdjquEov4545AABglF+q+a0Q+3K+18Zdq9S369AaBTlXwmVWAADQ4MrKS2v0BZXLWgfWOnx9sflNfblliQb0uEVtfAJ16MiPWrlhoVq4e2r8sOfrWrKxCHMAAKDB7TywXlNei7vouLee3K+gtqG1mrvb5Vcq7YcP9dHXc3XyVL68W/qqb9ehGpcwvcYPhnYlhDkAANDgwoP7aNaE1Rcd19Y3qNZzd+88QH+a0DwfQ1IdwhwAAGhwvt7+PJy8kfAFCAAAAIMR5gAAAAxGmAMAADAYYQ4AAMBghDkAAACDEeYAAAAMRpgDAAAwGGEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAIN5OLuAxpCXl6fZs2frgw8+UHZ2tgIDAzVq1CjNmDFDEydO1KJFi/S3v/1NiYmJzi61XrKP7taX6W9ry+4vlHtsr0rLSxTcNkKD+9ylUdc9Ji9PH2eXCKCJon8A5nL5MLd161YNHz5cVqtVPj4+io6OVk5OjubOnau9e/cqPz9fktS3b1/nFtoAPtu0SMvXv6JB0SN1wxVj5e7eQtv2rtXiz57Wv7f9U3Mf/VYtW3g5u0wATRD9AzCXS4e5vLw8jRgxQlarVZMnT9b06dPl6+srSZo9e7amTZsmDw8PWSwWxcTEOLna+ruu9526J+5J+XhdVrVtxKD/0+UB3bR0zYtatfEN3XaN2auPAC4N+gdgLpe+Z27ixInKzs5WYmKi5syZUxXkJCkpKUl9+vRReXm5QkND5efn58RKG0ZUp352jfiM6/vcLUnKsv7Q2CUBMAT9AzCXy4a5jIwMJScnKyAgQDNnzqx2TGxsrCSpT58+Vdvee+893XHHHerSpYu8vb3VvXt3/f73v1dhYWGj1H0pHP05W5Lk37qDkysBYBr6B9D0uWyYW7ZsmSorKzV27Fi1bt262jFeXqfv/zg7zM2ZM0fu7u6aMWOGVq1apUceeUTz58/XTTfdpMrKykapvSFVVFbonS//KHc3Dw294l5nlwPAIPQPwAwue89cSkqKJCkuLu68Y7KzT3/iPDvMffLJJwoMDKz6eciQIQoMDNTYsWP19ddfa/DgwZeo4ktj/vLHtPPAN/qf4TPUqX2Us8sBYBD6B2AGlw1zBw4ckCR16dKl2v3l5eVKS0uTZB/mzg5yZ/Tr10+SdPjw4TrV0q9fP1mt1jodezZPDy8tTMys8fjFnz2jj9Pm6Zar/lf3DH2y3ucHzugW2U2l5cXOLgO1QP8AHDWlXhYUFKTNmzfX6ViXDXNFRUWSpOLi6v+QkpOTlZeXJ19fX4WFhV1wrrVr10qSevToUadarFZrnYPg2Vq18K7x2CVfPKt31rygYf0f1KQ7Xqv3uYGz5ebkqKTslLPLQC3QPwBHrtLLXDbMBQUFqaCgQOnp6Ro0aJDdvtzcXE2dOlWSFBMTI4vFct55Dh8+rGeeeUY33XRTnZ9FFxQUVKfjzuXpUbNnPC354lm9tfo5JcSO1xN3vn7B1wfURXDHjk3m0yxqhv4BOGpKvaw+WcFlw1x8fLwyMjI0a9YsJSQkKDIyUpK0adMmjRs3Tnl5eZIu/LDgwsJC/epXv5Knp6cWLVpU51rqumx6ropSae3cC495a/Xzemv1c4q/cpymjF4kNzeX/Y4LnChzd6bcPZ1dBWqD/gE4cpVe5rJhLikpSUuXLtWhQ4fUs2dPde/eXSUlJdqzZ4+GDx+u0NBQff7553b3y52tuLhYI0aM0P79+5Wamqrg4OBGfgW193HaK1ryxXS1b9NZV3aLV8p3S+32+/t2UGxkgpOqA9CU0T8Ac7lsmAsJCVFqaqqmTp2qdevWKSsrS9HR0VqwYIEmTJigiIgISao2zJWVlenOO+/U5s2btWbNGkVHRzd2+XWy69AmSdKR4wc1O3m8w/6Y8CE0YwDVon8A5rLYbDabs4tobIWFhfLz85PFYtHJkyfl7f3fG4MrKys1ZswYLV++XJ9++qmGDh3qxErt1eQyCdAY4ibKJS5NNCf0D8CRq/Qyl12Zu5AdO3bIZrMpMjLSLshJ0m9/+1v961//0u9+9zt5e3vr22+/rdoXERFR7aNLAAAAnKVZ3t26fft2SdVfYl21apUk6U9/+pMGDRpk99/KlSsbtU4AAICLaZYrcxcKc1lZWY1cDQAAQN2xMgcAAGCwZrkyd+b3tgIAAJiuWa7MAQAAuArCHAAAgMEIcwAAAAYjzAEAABiMMAcAAGAwwhwAAIDBCHMAAAAGI8wBAAAYjDAHAABgMMIcAACAwQhzAAAABiPMAQAAGIwwBwAAYDDCHAAAgMEIcwAAAAYjzAEAABiMMAcAAGAwwhwAAIDBCHMAAAAGI8wBAAAYjDAHAABgMMIcAACAwQhzAAAABiPMAQAAGIwwBwAAYDDCHAAAgMEIcwAAAAYjzAEAABiMMAcAAGAwwhwAAIDBPJxdAABUx2az6VRlhbPLqBVvN3dZLBZnlwGgmSHMAWiSTlVWyD9ltbPLqJWCoQnycaetAmhcXGYFAAAwGGEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAIMR5gAAAAxGmAMAADAYYQ4AAMBghDkAAACDEeYAAAAMRpgDAAAwWLMIc3l5eUpKSlLXrl3VqlUrderUSZMmTVJRUZEeeughWSwWzZs3z9llAgAA1JqHswu41LZu3arhw4fLarXKx8dH0dHRysnJ0dy5c7V3717l5+dLkvr27evcQhvAoSO79PaXzyvzcLqOnchRRUWZ2rfprAHdb9Zd109VO79gZ5cINLqyG2+u0Tj3l/4ktz4xl7iapov+AZjLpcNcXl6eRowYIavVqsmTJ2v69Ony9fWVJM2ePVvTpk2Th4eHLBaLYmLMb+JHf85W/olcXdPrdgVeFiJ3Nw/tt27Xyg0LtXbbu3rt8a3yb93e2WUCjco9acp599msVlUueVu6zE+WkJBGrKrpoX8A5nLpMDdx4kRlZ2crMTFRc+bMsduXlJSkpUuXatu2bQoLC5Ofn5+Tqmw4V3a7QVd2u8Fhe++wwXrh7dH6YtNi3R2X5ITKAOdxix9a7XZbSYkqHpssubnJ/anfydKubSNX1rTQPwBzuew9cxkZGUpOTlZAQIBmzpxZ7ZjY2FhJUp8+faq2paamKj4+XsHBwWrZsqVCQkJ09913KyMjo1HqvhQ6+HeRJBUWFzi5EqDpqPjzX6R9++X28P/I7Yq+zi6nyaJ/AE2fy67MLVu2TJWVlRo7dqxat25d7RgvLy9J9mGuoKBAvXv31q9//Wu1b99e2dnZmjlzpgYNGqQffvhBIQZciiktK1FxaaFKy0p04Kedev3TaZKkAd1rdu8Q4Ooq/vmebOv+LcuQwXK/c5Szy2lS6B+AeVw2zKWkpEiS4uLizjsmOztbkn2YGzlypEaOHGk3rn///oqKitL777+vSZMmXYJqG9anG1/XKx89WvVzkH+ofnfP2+odfp0TqwKahsr071S5aLEUFir3Jx5zdjlNDv0DMI/LhrkDBw5Ikrp06VLt/vLycqWlpUmyD3PVadeunSTJw6Nub1e/fv1ktVrrdOzZPD28tDAx86Ljrul5mzoHdldxaaH2HP5O3+xcrp+L8up9fuCMbpHdVFpefEnPYfP0lBa80rBzWn9SxYxZkre3PKY/I4tXqwadP7JbpCylpQ06Z0OhfwCOGqOX1VRQUJA2b95cp2NdNswVFRVJkoqLq/9DSk5OVl5ennx9fRUWFuawv6KiQpWVlTpw4ICefPJJBQUFafTo0XWqxWq16vDhw3U69mytWnjXaFxgmxAFtjl9OfiaXrfput53KHFuf/1Sdkr3DH2y3nUAuTk5Kik7dWlP0qqlWjTgdLaSEpU/90epsFDuz0+XpWPDP2ojJzdHKvmlwedtCPQPwFGj9LJG4LJhLigoSAUFBUpPT9egQYPs9uXm5mrq1KmSpJiYGFksFofjhwwZUrVy17VrV6WkpCgwMLDOtTQETw+vOh0X3jFGEZdfoU/Wv0ozRoMI7tixUVbmjjbgfBUvz5X27pPb+HFyG9C/AWf+r47BHZv0ylxd0D/gyhqjl9VUfbKCy4a5+Ph4ZWRkaNasWUpISFBkZKQkadOmTRo3bpzy8k5fNjjfw4LfeOMNHT9+XPv379dLL72kG2+8UWlpaercuXOta6nrsum5KkqltXPrdmxpWbFOnspvkDqAzN2Zcve8tOcoqiiXf8rqBpmr4r0PZFv7lSyDBsrt3jENMmd1dmfulo9702yr9A/AUWP0ssbgso8mSUpKUrt27XTo0CH17NlTvXv3Vrdu3TRgwACFh4dr6NDTz5463/1yUVFRuuqqqzRmzBitWbNGJ0+e1OzZsxvzJdRa/onq78vbumetsqw/qHuXgY1cEeB8lVu3qfL1RVJIiNyTplS7Eg/6B2CypvkRsgGEhIQoNTVVU6dO1bp165SVlaXo6GgtWLBAEyZMUEREhKSLf/lBktq0aaOuXbtqz549l7rsepn7wSM6djJXfbsOVYc2XVRaXqLM7C36atu78mrpq1/f+mdnlwg0KtuxfFW8OFOqrJTbddfI9s23sp1nrCU8TJZwx/tnmwv6B2Aulw1zktSjRw+tWLHCYXthYaGysrLk5uamXr16XXSeI0eOaNeuXbrqqqsuRZkNJu6Ke7R6yxKt2fKWjhcdlUUWdfDvolsG/lqjh0xVe//aXyIGTGbLzpZ+PiFJqlyWfMGxbvfdK/dmHOboH4C5XDrMnc+OHTtks9kUGRkpb2/7b3jdd9996tq1q/r27as2bdooMzNTL7/8sjw8PPT44487qeKaGdJntIb0qds3bgFX5NYnRm5ffOrsMoxA/wDM1SzD3Pbt2yVVf4l14MCBWrJkif7617+qpKREnTp1UlxcnJ566qnzPrMOAADAWQhz50hMTFRiYmJjlwQAAFAnLvtt1gu5UJgDAAAwSbNcmTvze1sBAABM1yxX5gAAAFwFYQ4AAMBghDkAAACDEeYAAAAMRpgDAAAwGGEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAINZbDabzdlFoGZsNqmyzNlVAJJbC8liubTnsNlsOlVZcWlP0sC83dxludRvTB3RPwBHjdHLGgNhDgAAwGBcZgUAADAYYQ4AAMBghDkAAACDEeYAAAAMRpgDAAAwGGEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAIMR5gAAAAxGmAMAADAYYQ4AAMBghDkAAACDEeYAAAAMRpgDAAAwGGEOAADAYIQ5AAAAgxHmAAAADEaYAwAAMBhhDgAAwGCEOQAAAIMR5gAAAAxGmAMAADDY/wekUCDiZ+sH7QAAAABJRU5ErkJggg==",
      "text/plain": [
       "<Figure size 789.163x367.889 with 1 Axes>"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Example: internal structure of a StubFunction gate\n",
    "# Note: \"_dg\" suffix means an inverse\n",
    "\n",
    "qc = StubFunctionQC(password)\n",
    "qc.draw(\"mpl\", style=\"clifford\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "id": "e84060d4-4c29-43a5-a229-95f68047ea1d",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAnMAAAFvCAYAAAAhTE1zAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8g+/7EAAAACXBIWXMAAA9hAAAPYQGoP6dpAABAUElEQVR4nO3deVhV5f7+8XszwwacFRAnFGfFxCFzQEzN2SyH+ppax9IGkzomllbqOaY51dFssLL8VUZWdhq0zAo1M8sRMzVFUw8geCI1ZVCZfn8Q+0iAsjewN2vzfl2XV67pWZ+1Jbh51vOsZcrLy8sTAAAADMnF0QUAAADAdoQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAbm5ugCULy8POlKjqOrKD0PV8lkcnQV+fLypNwsR1cBo3Jxrxxfy3l5ecrIyHB0GVbx8fGRqTJ8eEAVQ5irpK7kSDPWOrqK0ls4RvKsJF9NuVnS5uWOrgJGFTlVcvVwdBVSRkaGfH19HV2GVdLS0mQ2mx1dBlDlcJsVAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwCUSrdu3eTiwo8NoLKpJG/TBACUN1dXV0VERKhr164KDw9X27Zt5evrK5PJpLS0NB08eFB79uzRzp07tXnzZmVnZ5fY1qhRo/Tuu+9q7dq1Gj9+vHJzc+14JQCuhTAHAE6mbt26uvfeezV58mQ1bNiwxP2aN2+uESNGSJKSkpL06quv6rXXXlNycnKh/QqCnJubm8aOHatvvvlGb775ZoVeA4DSqxL95ampqYqOjlazZs3k5eWlBg0aKCoqSunp6Zo4caJMJpNWrFjh6DIBoExMJpMeeOABHT9+XM8880yRIJeenq6EhAQlJCQoLS2t0Lb69etr7ty5On78uB555BHL7dSrg5wkvf7661q9erVdrgdA6Th9z1xcXJwGDhyolJQUmc1mtW7dWqdPn9by5ct1/PhxnT17VpLUoUMHxxZaQRIPbdG6+ZHqcedihQ9+rNh9lt1lUuMOgzX8sfV2rs4xcnNz9e/vlmnDDyuVcu6kqpvrqFfYaE245R/y9jA7ujzAJkFBQXr77bfVp08fy7rc3Fxt2LBB77//vnbv3q2jR49abo+aTCaFhoYqPDxcI0eO1PDhw+Xq6ipvb289//zzuv322xUTE6Nly5YVCnKTJk1SXl6eQ64RQPGcOsylpqZq6NChSklJ0bRp0zR79mz5+flJkhYtWqQZM2bIzc1NJpNJ7du3d3C1sJeXP3tUH3+3XN3bjtDIiGn6z5nD+vi75TqetE8LJ33NAG8YTkhIiL755hs1btzYsu61117TM888o1OnThV7TF5eno4ePaqjR48qJiZGwcHBmjFjhqZMmSJJ6tGjh7p37y6TySSJIAdUZk79U2vq1KlKTEzUlClTtGTJEkuQk6To6GiFhYUpOztbjRs3lr+/vwMrhb2cTDmoT7a/oB5tb9OcCR9pUNf7dP+w53T/0OcUd3yztux/z9ElAlapX7++YmNjLUEuISFB/fr106RJk0oMcsVJTEzUww8/rIiICJ05c0aSLEFu7dq1BDmgEnPaMHf48GGtXbtWtWvX1oIFC4rdJzw8XJIUFhZWaP2JEyc0bNgw+fn5qUaNGho/frx+//33Cq8ZFW9zXIzy8vJ0W89HCq0f1PU+ebn76Ou97zimMMAGLi4uWrt2rRo1aiRJ+vnnn9WlSxd9/fXXNrdZr1491apVq9C60NBQubq6lqlWABXHacNcTEyMcnNzNXbsWPn6+ha7j7e3t6TCYe7ixYuKjIxUYmKiYmJi9Oqrr2rbtm0aMmSIoafiZ1/JUObF1GL/VCVHEnbJxeSiFg27FFrv4e6lkKAOOpqwy0GVAdaLiopS9+7dJeX/Etq3b1+lpKTY3N5fJzucP39ektSxY0c9/vjjZa4XQMVw2jFzsbGxkqTIyMgS90lMTJRUOMy9+uqrSkpK0rfffmuZCRYcHKybbrpJn376qW699daKK7oC/bButn5YN9vRZTjc7xdOy99cWx5unkW21a5WX4dOfa+s7Ctyd/NwQHVA6TVq1EjPPPOMpPyJDuPHj7fcHrVFcbNWV65cqR07dsjNzU1PPfWUPvjgAx05cqRc6gdQfpw2zBWMFSm4/fBX2dnZ2r59u6TCYW79+vXq0aNHoSn93bp1U0hIiD777DObwlynTp2s/m3Z1d1bI+bFW32ukrSNnKTQrqOK3fbvZ/uVuf3moaHKycosczvlwcPNW69OKf6zu3wlQ+7FBLn847zy98nKIMxVYaHNQ3Ul2/Ffy9e7E/Dggw9a7i688MIL+u6772w+V3FBrmCM3MKFCzVr1ix5eHjo4YcftkyQKE5oaCgTiAAbBQQEaPfu3TYd67RhLj09XZKUmVn8N+W1a9cqNTVVfn5+atKkiWX9oUOHNGpU0dDTpk0bHTp0yKZaUlJSlJSUZNUxbp4+Np2rJNUDQtWwbd9ybfNqp5NPK/tyRoW1bw0v95I/O08PH2Wm/bfYbVeyL+Xvc43j4fyST5/WpazK8bVcEi8vL02cOFGSdPnyZc2bN8/mtq4V5KT8mf9RUVHy9fXV+PHj9fjjjxd5Rl2Bvz5sGIB9OG2YCwgI0Llz57R3715169at0Lbk5GRNnz5dktS+fXvLjC1JOnfunKpXr16kvZo1a9p8eyEgIMDqY1zdvW06l6MEBQZVqp65ktTyD9J/zhzSlezLRW61pv6RpGrm2vTKVXGBQUGVpmeupHA0bNgwyySFDz74QKmpto19vV6Qk6QLFy5ozZo1mjx5svz8/DRq1KgS3/4QGBhIzxxgI1uyQgGnDXN9+/bV4cOHtXDhQvXr10/NmzeXJO3atUvjxo2zfPOzx8OCbek2vZwtzVhbAcVUkKPx8fKsJF9NOVekzcuL39aiQWftObpJR/6zU+1CelrWX8m6pF9Px6ldSC87VYnKKv5ovFwrQZ5PT08vcfLW1b+grlmzxqb2SxPkrj7H5MmTJUk33nhjiWEuPj5eZjMP3gbszWl/hYqOjlatWrWUkJCgNm3aqF27dgoNDVWXLl0UEhJieUr6Xx9LUqNGDcsMrqudPXtWNWvWtEfpqEC9w8bIZDLpo23/KrT+8x9f06WsDPW5YaxjCgOsUPBYJSn/F1RrWRPkJGnv3r3Kyckpcm4AlYPThrng4GBt27ZNgwcPlpeXl06ePKmaNWtq5cqV2rBhg44ePSqpaJhr1apVsWPjDh06pFatWtmldlScJoHtNOymh/Tdzx9pzv+7TZ//+Lpe+WyaXvns72ofEqE+N/yfo0sErqvgjTWnTp2y+hmY1gY5Kb+X8JdffpEktWvXrtDQFACOV0lujFWMVq1aaf36ou8bTUtL08mTJ+Xi4qK2bdsW2jZkyBDNnDlTiYmJCg4OliT9+OOPOn78uBYvXmyXulGxHhj2L9Wr0Vif//iqdh7eIH9zbd3a/WFNuOUfjPeBIVSrVk2SrJ4lb0uQK3DmzBm1adNGHh4e8vLyKnFyGQD7M+VVwfez/Pjjj7rxxhvVokULy2+bBS5cuKB27dqpdu3amjt3ri5duqTo6GjVqVNHO3bssNsPe6ONmVs4RoYYMwdcT+RUVfoxcwEBAfLy8lJeXp5Vr+xasmSJpk2bJsn6d602aNBAbm5uyszM1JkzZ4o9Li0tjTFzgANUkh+/9nXgwAFJRW+xSpK/v79iY2MVFRWlO+64Q25ubhoyZIief/55em0AVAq2vuXhsccek5ubm8xms9XvWk1ISLDpnAAqHmGuGE2bNi329iwAGN0jjzwik8lkVZADULlVya6m64U5AHBmBDnAuVTJnrmC97YCAAAYXZXsmQMAAHAWhDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYWJV8N6sReLhKC8c4uorS83B1dAWAc/Hx8VFaWlq5tbd45Xu6kJ4hf7OPpk++o8hyefDx8SmXdgBYhzBXSZlMkif/OkCVZTKZZDaby609D08veWTlyMPTS2azucgyAOPiNisAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBuTm6ABQvL0+6kuPoKkrPw1UymRxdBQBnkZeXp4yMDEeXYRUfHx+Z+EYIByDMVVJXcqQZax1dRektHCN58tUEoJxkZGTI19fX0WVYJS0tTWaz2dFloAriNisAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBEeYAAAAMjDAHAEApubjwYxOVD2/TBAA4NW9vb4WFhaljx46qU6eOPDw8dPnyZSUkJGjPnj06dOiQsrOzr9vO0qVLVa9ePU2YMEE5OTl2qBwoHcIcAMDpeHh4aOTIkbr//vvVrVs3ubmV/OMuMzNTX375pV566SV9/fXXysvLK7LP0qVL9fe//12SlJubq/Hjx1dY7YC1qkR/cWpqqqKjo9WsWTN5eXmpQYMGioqKUnp6uiZOnCiTyaQVK1Y4ukwAQBm5uLgoKipKCQkJWrNmjXr27HnNICfl99zdeuut2rRpk44cOaLhw4cX2v7XILd58+YKqx+whdP3zMXFxWngwIFKSUmR2WxW69atdfr0aS1fvlzHjx/X2bNnJUkdOnRwbKEVJPHQFq2bH6kedy5W+ODHit1n2V0mNe4wWMMfW2/n6hwjJnaB4pP2Kj5xj1LOnlC9Go30zsyTji4LQBmFhobqjTfeUI8ePQqtP3LkiLZv367du3fr119/VVZWlry9vdWyZUt16tRJvXr1UlBQkKWNjz/+WGvWrNHUqVM1a9asQkHu3nvv1Ztvvmn3awOuxanDXGpqqoYOHaqUlBRNmzZNs2fPlp+fnyRp0aJFmjFjhtzc3GQymdS+fXsHVwt7eeOLmfLzqanQ+h2Vnnne0eUAKAd9+/bVxx9/LLPZbFn33nvv6cUXX9R3331X7DEbNmyQJLm6umro0KGKiopS7969JUljx47V0KFD5e/vL4kgh8rNqW+zTp06VYmJiZoyZYqWLFliCXKSFB0drbCwMGVnZ6tx48aW/2Hh/N56/Lg+mvu7Fk76SrX8gxxdDoAy6t+/v9avX28JcseOHVOvXr105513lhjkrpaTk6OPP/5YkZGRGjdunM6dOydJBDkYhtOGucOHD2vt2rWqXbu2FixYUOw+4eHhkqSwsDDLuoLw16VLF3l6espkMtmlXthPYK0QR5cAoJy0adNG//73v+Xp6SlJ+uijjxQWFqZt27bZ1N4777yj999/v9C6s2fPat26dWWuFagoThvmYmJilJubq7Fjx8rX17fYfby9vSUVDnPHjh3TunXrFBAQoM6dO9ulVnvIvpKhzIupxf4BACNyc3PT6tWr5ePjI0lat26dRo8erYyMDJvbXLp0qSZPnixJllmttWvX1nPPPVf2goEK4rRj5mJjYyVJkZGRJe6TmJgoqXCY69Wrl5KTkyVJc+bM0fbt2yuwSvv5Yd1s/bButqPLAIByM336dHXq1EmSdOjQIY0dO7ZMz3/766zV6OhoPf300/L399fEiRP14YcfauPGjeVSO1CenDbMnTp1SpLUqFGjYrdnZ2dbgtrVYa4inu7dqVMnpaSkWHWMq7u3RsyLL7ca2kZOUmjXUcVu+/ez/crcfvPQUOVkZZa5nfLg4eatV6eU32eHqiW0eaiuZFeOr+XyNOKeR2T29VdySrKCg4OLLFc2ubm519zu5+enmTNnSsof83b33Xfr8uXLNp/vr0GuYIzcH3/8oddee02SNH/+/GuGudDQUN4QAZsFBARo9+7dNh3rtGEuPT1dUv7DIIuzdu1apaamys/PT02aNKnQWlJSUpSUlGTVMW6ePuVaQ/WAUDVs27dc27za6eTTyr5s+62N8uTlXr6fHaqW5NOndSmrcnwtl6fcP3uscnNylJSUVGTZaMaNG2cZQrNq1Srt2rXL5rZKCnKS9Prrr2vy5Mnq1KmTbrjhBnXt2lU//vhjse0U3NUB7M1pw1xAQIDOnTunvXv3qlu3boW2JScna/r06ZKk9u3bV/gkh4CAAKuPcXX3roBKKk5QYFCl6pkDbBUYFOSUPXMurq6W/9avX7/IcmWTm5t7zXD0wAMPWP5eloe+XyvIXd3+6tWrJUkPPvhgiWEuMDCQnjnYzJasUMBpw1zfvn11+PBhLVy4UP369VPz5s0lSbt27dK4ceOUmpo/8N8eDwu2pdv0crY0Y20FFFNBjsbHy7OSfDXlXJE2L3d0FTCq+KPxcvVwdBXlb/6La3QhLV2BAYFKTEwsslzZpKenlzh5LSgoSG3btpUk7dixQwcOHLDpHKUJclL+nZxly5apWrVq6t+/f4ntxcfHF3rOHWAvTvsrRHR0tGrVqqWEhAS1adNG7dq1U2hoqLp06aKQkBD16dNHUuHxcgCAyq/gsVKStHXrVpvaKG2Qk6RLly5p586dkvJ7TwreFgFUFk4b5oKDg7Vt2zYNHjxYXl5eOnnypGrWrKmVK1dqw4YNOnr0qCTCXFX01Z63tebreVrz9TydT/9N6Zf+sCx/tedtR5cH4Do6duxo+fuePXusPt6aIFfceQpm0AKVRSW5MVYxWrVqpfXri75vNC0tTSdPnpSLi4ulqx5Vx8adq/TTr4V/m1/95VOSpPYhEeoXPs4RZQEopat7xgp+MS8tW4KclP9+1wKBgYFWnROoaE4d5kpy8OBB5eXlqXnz5paHTV7tww8/lJT/3KKrlxs3bmy438iCW/dW1Dt519znetudzdIHtji6BABl8Omnn+r06dPy8vKyagbp8OHDbQpykrR//34tWLBAmZmZNj8+AqgoVTLMFQyWLekW66hRo4pdnjBhgmVGEwDAMTZs2KANGzZYfdwnn3yi5cuXa8qUKVa/a3Xfvn3at2+f1ecE7IEwV4yCV7gAAJxLVFSUYmJi9MMPPzi6FKDcOO0EiGu5XpgDADgvghycTZXsmSt4bysAAIDRVcmeOQAAAGdBmAMAADAwwhwAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBVcl3sxqBh6u0cIyjqyg9D1dHVwDAmfj4+CgtLa3c2lu88j1dSM+Qv9lH0yffUWS5PPj4+JRLO4C1CHOVlMkkefKvA6CKMplMMpvN5daeh6eXPLJy5OHpJbPZXGQZMDJuswKV2KL37la/6SZHl2E3KWdPqt90k97aNMfRpQCAYdD3A1gh+fdf9d7mZ3Xg12/13/P/kbubp2r4Bahlgy7q3+ludWgWKUl6a9McNQ3qoO5tb7VrfdcKfhMHLtAdfR63YzXFSzl7Upt2r9ZNbW5Vs/odHF0OABgeYQ4opSMJu/XYyxFydXVXv/DxalSvja5kZyrxt3jtid8kb08/S5h7+6u56hc+we5hTpKaBnXQyF7TiqxvVv8Gu9dSnDPnTurtr+aqXo3GRcJcvRqNtGF+plxd+NYEAKXFd0yglN75aq4uZWXolSlxahoUVmT72QspDqiqqNrV6qtv+F2OLsMmJpNJHu5eji4DAAyFMXNAKSWlxsvfp1axQU6SavoHWMZ8SdJXe/6f+k03Wf5I1x4T9tamOeo33aSUsyeLbDuf9psWxozXbbNraehMs6avvFnxiXttuo5+001a9N7dRdZ/uWu1+k03af/xLUVqSvjvEa36YqbunBesQY97avJzYfrx8OfFtr/tp3Wa9nJv3fpUdQ2Z6aN7FrXQix9PVVb2FX25a7UeeyW/93LJ+/dYPptpL/eWVPLnk5OTrfc2L9TExa016Akv3Ta7luasHqETyQcK7Xf18T8cWq+HlnXWoCe8NOYfgXp1/XTl5GTb9JkBQGVGzxxQSoG1mirhtyPaduAj9Wx3W7H7VPOtoxl3vK2F741TuyY9NajrpHI598zXB8jPp6bG95ujsxdT9Mn3KzTtlQgtm7JDTQLaFto3OydLf6SnFlpnMrnI36emzedftHaC3FzdNSriMWVlX9FH3/1Lc/7frXoz+qgCaja27PfGF7MUEztfjeq11u09H1VN/0Cd/v24vjuwThNu+Yfah/TSnX1mKiZ2vgZ3naS2TXpKkmr41bvm+RfEjNXW/e+rY2g/De32gM5eTNGn37+oPSu66fkHtxW5hbzzl8/12fcvaXC3+zWg89/0/cFP9MHWJfL1rqH/u3mmzZ8DAFRGhDmglMbe/KT2xn+lf7x1u+rXDlXbJj3UIriz2jftrUb1WkmSvD3M6ht+lxa+N04BNUPK7XZn3RqNNHv8OplM+T18PdrdpinLO+vVzx7Tgvs2Ftp3z9FNGjmnTqF1NXzr6f3Ztt8GrmaurX/e85nl/B2aRWrK8i7a8MNKTRy0QJL0y392KiZ2vjo0jdQzEz8vdLv03kHPSpJ8vasrvHk/xcTOV6tG3Ur1+ew5+pW27n9fEWGjNWvse5YaIsJG68Fl4Xrxk6l6/sFthY45lXJQrz120BI0h3S7X5OWttMn218gzAFwOoQ5oJRaN+6ml6L26IOtS7XryBf6cteb+nLXm5Kkdk16avqY1QqsFVIh5x7dO9oSYiSpeXC4Oob2095jXyvzcpq8PX0t21o27Kp7bplX6Hh3N88ynX9Ej6hC52/RoLO8PX2VlBpvWffNvjWSpL8NWlBk3NvVx1pr+8//liT9X59ZhdppGhSmbq2GavvBj3U+7TdV9/1fgL2p7a2FegxNJpPCmkXqk+0rinxeAGB0hDnACk0C2yn6jtWSpDPnTumn41v1xc7XdeDENj29erheitojdzePcj9vo7qtiq6r11p7jm7SmXOn1DigjWV9NXNtdWzet1zPH1izaEj196mlCxm/W5aTUuNlMpnUNLD4MYW2Sjl7Qi4mFzWsV8xnENBG2w9+rJSzJwqFuZLqlaQLGb8T5gA4FSZAADaqV6OR+nUar6UPbFWbxt11MuVnHUnYec1jrtVDlZPr2MH51zq/i0vx72vLy8srtGySKf/1JQ5WUr1S0ZoBwOgIc0AZmUwmtWzYVZKU+kfSNff1886fhHAx42yRbcm//1ricaf+e7joujOH5OLiqno1GllTrvx8aupiZjHnP1vy+UsjuHZz5ebl6tfT+6+zp3VhL6BmiHLzcvWfM8V/Bvn7NLGqTQBwJoQ5oJT2HP2q2EdbXM7K1J6jmyTl3/qUJG9P32IDk4+Xn2r6BSjuWGyhHqLk33/V9wc/LvHc729ZVGj/+MS92hf/tW5odrPVtwyDazfX4VM7dOlKhmXdxYxz2vTn+D9b9bnh/yRJb3wxU1nZV4psL6i/oN7iAm1xCh68HLN5QaHP4ETKz9px6FO1bdKj0C1WAKhqGDMHlNIrnz6qCxm/q1vrYWoc2E5e7j767XyCYuPeVeJvR9UvfLyaBLaTJLVqeKP2xX+t9zYvVN3qDWUymRTZ4Q5J0rDuU7R645Oa+fpA3dT2Vv1+4bQ27HhFjQPa6kjCrmLP/d9zp/T4a7eoW5thOnshWZ98v0Ie7t6aNHix1dcxvPsUPRtzl6av7KO+Hccp7dJ5ffHja6pbo5HOXrR9xmvLhl00JnKG1m5eqAf/1VERYWNU0z9AyWdPaNtPH2rF1J3y9a6uRvVay8fTT5/teEmeHj7y9a6u6r51dUOzPsW2G968nyLCRmtL3HtKyzinrq2H6NyfjybxcPPSQ8OX21wzADgDwhxQSpOHPqfvD36igye/07YD65R26bzMXtUUEtheY3rPUP9Od1v2fXjES3rh3w8p5ptnlHH5oiRZwtwdvWcoI/MPfb33be3/dYsa1Wutv49epfjEPSWGufn3btQrn/1db22arStZmWrV8EbdN2SxQoLaW30dN3ccq98vnNYn21do5Wd/V0CtEN3V92mZTC765T8/Wv/BXOXeQc8qJDBMn2xfofe3LlJebq7qVG+gLi0HydPdR5Lk6e6tmWPf0+ovn9TLnz6irOzLah8SUWKYk6Qn7lyjZvU7atPu1Xr1s2ny8jCrfUiE7r7ln5YADQBVlSmP0cBwMjlXpM101sBGkVMl1/KfkOxw819cowtp6fL3NWvmQ2OLLDu7qn79cG6MmQMAADAwwhwAAICBEeYAAAAMjAkQlVRennQlx9FVlJ6Ha6V4ViwAOI28vDxlZGRcf8dKxMfHp0yv74NtCHOV1JUcacZaR1dRegvHSJ58NQFAucnIyJCvr7FePZeWliaz2ezoMqocbrMCAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAABUAS4uLgoKClLTpk3VuHFjVatWzarjfXx8NGPGDLm4EB0qG96mCQCAk+revbtGjhypTp06qUOHDkXe9Xrq1Cnt2bNH27dv11tvvaXU1NRi2/Hx8dHnn3+uiIgItWvXTuPHj1dubq49LgGlQLwGAMCJuLq66r777lNcXJy+++47PfLII+rRo0eRICdJjRo10m233aalS5cqMTFRb731lsLCwgrtc3WQk6TBgwcrJCTELteC0qkSYS41NVXR0dFq1qyZvLy81KBBA0VFRSk9PV0TJ06UyWTSihUrHF1mhUg8tEXL7jJpz4YlJe6z7C6TPlkyxI5VOVbib0e1+sun9fALN2rknDoa9qSfJj/XQWu+eUaZV9IdXR4A2KxNmzb64Ycf9OqrrxYJZSdOnNAnn3yid955RzExMfr222918eJFy3ZPT0+NGzdOu3fv1rx58+Th4VEkyJ0/f159+/bVsWPH7HpduDanv80aFxengQMHKiUlRWazWa1bt9bp06e1fPlyHT9+XGfPnpUkdejQwbGFwm427npDn37/orq1HqabbxgrV1d37T++Was3Pqlv97+v5Q//IE93b0eXCQBWmTJlipYsWSJPT0/Luu+//14vv/yyPv/8c8vPu6u5uLioVatWGj9+vCZOnKhatWrJzc1Ns2bN0q233qq0tDR17dpV0v+C3J49e+x2TSgdpw5zqampGjp0qFJSUjRt2jTNnj1bfn5+kqRFixZpxowZcnNzk8lkUvv27R1cLeylZ7uRujPyCZm9/zf4d2i3+1W/dqje/eYZfbFzlW7tPsWBFQKAdZ5++mnNnTvXsnzo0CHde++92rFjxzWPy83N1cGDBzVjxgzNnj1bjz32mJ566il5eHioTZs2lv0IcpWbU99mnTp1qhITEy2/rRQEOUmKjo5WWFiYsrOz1bhxY/n7+zuwUthTiwadCgW5Ar3DxkiSTqb8bO+SAMBmUVFRhYLc0qVL1bFjx+sGub+6dOmS5s2bp549eyo9/X9DTnJzc3XXXXcR5Coxpw1zhw8f1tq1a1W7dm0tWLCg2H3Cw8MlqdC4gg8//FC33367GjVqJB8fH7Vs2VKzZs1SWlqaXequKNlXMpR5MbXYP8j32x+JkqQavvUcXAkAlM4NN9ygJUv+Nyb60Ucf1WOPPabLly/b1J6Pj48WLVoks9lsWefi4qJHH31UJpOpzPWiYjjtbdaYmBjl5uZq7Nixxc7gkSRv7/xxUVeHuSVLlqhhw4aaP3++goODFRcXp7lz52rr1q369ttvDft8nR/WzdYP62Y7uoxKKyc3R2u+/qdcXdzU54b/c3Q5AHBd7u7uWr16tdzc8n+UL1iwQP/6179sbu+vkx3++OMPZWZmKiAgQDfffLMmTZqklStXlkfpKGdOG+ZiY2MlSZGRkSXuk5iY3xNzdZj77LPPVKdOHctyRESE6tSpo7Fjx+q7775Tr169KqjiitU2cpJCu44qdtu/n+1n52oqn5c/fUSHTu3Q3wbOV4O6LRxdDgBc19SpUy3jvePi4jR7tu2/sJc0a7VGjRr66quvJEmLFy/W+++/r3PnzpW9eJQrpw1zp06dkpT/DJ3iZGdna/v27ZIKh7mrg1yBTp06SZKSkpJsqqVTp05KSUmx6hhXd2+NmBdv0/mKUz0gVA3b9i239v6qeWiocrIyK6x9a3i4eevVKaX/7FZvfEqfbF+hwV0n6c4+T1RgZTCC0OahupJdOb6Wy9OIex6R2ddfySnJCg4OLrLs7Ix4/dd6KK+Li4seeughy/I999yjrKwsm85TUpArGCO3atUqTZw4UX5+fpowYcI1e/9CQ0MNewfL0QICArR7926bjnXaMFcweDMzs/hvymvXrlVqaqr8/PzUpEmTa7a1efNmSVKrVq1sqiUlJcXqIOjm6WPTuRzldPJpZV/OcHQZkiQv99J/dm9tmqM138zTLZ3vUdTtr1RgVTCK5NOndSmrcnwtl6fcnBzLf5OSkoosOztnu/4BAwZYfnZ98cUXiouLs6md6wU5Kf/pDxMnTpQkPfjgg1q2bJny8vKKbS85OdmmOlA2ThvmAgICdO7cOe3du1fdunUrtC05OVnTp0+XJLVv3/6agzqTkpL01FNPacCAATY/iy4gIMDqY1wN9pyzoMCgStUzVxpvbZqjt7+aq37hE/T3ka8zuBeSpMCgIKfsmXNxdbX8t379+kWWnZ0Rrz83N7fEcHTnnXda/v7SSy/Z1H5pgpwkHT16VF9//bX69u2r0NBQhYeHl9iDFBgYSM+cjWzJCgWcNsz17dtXhw8f1sKFC9WvXz81b95ckrRr1y6NGzfO8v65awW0tLQ0DR8+XB4eHnrjjTdsrsWWbtPL2dKMtTaf0u6OxsfLs5J8NeVckTYvv/Y+b3/1D7391Vz17ThOj41+g28+sIg/Gi9XD0dXUf7mv7hGF9LSFRgQqMTExCLLzs6I15+enl7iBL7OnTtLyn+cyMaNG61uu7RBrsAnn3yivn3zh+p06tSpxJ9r8fHxhWbCwj4qyY/f8hcdHa13331XCQkJatOmjVq2bKlLly7p2LFjGjhwoBo3bqwvv/yyyOtOCmRmZmro0KE6ceKEtm3bpsDAQDtfASrKJ9tf1FubZqtu9YbqGNpXsfveLbS9hl89hTdnUgiAysnPz08tWuRP1Prpp5+UnZ1t1fHWBjlJhbYVPNYLlYfThrng4GBt27ZN06dP19atW3Xy5Em1bt1aK1eu1H333aemTZtKUrFhLisrSyNHjtTu3bv1zTffqHXr1vYuHxXoSMIuSdJ/z/9Hi9ZOKLK9fUgEYQ5ApVVwp0mS9u/fb9WxtgQ5SYXG5Nk6fhwVx2nDnJT/Bbd+/foi69PS0nTy5Em5uLiobdu2hbYVPJvum2++0eeff64uXbrYq9wKEdy6t6LeKX6gaoHrbXc20XesVvQdqx1dBgDY7Pjx4/L29rZq8oanp6dNQU7Kv1uVlJSknJwc/fbbbzbXjYrh1GGuJAcPHlReXp6aN28uH5/CMx8feughffDBB3r88cfl4+OjH374wbKtadOmxT66BAAAe9mzZ4+aNWtm9XGXL19WXFycIiIibHrXamV9hAuqaJg7cOCApOJvsX7xxReSpGeffVbPPvtsoW1vvvmm7r777gqvDwCAivDII48oPT1dH330Ee9adSKEub84efKknasBAMB+Zs2a5egSUM6q5PMYrhXmAAAAjKRK9swVvLcVAADA6KpkzxwAAICzIMwBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwKrku1mNwMNVWjjG0VWUnoeroysAAOfi4+OjtLS0cmtv8cr3dCE9Q/5mH02ffEeR5fLg4+NTLu3AOoS5Sspkkjz51wGAKstkMslsNpdbex6eXvLIypGHp5fMZnORZRgXt1kBAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBEeYAAAAMjDAHAABgYIQ5AAAAAyPMAQAAGBhhDgAAwMAIcwAAAAZGmAMAADAwwhwAAICBEeYAAAAMzM3RBQAAAPxVXl6eMjIyHF2GVXx8fGQymex+XsIcAACodDIyMuTr6+voMqySlpYms9ls9/NymxUAAMDACHMAAAAGRpgDAAAwMMIcAACAgRHmAAAADIwwBwAAYGCEOQAAAAMjzAEAABgYYQ4AAMDACHMAAAAGRpgDAAAohfr168vV1dXRZRTBu1kBAIDTqlevnrp27arw8HCFhYWpWrVqcnFxUWZmpo4ePardu3dr9+7dOnTo0DXbadasmTZv3qytW7dq/Pjxys3NtdMVXB9hDgAAOBWTyaT+/fvrwQcf1ODBg0vsTbvlllssf//555/10ksv6Z133tHFixcL7VcQ5IKDgzV27Fj9+uuvevrppyv0GqxRJW6zpqamKjo6Ws2aNZOXl5caNGigqKgopaena+LEiTKZTFqxYoWjywQAAGV0ww03aN++fdq4caOGDRtW6tuibdu21UsvvaSEhATde++9lvVXBzlJ+umnn7Rs2bIKqd1WTt8zFxcXp4EDByolJUVms1mtW7fW6dOntXz5ch0/flxnz56VJHXo0MGxhcJuEv57RO98/Q/FJ+3V7xdOKycnS3WrN1SXloM0qvd01fIPdHSJAAArubm56amnntLMmTPl5va/eJOQkKCYmBjt3LlTe/fu1enTp5WXlyd/f3+1b99e4eHhGjZsmHr06CFJqlatml577TWNHDlS8+bNU0xMTKEg16dPH/3+++8OucaSOHWYS01N1dChQ5WSkqJp06Zp9uzZ8vPzkyQtWrRIM2bMkJubm0wmk9q3b+/gamEvv/2RqLMXktW97QjVqRYsVxc3nUg5oA0/vqrN+9/TK4/GqYZvXUeXCQAoJU9PT61du1bDhw+3rNu/f79mz56t9evXKycnp8gxqampio2NVWxsrBYvXqz27dtr+vTpuuuuuyTl34K9+eabLcGwsgY5ycnD3NSpU5WYmKgpU6ZoyZIlhbZFR0fr3Xff1f79+9WkSRP5+/s7qErYW8fQm9Ux9OYi69s16aV574zWpl2rNSYy2gGVAQCs5ebmpvfff1/Dhg2TJGVlZemZZ57R/PnzlZWVVep2fvrpJ40bN07vvvuu3njjDQUEBFiC3C+//FJpg5zkxGPmDh8+rLVr16p27dpasGBBsfuEh4dLksLCwizrtm3bpr59+yowMFCenp4KDg7WmDFjdPjwYbvUDcepV6ORJCkt85yDKwEAlNb8+fMtQS4tLU0DBgzQ3LlzrQpyV4uPjy8yU9VkMiktLa3MtVYUpw1zMTExys3N1dixY+Xr61vsPt7e3pIKh7lz586pXbt2Wr58uTZt2qSFCxfq4MGD6tatmxITE+1SO+zjStYl/ZGeqt/OJ2r3kU3617rJkqQuLQc5uDIAQGnceOONmjZtmiTp8uXLGjp0qGJjY21ur2CyQ1BQkCTp0qVLkqQWLVpo7ty5ZS+4gjjtbdaCf8zIyMgS9ykIZ1eHuWHDhlkSfoHOnTurRYsWWrdunaKioiqgWjjC5ztf14sfP2xZDqjRWI/f+Y7ahfR0YFUAgNJwd3fXm2++KReX/H6pp59+Wlu2bLG5veJmrT7wwAOKjY2Vp6enHnvsMX3wwQfas2dPeZRfrpw2zJ06dUqS1KhRo2K3Z2dna/v27ZIKh7ni1KpVS5IKzY6xRqdOnZSSkmLTsbCeh5u3Xp0Sf939ure5VQ3rtFTmlTQdS9qnHYc+1R/pqXaoEJVZaPNQXcnOdHQZ5W7EPY/I7Ouv5JRkBQcHF1l2dlX9+iXjfQbXeyjviBEj1LJlS0nSjz/+qKVLl9p8ruKCXMEYuTlz5mjBggVydXVVdHS0xowZU2I7oaGhlnBprYCAAO3evdumY502zKWnp0uSMjOL/6a8du1apaamys/PT02aNCmyPScnR7m5uTp16pSeeOIJBQQEaPTo0TbVkpKSoqSkJJuOhfW83H1KtV+d6sGqUz3/f9zubW9Vz3a3a8ryzrqclaE7+zxRkSWiEks+fVqXsjIcXUa5y/1zNl9uTo6SkpKKLDu7qn79kvN9Bg8++KDl70888USxM1ZL41pBTpKWLl2qqKgoBQQEaMSIEQoMDFRycnKxbZW0vqI5bZgLCAjQuXPntHfvXnXr1q3QtuTkZE2fPl2S1L59e5lMpiLHR0REWHrumjVrptjYWNWpU8fmWmA/Hm7eNh0XEtReTevfoM++f4kwV4UFBgU5Zc+cy58PTnVxdVX9+vWLLDu7qn79kvE+g9zc3BLDUfPmzRURESEpf8Lj5s2bbTrH9YKclD879vXXX9eTTz4pd3d33X333SVOrAwMDCxTz5ytnDbM9e3bV4cPH9bChQvVr18/NW/eXJK0a9cujRs3Tqmp+bfTSnpY8KpVq3T+/HmdOHFCixcvVv/+/bV9+3Y1bNjQ6lps7TaFbXKuSJuX23bslaxMXcw4W74FwVDij8bL1cPRVZS/+S+u0YW0dAUGBCoxMbHIsrOr6tcvGe8zSE9PL3ECY8+e/xvbvHr1apvaL02Qu/ocTz75pOXcJYW5+Ph4mc1mm+opC6edzRodHa1atWopISFBbdq0Ubt27RQaGqouXbooJCREffr0kVTyeLkWLVqoa9euuuOOO/TNN9/o4sWLWrRokT0vARXk7IXixy/GHduskyk/q2WjG+1cEQDAGgWPFpOkH374werjrQlyknT8+HFLJ9DV564snLZnLjg4WNu2bdP06dO1detWnTx5Uq1bt9bKlSt13333qWnTppKuP/lBkqpXr65mzZrp2LFjFV027GD5Rw/o94vJ6tCsj+pVb6Qr2ZcUn7hHW/a/J29PP00eYvsgWgBAxbv6rtq+ffusOtbaIFdg9+7dGjBggOrWrav69etXqnGGThvmJKlVq1Zav359kfVpaWk6efKkXFxc1LZt2+u289///ldHjhxR165dK6JM2FnkDXfqqz1v6Zs9b+t8+m8yyaR6NRpp8I2TNTpiuurWsP5WOgDAfgqeMnH27FldvHix1MfZGuSk/He8FqhRowZhztEOHjyovLw8NW/eXD4+hWc+3nXXXWrWrJk6dOig6tWrKz4+Xs8//7zc3Nz06KOPOqhilKeIsNGKCLNtZjIAwPHGjh2ratWqWT3ZYOzYsTYFOUl64YUX9OGHHyozM1MnTpywuuaKVCXD3IEDByQVf4v1xhtv1FtvvaVly5bp0qVLatCggSIjIzVz5swSn1kHAADsx9aJhXPnzlXNmjXVu3dvq9+1euDAAUt+qGwIc38xZcoUTZkyxd4lAQAAO4iKipKfn59Vt2crO6edzXot1wpzAADAuTlTkJOqaM9cWV7CCwAAUJlUyZ45AAAAZ0GYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIFVyXezwrm5uEuRUx1dBYzKxd3RFQCQJB8fH6WlpZVbe4tXvqcL6RnyN/to+uQ7iiyXBx8fn3Jpx1qEOTgdk0ly9XB0FQCAsjCZTDKbzeXWnoenlzyycuTh6SWz2Vxk2ci4zQoAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCXCUUGxsrV1dXNWvWzNGlAECJPv/8c3Xo0EGenp5q3LixnnvuOUeXZFfffvuthg8frkaNGslkMmnevHmOLsmuFi9erG7duqlGjRqqXr26evTooY0bNzq6LLt5++23FR4erho1asjb21utWrXSc889p7y8PLvXQpirZFJSUjRhwgT179/f0aUAQIl2796t4cOHa+DAgYqLi9OcOXM0c+ZMvfLKK44uzW7S0tLUunVrLVq0SAEBAY4ux+5iY2P1t7/9TZs3b9bOnTt10003aciQIdq+fbujS7OLunXr6qmnntL333+vgwcP6vHHH9dTTz2l5cuX270WN7ufESXKzc3VXXfdpYceekiXLl1SfHy8o0sCgGI999xz6ty5sxYsWCBJatWqlQ4ePKhnn31W999/v4Ors49BgwZp0KBBkqQZM2Y4uBr7++KLLwotL1q0SBs3btRHH32k7t27O6gq+7nlllsKLYeEhOjjjz/Wli1bFBUVZddaCHOVyD//+U+ZTCbNmDFDc+fOdXQ5AAwoI/OSElNSi6zPzsmx/PfoicQiy1cLqldLvj7e1zzP9u3bNXHixELrBgwYoCVLligxMVHBwcFluYwyOZGQrKzsnELrrLl+Xx8vBdWrbZ9iK8Dv5y7o9/MXiqy35jNo2jBIrq7W3bzLzc3VhQsXZDabbay8fGRlZ+tEQkqR9dZcf52a1VSjml+pz5mXl6ddu3Zp+/btevLJJ8tQvW0Ic5XE5s2b9corr2jfvn0ymUyOLgeAQXl6eOjLb3cqqZhAJ+WHvTfe/7zE5Xq1a2jKhBHXPU9ycnKRW4sFy8nJyQ4Nc0lnUrX+mx3Fbrve9Zsk3XfnkIousUK5urro3U++1qXLV4rdfr3PILxdczVvYv2/3/z583X+/HlNmjTJ+qLLkZurq3bGHdbPR08Uu/1612/28dKjfxtVqnP98ccfql+/vq5cuaLc3FzNnj1bU6dOLdsF2IAxc5VAamqq7rrrLr355ptVctwFgPLj6uqiMUP6yM3N1fpjXVw0Zkik3N2M/Xv+TeFt1axRfZuO7dmlvUIaBpVzRfZV3d9Xw/vZdpuzRjU/Db35JquPe+mllzR//nx9+OGHDg3ykmQymTTilp7yNV+7d7kktw/oVepj/fz8FBcXp927d2vFihV67rnntGrVKpvOWxaEuUrg559/1unTpzVkyBC5ubnJzc1N//jHP3T8+HG5ubnp3XffdXSJAAykbq3qGti7q9XH9evZqdS3FwMDA5WSUvhW1pkzZyzbHMnFZNLIQRHy8vSw6riAOjXVv2fnCqrKvjq0bqZ2LUKsOsYkafTg3lZ/bkuWLNH06dP16aefqm/fvlYdW1HMPl4aOTDC6uM6tW+h1qGNS72/i4uLmjVrpvbt2+v+++9XdHS0Zs2aZfV5y4owVwl07txZBw4cUFxcnOXP/fffrwYNGiguLk6DBw92dIkADKZbxzZW9U41ql9Pvbq0L/X+3bt315dffllo3caNG9WoUSOH98xI+b1Tt/bvUer9XV1cNHpIpE09mpWRyWTSrbf0kJ+vT6mP6dU1TE0aWBfEn376ac2dO1eff/55pQlyBVo2baiuHVqVev+a1fw0tE+3Mp0zNzdXly5dKlMbtjB2X7qTMJvNatu2baF1devWlYeHR5H1AFAaLiaTRg2K0PNvfFji2KkCHh7uGj0kUi4upf/9/tFHH9VNN92kWbNmady4cfrxxx/1wgsv6Pnnny9r6eUmrFVTHYo/qZ9++fW6+/bv1UlBdWtZ1X5aWpqOHTsmSbpy5YpSUlIUFxcnX1/fSvGcULN3fu/Umx98cd19A+rUVL8enaxq/5FHHtHKlSsVExOjFi1aWHpqvb29Va1aNZtqLm+DIm/UsVNJ+v1c0QkhVzNJGj0kUp5W9ErOnj1bPXv2VEhIiLKysvTtt99q4cKFuueee8pYtfVMeY54uh2ua86cOXrnnXcs3ygAwBZxh47pvc9ir7nP7QN6qXNYS6vb3rBhg2bOnKlffvlFAQEBioqK0t///ndbS60QGZmX9PwbH+piWkaJ+zQODtCkO4dYFWYlacuWLYqMjCyyPiIiQlu2bLG21Arz8abv9MO+QyVud3V10ZTxIxRoZZgtabLehAkTtHr1aqvaqkj/STqjl9d8es2H+UZ0DbN6aMKjjz6qzz77TElJSfLy8lJISIj+9re/6f7775erq317eAlzBpOQ/F/VqlFNPl6eji4FgEHEfPqN9h8+Xuy2Vs0aavxttzj1LPqjvybojRJ6pzw83PXIPberZnV/O1dlP1euZGn56o+Ueu6PYrcP7N1VEV3D7FyVfW36dpdid+wrdltg3Vp6aNythr7Fzpg5A8nOydE7//5KC19+V/9JOuPocgAYxPB+3eVfzNgps4+XbhvQy6mDnCQ1D2mgbh1bF7tt6M3dnDrISVfdRi/m37lJg0D17NzOAVXZ183dw1W/mMk9+bO/jT9WkjBnIHsOHNEfF9Pl4eFudXc4gKrLx9tLowb1LrL+tgG95Gcu/QB5IxvY+0bVrll4HFfr0Ebq1K6Fgyqyr4ZBdRXZ7YZC6zw93DVqcG+rby8bkatr8RNcbunVRQF1ajqoqvLj/P+CVsrJydHbb7+t/v37q06dOvL09FTDhg01YMAAvf7668rJybl+IxUgOydHsd/ndxH37tpB7u7MXQFQeqFNgtWtYxvLcqd2LdTGikcwGJ2Hu5vGDP5f75Svj7duu8X5eyWv1uemjgoOqGNZHtr3JtW04i0HRlevdg0NiOhiWW7SIFA9nKRXkjB3lQsXLqhfv34aP368vvrqK3l4eCgsLEy5ubnatGmT7rvvPl28eNEhtRX0yvn5+qiLDQOVAWBg766W1xQNublsj2AwogZBdRV5U37v1G0DbH+orFFd3TvVOrSxwts2d3RJdlfwQGlPD3eNHty72FvPRsQEiKuMGjXK8vTqt956q9AspTNnzmjVqlWKioqy+r1zL/y/j3QxLbMMleXpYnqm8vLy5OXpIQ939zK0BaAqy8nJUZ7yX3lUFeXl5SkrK1seHlX3++iVrGy5ubk6TZCxVm5urnJycyvdm078fL318ITbbDqWMPenPXv2qFOnTnJzc9O+ffvK9flu819cowtp6eXWHgAAcC7+vmbNfGisTcdWrljqQB9//LEkafDgweX+oF4/37J05dMrBwCAsytLViDM/enQofwHKnbrVv7jSGztNpWkH+MO699fbpOfr4+iJ93BxAcAAFAIyeBPFy7kv+qjIl5BYvuYufxeOUnKysrW4lfXlm9hAACgUijLmDnC3J/8/fMfGvnHH8U/IbssLqZllnnM3KXLV677fkUAAFD1EOb+1KZNG3300UfasWNHubdt231wxsoBAFBVlGXMHLNZ/7Rv3z517NhR7u7uiouLU+vWxb/6xV4YKwcAAEqDhwb/6YYbbtDo0aOVlZWlgQMHauvWrYW2nzlzRgsWLFB6esU/YiQ7J0ebd/C2BwAAcH30zF3lwoULGj58uLZs2SJJql+/voKCgpScnKykpCTl5eXp3Llzql69eoXWQa8cAAAoLXrmruLv76+vv/5aq1atUu/evZWRkaH9+/fLxcVFt9xyi1atWiU/v4p/j52Hu5v8fc30ygEAgOuiZ66SysrOlkkmublVzVfuAACA0iHMAQAAGBi3WQEAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMDDCHAAAgIER5gAAAAyMMAcAAGBghDkAAAADI8wBAAAYGGEOAADAwAhzAAAABkaYAwAAMLD/D+A8Gwc6r2WpAAAAAElFTkSuQmCC",
      "text/plain": [
       "<Figure size 789.163x451.5 with 1 Axes>"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Example: a result measured for the StubFunction gate alone\n",
    "# Note: all combinations have equal probability; \n",
    "# Note: The function result is represented as phase alone (the value of last (ancilla) qubit is always 0.\n",
    "#       Without any further action the information about phase gets lost in measurement.\n",
    "\n",
    "def StubFunctionAloneQC(password: str) -> QuantumCircuit:\n",
    "    input_qubits = validate_password(password)\n",
    "    all_qubits = input_qubits + 1\n",
    "    classical_bits = all_qubits\n",
    "\n",
    "    fn = StubFunctionGate(password)\n",
    "    qc = QuantumCircuit(all_qubits, classical_bits)\n",
    "    for i in range(input_qubits):\n",
    "        qc.h(i)\n",
    "    qc.append(fn, range(all_qubits))\n",
    "    qc.measure(range(all_qubits), range(classical_bits))\n",
    "    return qc\n",
    "\n",
    "qc = StubFunctionAloneQC(password)\n",
    "qc.draw(\"mpl\", style=\"clifford\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "id": "7acfc397-0121-4fb4-a889-ff385736a588",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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X8bOnTshhICFhQWeeuopJCcnY8+ePfjpp58wbNgwbNmyBRYWOq+GiIiIiPRM5xHA0NBQ7NixA126dMHPP/+MR48eISkpCY8ePUJUVBQ6d+6MnTt3YuHChfpsLxERERFVkM4J4Ndff42mTZviyJEj6NSpExQK9aIUCgU6d+6MI0eOoEmTJli/fr3eGktEREREFadzApiUlISBAweWeHnX0tISAwcORFJSks6NIyIiIiL90zkBbNCgATIzM0utk5WVBQ8PD11XQUREREQGoHMC+N///hfbt28vcYTvzp072LZtG/773//q3DgiIiIi0r8yP56bkJCg9XnEiBE4ceIE/P39MW3aNHTu3BkuLi5ISUnBzz//jM8//xydO3fG8OHD9d5oIiIiItJdmRNALy8vSJJUpFwIgffff7/Y8j179mDv3r3Iz8+vWCuJiIiISG/KnAAGBQUVmwASERERUdVS5gRww4YNBmwGEREREVUWzgVMREREZGaYABIRERGZmQpN0vvgwQN8+eWXOHLkCO7evYucnJwidSRJQnx8fEVWQ0RERER6pHMCeO/ePXTs2BHx8fFwcHBARkYGHB0dkZubi+zsbACAu7s7LC0t9dZYIiIiIqo4nS8Bz507F/Hx8fjmm2/w999/AwCmT5+OrKwsxMTEICAgAF5eXrh48aLeGktEREREFadzArh//3706tUL//nPf4q8HqZt27Y4cOAAbt68iXnz5lW4kURERESkPzongElJSfD395c/K5VK+dIvANSuXRv9+vXD9u3bK9ZCIiIiItIrnRNAR0dH5OXlyZ9r166N27dva9VxcHBASkqK7q0jIiIiIr3TOQH09vbGzZs35c/+/v44fPgw/vrrLwBAdnY2fvrpJ3h4eFS4kURERESkPzongIGBgYiIiMDDhw8BAJMnT0Zqaip8fX0xfPhwtGjRAvHx8Rg7dqy+2kpEREREeqBzAvjqq69izZo1cgI4dOhQLF68GFlZWdi5cyeSk5MxY8YMvPPOO3prLBERERFVnM7vAXRzc8PIkSO1ymbOnIlp06YhLS0Nzs7ORZ4OJiIiIiLjq9BMIMVRKpVwcXHR92KJiIiISE8qnAAmJSVh69atOH/+PNLT0+Ho6Ah/f3+MGjUKbm5u+mgjEREREemRzvcAAsDy5cvRsGFDvP3229i0aRN++uknbNq0CTNnzkTDhg2xYsUKnZf966+/on///qhVqxbs7e3Rvn37cr9TMCcnBx999BEaN24MGxsbuLu7Y9KkSUhNTS22fnZ2NpYsWYJWrVqhdu3aqFWrFnx9fTF//nykp6fr3BciIiIiU6LzCODWrVvxxhtvoG7dunj//ffRpUsXuLi4ICUlBVFRUfj888/l70eMGFGuZUdGRqJv376wsbHBqFGjULNmTezcuRMjR45EYmIiZs6c+cRlqFQqDB48GOHh4Wjfvj2GDRuGuLg4rF27FhERETh16hScnJzk+nl5eejRowdiYmLg5+cnP70cGRmJDz74AN999x1Onz4NOzu7cvWFiIiIyNTonAB+8sknqFu3LmJjY+Hu7i6X+/j4oGvXrhg7diz8/f2xaNGiciWA+fn5mDhxIhQKBaKiouDn5wcACA4ORkBAAObMmYMXX3wRnp6epS5n48aNCA8Px0svvYTNmzfLD6SsWrUKr732Gj744AOsXr1arr9r1y7ExMTghRdewA8//KC1rCFDhmD37t3YsWMHgoKCytwXIiIiIlOk8yXgS5cuYcSIEVrJX2H169fH8OHDcenSpXIt9+jRo4iPj8fLL78sJ3+AeuaROXPmIDc3Fxs3bnzictasWQMACA0N1XoaefLkyfD29sbmzZu1pq67fv06AKBfv35FljVgwAAAwL1798rVFyIiIiJTpHMCqLk3rzQ1atRArVq1yrXcY8eOAVC/aPpxffv2BQAcP3681GU8evQIMTEx8PHxKTJSKEkS+vTpg6ysLJw5c0Yub9GiBQDgwIEDRZa3b98+SJKEHj16lKsvRERERKZI50vAgwYNwk8//YT58+fDwqLoYvLy8vDTTz9h8ODB5VpuXFwcAKBx48ZFvnN1dUWNGjXkOiWJj4+HSqUqdhmFlx0XF4cuXboAUI/yDRkyBLt27YK/vz+6d+8OQH0P4I0bN/DVV1+hVatWpa43JycHOTk58ueMjAwA6lho5k1WKBRQKpUoKCiASqWS62rK8/PzIYSQy5VKJRQKRYnlpqCgoECvfSo8xzQAefvKz88vpdxS393SiX779C9LS0uoVCoUFBTIZZIkwcLC4rFy48ehrH0te5/+LS9pG9MuN60Y6KdP5d+fTCkO+j7ulW9/Mv77aPPy8gx03PvXk/anCj7zqReafuv/uFe2/QlQ6rtLOjHMcQ/lzgkqdA9g7969ERgYiAULFqB9+/byd9HR0ZgzZw5q1qyJhQsXlmu5mqdtHR0di/3ewcHhiU/klmUZhesB6kDv3LkTc+bMwSeffILY2Fj5uzFjxqBPnz5PbHtoaCjmzZtXpPzQoUPywyMeHh7w9/fHhQsXkJCQINfx8fFB06ZNcfr0aa1LzX5+fvD09ERUVBQePHggl3fo0AHOzs5PbFNluHDhgl77dOjQIa0DQY8ePWBra4v9+/drrbd///7Izs5GZGQkgPKdaBiKfvukZmFhgQEDBiAtLQ3R0dFyec2aNdGzZ08kJiYW2l6NHwf99wlwcnJCx44dERcXhytXrsjlxe9PphUD/fSp/PuTKcVB38e98uxPppAI79+/30DHPbWy7E9A6ffNV4YHDx4Y6LhXtv0J8DdY38rDMMc99f5U0m15xZGE9iljiby9vYuU5ebmIikpCYD6L6tu3bpIS0uTN2I3NzdYW1sjPj6+zA0KDAzE4cOHERcXh0aNGhX5vl69esjMzCw1CTx58iQ6deqE0aNHY9OmTUW+X7NmDSZNmoQlS5Zg+vTpAICHDx/ipZdeQkxMDD7//HP07t0bAHDkyBG89dZbEEIgJiYGXl5eJa63uBHABg0aIC0tTU469X0mPHFpic2pNKveMP4I4OvLjX+QXzPN+COAphCHFVOMOwJoajEw1gigKcXBmCOAkz43/gjgiinGHwGc/IXxRwC/esu4I4CvLjP+COCaaYYdAczKyoKjoyPS09PlvKMkZR4BVKlURaZ2s7S0hIeHh1bZ49ln4caVhWbUrqQELyMjA7Vr167wMgrXA4AFCxZgz5492L17NwYNGiSXjxw5EjY2NhgyZAjmz58vP1xSHGtra1hbWxcpt7S0hKWl9sFYqVRCqSy6MRZ3Ob20clOg6Ye++vR4rHQtNwZD9kmhUBQ7xF9SubEYsk8lbWMllRtLefpa3j5VpWOEoY57VeFYUFjhdhnrGGEKNDmEsY4RpsJUjntlPmLcvHlT55WUR+H781q3bq31XXJyMjIzMxEQEFDqMry9vaFQKEq8V7C4+ww1D38U96CHpuz8+fNl7AURERGR6TKN04JCunXrBkB939zjwsPDteqUxNbWFgEBAbhy5Qpu3bql9Z0QAocPH4a9vT3atGkjl+fm5gIo/lUvmrLiRveIiIiIqhq9JID5+fm4ePEioqOjcfHixSLX8cujV69e8Pb2xpYtW7RuhkxPT8eCBQtgZWWl9TLmpKQkXL58ucjl3kmTJgEAZs+erXW/xerVq3H9+nWMHj0atra2cnmnTp0AAPPmzdO6bF1QUICQkBAAxY8OEhEREVU1Fbpp5P79+3jvvfewZcsWPHr0SC63tbXFyy+/jNDQUDz11FPla5CFBdauXYu+ffuia9euWlPB3bp1C2FhYVoPYsyePRsbN27E119/LU/fBqif3N22bRu+++473LhxA926dcO1a9fwww8/4Omnn8bHH3+std45c+Zg9+7d+Oabb3D27Fn07NkTABAREYE///wTjRs3LtMUdERERESmTucRwPv376N9+/ZYt24dbG1t0adPHwQFBSEwMBC2trZYu3YtOnbsiPv375d72T169MAvv/yCTp06Ydu2bVi5ciVcXFywdevWMidhCoUCu3fvxty5c3Hv3j189tlnOHHiBCZMmIDo6GiteYAB9WPVZ8+exdSpU5GTk4PVq1fjq6++QkFBAd555x3ExMQ88eETIiIioqpA5xHA//3vf7h27RreeecdBAcHa80K8vDhQ/zvf//DokWLMH/+fHz66aflXn5AQECxs3I8bsOGDdiwYUOx31lbWyMkJES+hPsk7u7uWLZsWXmaSURERFTl6DwCuHv3bnTv3h2LFi0qMiWcnZ0dQkND0b17d+zatavCjSQiIiIi/dE5Abx79y46dOhQap0OHTrg7t27uq6CiIiIiAxA5wTQ0dGxyCtWHnfr1q0Sp2MjIiIiIuPQOQHs1q0bvv/+exw5cqTY7yMiIvD999+je/fuuq6CiIiIiAxA54dAQkJCsG/fPvTt2xf9+/dHt27d4OLigpSUFBw7dgwHDhyAnZ0dgoOD9dleIiIiIqognRPAZ555BuHh4Rg7diz27duHffv2QZIk+aXLDRs2xIYNG/DMM8/orbFEREREVHEVehF0586dERcXhxMnTuD8+fPIyMiAg4MD/P390alTJ3niZyIiIiIyHTongOPHj8ezzz6L6dOno3PnzujcubM+20VEREREBqLzQyBbtmxBamqqPttCRERERJVA5wSwYcOGSEpK0mdbiIiIiKgS6JwAjh8/Hvv27cOdO3f02R4iIiIiMjCd7wEcNmwYIiMj0bFjR7z77rto27YtXFxcin3ww8PDo0KNJCIiIiL90TkB9Pb2ll/78uabb5ZY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QkJC8Prrr2slf+VlbW0Na2vrIuWWlpawtNQ+GCuVymLfk6jZEcpabgo0/dBXnx6Pla7lxmDIPikUimKH+EsqNxZD9qmkbaykcmMpT1/L26eqdIww1HGvKhwLCivcLmMdI0yB5oFMYx0jTIWpHPdMY6sopPD9eY9LTk5GZmZmiff2aXh7e0OhUJR4r+Dj9xn++eefyMnJwfLlyyFJktZ/t27dQk5Ojvz5n3/+qUDviIiIiIzP5E4Zu3XrhtDQUBw6dAijRo3S+i48PFyuUxpbW1sEBATg1KlTuHXrltaTwEIIHD58GPb29mjTpg0A9WXeCRMmFLusbdu2ITs7G2PHjgWAYkf4iIiIiKoSk0sAe/XqBW9vb2zZsgVvvvmm/C7A9PR0LFiwAFZWVggKCpLrJyUlIT09HW5ubloPfUyaNAmnTp3C7NmzsXnzZnnoefXq1bh+/TomTZokv+bFz88Pa9euLbY9R44cQXJyconfExEREVU1JncJ2MLCAmvXroVKpULXrl0xadIkzJw5E76+vrh69SoWLFgALy8vuf7s2bPRrFkz7Nq1S2s5Y8aMQd++ffHdd9+hY8eOmDVrFl588UW8/vrrePrpp/Hxxx9Xcs+IiIiITIPJJYCA+vH3X375BZ06dcK2bduwcuVKuLi4YOvWrWWaBxhQ30y5e/duzJ07F/fu3cNnn32GEydOYMKECYiOji51HmAiIiKi6szkLgFrBAQE4MCBA0+st2HDBmzYsKHY76ytrRESEoKQkBCd23Hz5k2df0tERERkikxyBJCIiIiIDIcJIBEREZGZYQJIREREZGaYABIRERGZGSaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZoYJIBEREZGZYQJIREREZGaYABIRERGZGSaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZoYJIBEREZGZYQJIREREZGaYABIRERGZGSaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZoYJIBEREZGZYQJIREREZGaYABIRERGZGSaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZoYJIBEREZGZYQJIREREZGaYABIRERGZGSaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZoYJIBEREZGZYQJIREREZGaYABIRERGZGSaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZoYJIBEREZGZYQJIREREZGaYABIRERGZGSaARERERGaGCSARERGRmWECSERERGRmmAASERERmRkmgERERERmhgkgERERkZlhAkhERERkZpgAEhEREZkZJoBEREREZoYJIBEREZGZYQJIREREZGZMNgH89ddf0b9/f9SqVQv29vZo3749tm/fXq5l5OTk4KOPPkLjxo1hY2MDd3d3TJo0CampqSX+ZvPmzQgICIC9vT1q166N559/HufOnatod4iIiIhMhkkmgJGRkejUqRN++eUXjBgxAq+++iqSk5MxcuRIfPrpp2VahkqlwuDBgxESEoK6deti2rRp6NChA9auXYsOHTrg3r17RX4zf/58/Oc//0FqaipeffVVDB8+HFFRUejYsSNOnDih724SERERGYWFsRvwuPz8fEycOBEKhQJRUVHw8/MDAAQHByMgIABz5szBiy++CE9Pz1KXs3HjRoSHh+Oll17C5s2bIUkSAGDVqlV47bXX8MEHH2D16tVy/bi4OMydOxdNmjTB6dOn4ejoCAB4/fXX0b59e0ycOBF//PEHFAqTzJmJiIiIyszkspmjR48iPj4eL7/8spz8AYCjoyPmzJmD3NxcbNy48YnLWbNmDQAgNDRUTv4AYPLkyfD29sbmzZuRnZ0tl3/99dfIz8/H+++/Lyd/AODn54eXXnoJly5dwi+//KKHHhIREREZl8klgMeOHQMABAYGFvmub9++AIDjx4+XuoxHjx4hJiYGPj4+RUYKJUlCnz59kJWVhTNnzuh1vURERERVgcldAo6LiwMANG7cuMh3rq6uqFGjhlynJPHx8VCpVMUuo/Cy4+Li0KVLF/nPNWrUgKura6n1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",
      "text/plain": [
       "<Figure size 700x500 with 1 Axes>"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "plot_distribution(run_simulation(qc))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "id": "b3c09484-4b81-433c-9d40-c02e85d92d5a",
   "metadata": {},
   "outputs": [],
   "source": [
    "def AmplifierGate(input_qubits: int) -> Gate:\n",
    "    # Creates gate implementing amplifying probabilities of inputs marked with phase switched.\n",
    "    # The number of qubits required by the gate equals password length plus one ancilla qubit.\n",
    "    # The ancilla qubit must be set to '0' at input.\n",
    "    # The ancilla qubit is untangled and always set to '0' at output.\n",
    "    # The phase of marked inputs gets switched back in the process. \n",
    "    return AmplifierQC(input_qubits).to_gate()\n",
    "\n",
    "def AmplifierQC(input_qubits: int) -> QuantumCircuit:\n",
    "    all_qubits = input_qubits + 1\n",
    "    ancilla_qubit = all_qubits - 1\n",
    "    classical_bits = 0\n",
    "\n",
    "    qc = QuantumCircuit(all_qubits, classical_bits, name='Amplifier')\n",
    "    for i in range(input_qubits):\n",
    "        qc.h(i)\n",
    "    for i in range(input_qubits):\n",
    "        qc.x(i)\n",
    "\n",
    "    qc.mcx(list(range(input_qubits)), ancilla_qubit)\n",
    "    qc.z(ancilla_qubit)\n",
    "    qc.mcx(list(range(input_qubits)), ancilla_qubit)\n",
    "\n",
    "    for i in range(input_qubits):\n",
    "        qc.x(i)\n",
    "    for i in range(input_qubits):\n",
    "        qc.h(i)\n",
    "    return qc"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "id": "6643af0e-2b33-4ad0-b1a1-65a036183bd2",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 705.552x367.889 with 1 Axes>"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Example: internal structure of an Amplifier gate\n",
    "\n",
    "qc = AmplifierQC(input_qubits)\n",
    "qc.draw('mpl', style=\"clifford\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "id": "aa2e1cb0-39da-4d73-a57b-650d7351b23c",
   "metadata": {},
   "outputs": [],
   "source": [
    "def SearchIterationQC(password: str) -> QuantumCircuit:\n",
    "    # Creates gate implementing single iteration of the Search Algorithm.\n",
    "    # The number of qubits required by the gate equals password length plus one ancilla qubit.\n",
    "    # The ancilla qubit must be set to '0' at input.\n",
    "    # The ancilla qubit is untangled and always set to '0' at output.\n",
    "    input_qubits = validate_password(password)\n",
    "    all_qubits = input_qubits + 1\n",
    "    classical_bits = 0\n",
    "    \n",
    "    fn = StubFunctionGate(password)\n",
    "    am = AmplifierGate(input_qubits)\n",
    "    qc = QuantumCircuit(all_qubits, classical_bits, name='SearchIteration')\n",
    "    qc.append(fn, range(all_qubits))\n",
    "    qc.append(am, range(all_qubits))\n",
    "    return qc\n",
    "\n",
    "def SearchIterationGate(password: str) -> Gate:\n",
    "    return SearchIterationQC(password).to_gate()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "id": "98193ccf-8694-4167-9ca9-73cacf56fbef",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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CPQLYfS1v2PCz57Cw8NtJ+nixtTTLZvJZrPZXF2Es33++edcc801dO/ena+++spu3/fff0+fPn0ICQnhySefpKKigvT0dEJDQ/n000+b/Yvip64niFxI0mRcfr3jv6mnm7fm0DPN+125iezZsweou6wIEBgYSGZmJmFhYYwZM4b77ruPQYMGsXbt2mYfYiIiLZFbLy025EJBBhAdHV3vkqSIiDQ/LXKK8VNBJiIixtEiZ2Tn/w6jiIgYX4uckYmIiPtQkImIiKEpyERExNAUZCIiYmgKMhERMTQFmYiIGJqCTEREDE1BJiIihqYgExERQ1OQiYiIoSnIRETE0BRkIiJiaAoyERExNAWZiIgYmoJMREQMTUEmIiKGpiATERFDU5CJiIihKchERMTQFGQiImJoCjIRETE0BZmIiBiagkxERAxNQSYiIoamIBMREUNTkImIiKEpyERExNAUZCIiYmgKMhERMTQFmYiIGJqCTEREDE1BJiIihqYgExERQ1OQiYiIoSnIRETE0BRkIiJiaAoyERExNAWZiIgYmoJMREQMTUEmIiKGpiATERFDU5CJiIihKchERMTQFGQiImJoCjIRETG0FhFkVquV9PR0unbtire3N506dWLKlCmUlZUxceJETCYT8+fPd3WZIiLiAE9XF9DUdu3axbBhw7BYLPj5+REbG0thYSEZGRkcOnSI4uJiAPr27evaQp1oeeZs8o7tJK9gB5biw3QIjuC16fmuLkvEYerpls2tg8xqtTJy5EgsFgtTp05lxowZBAQEADB37lymTZuGp6cnJpOJuLg4F1frPIvXTyfAty3drryasvJTri5H5JKpp1s2tw6yyZMnU1BQQGpqKvPmzbPbl56ezrJly9i9ezeRkZEEBga6qErnW/rYIcLaRQEwaV5vyitLXVyRyKVRT7dsbnuNLDc3l5UrVxISEsLs2bPrHZOQkABAfHx87bbzwTdgwADatGmDyWRySr3OdP4FL+Iu1NMtm9sG2fLly6mpqWHs2LH4+/vXO8bHxwewD7KDBw/y9ttvYzab6d+/v1NqFRERx7ltkGVmZgKQlJTU4JiCggLAPsgGDx5MUVERq1evJjk5uWmLFBGRS+a2QXbkyBEAIiIi6t1fXV1NdnY2YB9kHh5u+5SIiLglt73Zo6ysDIDy8vJ6969cuRKr1UpAQACRkZFNWku/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",
      "text/plain": [
       "<Figure size 538.33x367.889 with 1 Axes>"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Example: internal structure of single iteration\n",
    "\n",
    "qc = SearchIterationQC(password)\n",
    "qc.draw('mpl', style=\"clifford\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "id": "85856d64-4697-45f9-9650-a8c732392ce4",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjMAAAFvCAYAAAC/9krTAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8g+/7EAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA9IElEQVR4nO3deVxU5f4H8M8MwwAzgCAugCiIgspqghq5IAYuuVYulamVuVQmmoqlt8zfNc21q1ldt/K6RqVpue+m5AaK19QESYxtLBTFYYeZ3x/EXCcGZYZZOMPn/Xr50rM953uGkfnMc55zjkitVqtBREREJFBiSxdAREREVBcMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgSSxdAuqnVQGmFpauoPakNIBKZrn21GlCVma59IkOIbU33vler1SgsLDRN4yYik8kgMuUvAqIaMMzUU6UVwKx4S1dRe4tGAnYmfDepyoBjK03XPpEhoqYANlLTtF1YWAhHR0fTNG4iSqUScrnc0mVQA8TTTERERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNEREQkaAwzREREJGgMM0RERCRoDDNERFQrEREREIv5sUH1D5/NRERkpWxsbBAZGYmuXbsiLCwMQUFBcHR0hEgkglKpxJUrV5CUlIRz587h2LFjKC8vr7Gt4cOHY+vWrYiPj8eYMWOgUqnMeCREj8YwQ0RkZZo1a4bXX38dEydORKtWrWpcz9/fH88++ywAICsrC2vWrMHatWuRk5OjtV5VkJFIJBg1ahSOHDmCr776yqTHQKSPBtFfmJubi7i4OLRt2xb29vZo2bIlYmNjUVBQgHHjxkEkEmHVqlWWLpOIqE5EIhHe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LI4fW215iG8kwwwRWYWqMw0AcOnSJb22NSTIANAak2Po+FFTstowA1S+4Lt37642X6lUIj09HWKxGEFBQVrLqu5Nc+TIEezduxddunQxV7km4RXQC7GbdQ/UqvK45UIQ98IGxL2wwdJlEBGZRVpaGhwcHPQavGxnZ2dQkAEqz1ZkZWWhoqICf/75p8F1m4pVh5maXLlyBWq1Gv7+/pDJtK+Seeutt/Dtt9/i3XffhUwmw5kzZzTL2rRpo/PSbSIiInNJSkpC27Zt9d6upKQEycnJiIyMNOhZS/X1EnaggYaZy5cvA9B9imnfvn0AgI8//hgff/yx1rKvvvoKr7zyisnrIyIiMoWpU6eioKAAO3bsqNfPWtIXw8zfpKenm7kaIiIi85kzZ46lSzC6Bnnt6qPCDBEREQlLg+yZqXpuExEREQlfg+yZISIiIuvBMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESC1iCfzSQEUhtg0UhLV1F7UhtLV0BEZF1kMhmUSqXR2luy+mvkFxTCWS7DzIkvVJs2BplMZpR29MUwU0+JRIAdfzpERA2WSCSCXC43WntSO3tIyyogtbOHXC6vNi1kPM1EREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILGMENERESCxjBDREREgsYwQ0RERILWIMJMbm4u4uLi0LZtW9jb26Nly5aIjY1FQUEBxo0bB5FIhFWrVlm6TCIiIjKAxNIFmFpycjL69+8PhUIBuVyOgIAAZGdnY+XKlUhLS8Pdu3cBAB07drRsoVQnGX9cx+bD/4fUrAu4k5+NiooyNHNphS7tn8HwXjPh5uxh6RKJiMhErDrM5ObmYtCgQVAoFJg+fTrmzp0LJycnAMDixYsxa9YsSCQSiEQihISEWLhaqos/72fi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",
      "text/plain": [
       "<Figure size 705.552x451.5 with 1 Axes>"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Example: complete circuit with one iteration\n",
    "\n",
    "def CompleteCircuitWithOneSearchIterationQC(password: str) -> QuantumCircuit:\n",
    "    input_qubits = validate_password(password)\n",
    "    all_qubits = input_qubits + 1\n",
    "    classical_bits = input_qubits\n",
    "\n",
    "    it = SearchIterationGate(password)\n",
    "    qc = QuantumCircuit(all_qubits, classical_bits)\n",
    "    for i in range(input_qubits):\n",
    "        qc.h(i)\n",
    "    qc.append(it, range(all_qubits))\n",
    "    qc.measure(range(input_qubits), range(classical_bits))\n",
    "    return qc\n",
    "\n",
    "qc = CompleteCircuitWithOneSearchIterationQC(password)\n",
    "qc.draw(\"mpl\", style=\"clifford\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "id": "70974855-92d9-4288-b1b5-cc60dc95db18",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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6OiI5s2bIyEhAevWrdNa/v3797F06VIA/+yhIyIiIpKrahfmTE1NsW7dOqhUKrzwwguYMGECpk+fDl9fX9y4cQPz58+Hl5eXZv5Zs2ahRYsW+Pnnn7WW88UXX8DU1BTjx49Hr169MGPGDLz55pto1qwZrl+/jiFDhqBXr15V3DsiIiKiylXtLoAACveYHTt2DKGhoQgLC4NSqUSbNm2waNEiDB8+XKdlvPjiizhx4gSWLFmCY8eO4ffff4eFhQVatGiBuXPn4u233zZwL4iIiIgMr9rdmqS64rNZiYxj/HJjVwCsnWLsCoioNpLts1mJiIiISHcMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQyxjBHREREJGMMc0REREQypneYa9myJb744gvcvXu3MushIiIionLQO8wlJCTggw8+QKNGjTBixAgcOnSoMusiIiIiIh3oHeZSUlKwatUqtG7dGmFhYejduzeaNGmChQsXIiUlpcKFnTlzBn379kW9evVgZWWFzp07Izw8vNzLuXPnDqZOnYqmTZvCwsICjo6O6NKlC77++usK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",
      "text/plain": [
       "<Figure size 700x500 with 1 Axes>"
      ]
     },
     "execution_count": 17,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "plot_distribution(run_simulation(qc))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "id": "b449f288-9660-42b8-9d16-117dc6e4ca61",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 956.385x451.5 with 1 Axes>"
      ]
     },
     "execution_count": 18,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from math import sqrt\n",
    "\n",
    "# Example: complete circuit with two iterations\n",
    "\n",
    "def CompleteCircuitWithOptimalSearchIterationsQC(password: str) -> QuantumCircuit:\n",
    "    input_qubits = validate_password(password)\n",
    "    all_qubits = input_qubits + 1\n",
    "    classical_bits = input_qubits\n",
    "\n",
    "    it = SearchIterationGate(password)\n",
    "    qc = QuantumCircuit(all_qubits, classical_bits)\n",
    "    for i in range(input_qubits):\n",
    "        qc.h(i)\n",
    "\n",
    "    for j in range(optimal_iterations(input_qubits)):\n",
    "        qc.append(it, range(all_qubits))\n",
    "\n",
    "    qc.measure(range(input_qubits), range(classical_bits))\n",
    "    return qc\n",
    "\n",
    "qc = CompleteCircuitWithOptimalSearchIterationsQC(password)\n",
    "qc.draw(\"mpl\", style=\"clifford\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "id": "47fc1c93-6656-4d9c-a7e5-a98d80125b30",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "outputs": [
    {
     "data": {
      "image/png": "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IoVhACQiIiJSGCtLN4CIyNRGLbXs9tdNsOz2iYiehzOARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMAyARERERArDAEhERESkMKU2AJ49exbdu3dHpUqVULFiRbRu3RphYWGFfn2NGjUgSVKB/44fP27wmoLqDh8+3MQ9JCIiIrIMK0s3IC+HDx9GSEgI7OzsMHDgQDg6OmL79u0YMGAA4uLiMHny5OeuY8KECXj8+HGu8qSkJKxcuRIuLi5o2bJlruW+vr55hr0mTZoY0RMiIiKi0qfUBUCtVotRo0ZBpVLh2LFjcvCaMWMGAgICMHXqVLz++uvw9fUtcD0TJkzIs3zx4sUAgCFDhsDOzi7X8ho1amDWrFnF6QIRERFRqVbqDgEfOnQI0dHReOONNwxm3ZydnTF16lRkZmZi06ZNRq//66+/BgC89dZbxW0qERERUZlU6mYAjxw5AgAIDg7OtSwkJAQAcPToUaPWffLkSVy9ehUtWrRA48aN86zz+PFjrF27FklJSXB1dUW7du3QsGFDo7ZHREREVBqVugAYFRUFAKhTp06uZR4eHnBwcJDrFJV+9u/tt9/Ot87FixcxZswYg7Ju3bph06ZNcHNz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wgQEBASYrH9EREREllTqbgNTnvBZwESWwWcBE5ESlelnARMRERGReTEAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAEhERESkMAyARERGRwjAAljMrV65EjRo1YGdnh1atWuHMmTMF1v/hhx/g7+8POzs7NGzYELt37zZY/tNPPyE4OBiVK1eGJEmIjIw0Y+tNh+OQjeNAZIjvCaJsDIDlSGhoKCZNmoSZM2fi/PnzaNy4MUJCQnD//v086588eRKDBg3CW2+9hQsXLuDVV1/Fq6++isuXL8t10tPTERgYiAULFpRUN4qN45CN40BkiO8JohwEmU1ycrIAIJKTk0tkewEBAWLs2LHyz1lZWaJatWpi3rx5edbv37+/6NGjh0FZq1atxJgxY3LV/fvvvwUAceHCBZO22Rw4DtmUPA5vf2HZf6XBihUrhK+vr7C1tRUBAQHi9OnTBdYPCwsT9erVE7a2tqJBgwZi165dBst1Op345JNPhIeHh7CzsxOdO3cWN27cMKjj6+srABj8y29/swSlvicssS8IIcTOnTtFQECAsLOzE5UqVRK9e/c2ZbeKTAnviaLkDs4AlhOZmZk4d+4cunTpIpepVCp06dIFEREReb4mIiLCoD4AhISE5Fu/LOA4ZOM4KJs5Zro+//xzfPnll1i9ejVOnz6NihUrIiQkBE+fPjVY16effor4+Hj53/jx483a18JS6nvCUvvC9u3b8eabb2LEiBG4ePEiTpw4gTfeeMPs/c0P3xO5MQCWE0lJScjKyoK7u7tBubu7OxISEvJ8TUJCQpHqlwUch2wcB2VbsmQJRo0ahREjRqB+/fpYvXo17O3t8c033+RZf9myZejWrRs+/PBDvPDCC5gzZw6aNWuGFStWAACEEFi6dCmmT5+O3r17o1GjRvj2229x9+5d/PLLLwbrcnR0hIeHh/yvYsWK5u5uoSj1PWGJfUGr1eI///kPFi5ciHfeeQd169ZF/fr10b9//5Lqdi58T+TGAEhEVI6YY6br77//RkJCgkEdZ2dntGrVKtc658+fj8qVK6Np06ZYuHAhtFqtqbpGRWSpfeH8+fO4c+cOVCoVmjZtCk9PT7z88ssGs2clie+JvFlZugFkGlWqVIFarca9e/cMyu/duwcPD488X+Ph4VGk+mUBxyEbx0G5CprpunbtWp6ved5Ml/6/z5sNe//999GsWTO4urri5MmTmDJlCuLj47FkyZJi96u4lPiesNS+cPPmTQDArFmzsGTJEtSoUQOLFy9Gx44dcePGDbi6uha/c0XA90TeOANYTtjY2KB58+Y4ePCgXKbT6XDw4EG0adMmz9e0adPGoD4A7N+/P9/6ZQHHIRvHgSxh0qRJ6NixIxo1aoR33nkHixcvxvLly5GRkWHppvE9UYJ0Oh0AYNq0aejbty+aN2+ODRs2QJIk/PDDDxZuXckqze8JzgCWI5MmTcKwYcPQokULBAQEYOnSpUhPT8eIESMAAEOHDoWXlxfmzZsHAPjPf/6DDh06YPHixejRowe2bduG33//HWvXrpXX+fDhQ8TGxuLu3bsAgOvXrwOAfC5DacRxyMZxUCZzzHTp/3vv3j14enoa1GnSpEm+bWnVqhW0Wi1iYmJQr149Y7pjUkp7T1hqX9CX169fX15ua2sLPz8/xMbGFq9TRuB7Im+cASxHBgwYgEWLFmHGjBlo0qQJIiMjsXfvXnmKOjY2FvHx8XL9tm3b4rvvvsPatWvRuHFj/Pjjj/jll1/QoEEDuc6vv/6Kpk2bokePHgCAgQMHomnTpli9enXJdq4IOA7ZOA7KZI6Zrpo1a8LDw8OgTkpKCk6fPl3gbFhkZCRUKhXc3NyK0yWTUdp7wlL7QvPmzWFrayuHYQDQaDSIiYmBr6+vyfpXWHxP5E0SQghLN6K8SklJgbOzM5KTk+Hk5GTp5hApxqillt3+ugmW3X5oaCiGDRuGNWvWyDNdYWFhuHbtGtzd3XPNdJ08eRIdOnTA/Pnz5ZmuuXPn4vz583LYWbBgAebPn49NmzahZs2a+OSTT3Dp0iX8+eefsLOzQ0REBE6fPo2goCA4OjoiIiICEydOxMsvv4xNmzZZcjgUzRL7AgBMmDABP/74I7755hv4+vpi4cKF2LFjB65duwYXFxdFjIMl3hNFyR2l9hDw2bNnMXPmTJw8eRIajQYNGzbEpEmTinQZeUZGBhYsWIDNmzcjLi4Orq6u6NmzJ/7v//4v3/S9detWLFu2DFeuXIGNjQ3atWuHTz/9FM2aNTNV14iIzGrAgAFITEzEjBkzkJCQgCZNmuSa6VKp/j0ApJ/pmj59OqZOnYo6derkmun673//i/T0dIwePRqPHz9GYGAg9u7dK//Bt7W1xbZt2zBr1ixkZGSgZs2amDhxIiZNmlSynScDltgXAGDhwoWwsrLCm2++iSdPnqBVq1Y4dOiQRcIfwPdEXkrlDODhw4cREhICOzs7DBw4EI6Ojti+fTtu3bqFRYsWYfLkyc9dh06nQ/fu3REeHo7WrVujQ4cOiIqKws8//4yaNWvi1KlTqFq1qsFrPvvsM0yfPh2+vr7o27cvUlNTsW3bNmRmZuLgwYNo165dkfrBGUAiy1D6DCARKVNRckepC4BarRb+/v64ffs2Tp06JZ9MmZycjICAAMTExODGjRvPPY9gw4YNGDlyJAYNGoStW7dCkiQAwOrVq/Huu+9i9OjRWLNmjVw/KioK9evXh5+fH86cOQNnZ2cA2cfrW7duDT8/P1y+fNngG8LzlEQAtPQfOqB0/LHjOGTjOGSz9DiUhjGgbJbeFwDuD1RyipI7St1FIIcOHUJ0dDTeeOMNgytpnJ2dMXXqVGRmZhbq2Pm6desAAPPmzZPDHwCMGTMGfn5+2Lp1K548eSKXb9iwAVqtFtOmTZPDHwA0adIEgwYNwtWrV/Hbb7+ZoIdEREREllXqzgE8cuQIACA4ODjXspCQEADA0aNHC1zH06dPcfr0adSrVy/XTKEkSejatSvWrFmD33//HS+99FKhtrtx40YcPXoU7du3L2qXiIhKHGe+KCfuD9ksPQ6lYQz0Sl0AjIqKAgDUqVMn1zIPDw84ODjIdfITHR0NnU6X5zpyrjsqKkoOgFFRUXBwcMjznkA56xckIyPD4OaOycnJALLvE6XRaABkP35GrVYjKytLvllmznKtVoucR+XVajVUKlW+5ZmGz5y2iEePskzaJ/1Y6VlZZe+mzz4+J2d55lNrk/erqFJSYNI+5WRtbQ2dToesrCy5TJIkWFlZGZSXhnF48KBwfS1sn3KW57ePPVtu6XHIOQam6lNR30+WHgPg33Ew9edeUd5PmU8lWNqDBxqzfO7l9Lz3U+ZTyx/wS07O7repP/dylj/v/WTp90VKCsz2uadSqZCeng4AKMzZfaUuAOpDU87DsDk5OTnJdYqzjpz19P+f35XBedXPy7x58zB79uxc5TVr1izwdWXdt1Ms3YLSgeOQjePAMdDjOGTjOGTjOJTcGKSmpuabgfRKXQAsy6ZMmWJwebdOp8PDhw9RuXJlg/MQS5OUlBR4e3sjLi5O0Vcqcxw4Bnoch2wch2wcB46BXlkYByEEUlNTUa1atefWLXUBUJ9Y85ttS0lJee59hAqzjpz19P9flPp5sbW1ha2trUFZpUqVCnxNaeHk5FRqd+iSxHHgGOhxHLJxHLJxHDgGeqV9HJ6XVfQsf1LAMwo63y4hIQFpaWn5ntun5+fnB5VKle85e3mdZ1inTh2kpaUhISGhUPWJiIiIyqpSFwA7dOgAANi3b1+uZeHh4QZ18lOhQgUEBATg+vXruHXrlsEyIQT279+PihUrokWLFibdLhEREVFZUOoCYOfOneHn54fvvvsOkZGRcnlycjLmzp0LGxsbDB06VC6Pj4/HtWvXch2+HT16NIDs8/JyXg2zZs0a3Lx5E4MHD0aFChXk8hEjRsDKygqfffaZwboiIyPx/fff44UXXkBgYKCpu2txtra2mDlzZq5D10rDceAY6HEcsnEcsnEcOAZ65W0cSt2TQICiPQpu+PDh2LRpEzZs2IDhw4fL5Xk9Cu6vv/7CTz/9hBo1auD06dNmfxQcERERUWlU6mYAASAoKAi//fYb2rVrh9DQUHz11Vdwd3fHtm3bCvUcYCD7fjj/+9//MGvWLCQmJuKLL77AiRMn8NZbbyEiIiJX+AOAadOmYcuWLahatSq++uorhIWF4aWXXsLJkycZ/oiIiKjcKJUzgERERERkPqVyBpCIiIiIzIcBkIiIiEhhGACJiIiIFIYBkIiIiEhhGAAVLL/rf3hdEBERUfnGAKhgkiThzp07AIDMzEz8888/cjkpC78MEFFB+FlQ/vA2MAokhMDOnTvx9ddf448//kBaWhoaNWqEhg0bonnz5mjSpAlq164NW1tbCCEYCBUiKioKbm5uSE1NRYUKFVC5cmVLN4lKIX4mkB73hbKNAVCBZsyYgUWLFsHe3h7e3t7QaDTIzMxEXFwchBBo3LgxXn/9dQwdOhTu7u6Wbq7ZZWVlQaVSKfKDLCMjAz/88ANWrVqFCxcuQKVSoU6dOqhduzaaN2+Otm3bolmzZnB0dLR0U81OCIGsrCyo1WpF7gvPun//PhITE1G5cmWkpqaiatWqqFSpkqWbRSUsKysLUVFRePToEYDs90mtWrUU8behvGMAVJiYmBi8+OKL6NixIxYvXgx/f38kJSUhLi4O0dHROHbsGMLDwxEVFYXGjRtj7ty5ePnll6HT6aBSla8zBuLi4uDt7S3/rNPpIISAWq22YKtK1uTJk7Fs2TL4+vqiTp06sLa2xuPHj/HHH38gJSUF3t7e6NmzJ0aOHInmzZtburlmEx0djVq1ask/63Q66HQ6WFlZWbBVlhEfH49p06Zh//79uHPnDhwdHVGzZk288MILaNWqFQIDA9GwYcNy8zzUvOhntpS8HwDA9evXMWXKFOzevRuZmZmwtbWFi4sLatSogTZt2qBbt25o27YtKlasaOmmkhEYABVmzpw5WLp0KcLCwtC5c2dotVqDD7eUlBRcuXIFYWFhWLZsGdzd3bFnzx40adLEco02g5iYGPj5+SE4OBiDBg1Cz549DQ55ZmVlQZIkqFQq+Y9BZmYmbGxsLNhq0/r7779Rv3599OrVCytXrkTVqlWRmpqKx48fIz4+HseOHcPPP/+Ms2fPwsvLC7Nnz8bQoUPL3WGf6Oho1KlTB/7+/hg5ciSGDBkCDw8PeXlWVhYAQK1Wy31PT09HWloaKleuXK7CQUJCAvr06YPTp0+jW7ducHBwgEqlwq1bt3Dp0iU8efIE9evXR//+/TFq1Ch4enpauslmkZKSgsePH8PHx0cuy7kfKMHdu3fRrVs3XLlyBW+++SaqVKkCKysrXLlyBcePH0dKSgoqVaqEPn36YMyYMQgICLB0k83i0aNHuHTpElq3bl3+vvQIUpShQ4cKT09PkZCQIIQQQqfTGfw3p23btglnZ2fRunXrEm1jSZg7d66QJEn+V6VKFTFs2DCxa9cuodFoDOpmZGQIIYRYvXq16Ny5s7h+/bolmmxyn332mXB1dRUHDx4UQgih1WoNlms0GnHz5k2xdOlSUbVqVSFJkti7d68lmmpWCxYsMNgXJEkSHTt2FFu2bBGZmZkGdXPuCwEBAeL8+fOWaLLZzJgxQzg7O4ulS5fKZY8ePRJxcXHi2LFjYvr06aJ+/fpCpVKJNm3aiN9++00IkffnR1k2adIkIUmSeOmll8Q333wj0tPTDZZrNBqRlZVlUBYfHy/u3btXbsZi+vTpwsXFRaxfv14uy8jIEJmZmSI2NlasWbNGtGvXTqhUKlG/fn2xc+dOIUT52xc++OADIUmSaNasmZgzZ464fPlyvnX1fb9x44aIjIzM9flR2jAAKsyiRYuEJEnihx9+kMue/SDL+QYeMWKEqFKlirh27VqJtbEk9OzZUzg6Oor169eLYcOGCXt7e/mPf+3atcUHH3wgzpw5Y/Ca1157TUiSJNLS0izUatN67733RKVKlURcXJwQouAP7n379glPT09Rr1498fTp05JqYono27evqFChgvjuu+/EjBkzRP369eV9wdraWgwcOFAOyXrlbV/Qq1+/vujZs6e4f/++ECL3PvH06VNx8eJFOSD5+/uLe/fuWaKpZtWwYcNcXwr69Okjdu3aZVBPPz4pKSli8ODBIiQkJNcXyLKqcePGolu3bvLvN6/Ph8TERLF8+XLh6uoqHB0dxZ9//lnSzTS7Jk2aCJVKJVxdXeV9ISgoSKxZs0bcvn07V/20tDQxaNAg0bp1awZAKl2OHTsmHBwchL+/vzh79qzBMp1OJ4dB/X/nzp0rKlasmCsMlWX3798XAQEBwsvLSy578uSJ2Lp1q+jcubPBh37Lli3Fl19+KcLCwoSnp6fo1auXBVtuWl9//bWQJEmsXLlS/nDXarX5BsEpU6YIBweHcjXrlZiYKNq2bSs8PDzksoyMDLFnzx7x1ltvCU9PT3lfqFq1qvj444/Fli1byt2+IIQQCQkJ4oUXXhBdu3Z9bl2NRiO+/PJLIUmS+Oijj0qgdSUnOjpaVK1aVXTo0EEcO3ZMvPvuu8LHx0feD1xcXMR7771n8D64cOGCcHFxER06dLBcw00oKSlJtGjRolBHfzQajdi2bZuQJEmMGTOmBFpXcv7++29RrVo10bp1axEZGSnmzJkj2rdvL+zs7IQkScLR0VH0799f/Pzzz+LBgwdCCCHOnDkjXF1dRVBQkIVb/3wMgAqi/8O+bt06oVarhSRJYvTo0eLAgQMiJSUlV/1//vlHDBo0SFSuXLmkm2pWsbGx4qWXXhI9evQQQvx7WE/v7t27YtGiRQazAPo3/LMzAGXZH3/8Iby8vISrq6vYsWOHwTKdTicfEtZ/GViyZImws7MTJ0+eLPG2mktCQoLo1q2b6Nq1q9BoNLm+sScmJopvv/1WvPLKK6JixYoGXw7K076g//L3+uuvCycnJ3H69Gm5/NlTA3Jq2LCh6NSpk0hNTS2ppprdvn37hCRJYvLkyXLZ48ePRWhoqOjXr59wdnaW94FatWqJ+fPni48++khIkiQfBi3L9H8nRo0aJSRJEjt27JC/GBY0u9muXTvRsmVLOQiVB4cOHRIqlUq8//77cllqaqoIDw8XEydOFI0aNZL3BS8vLzFhwgQxZsyYMrMvMAAqUFpamvjqq6+Em5ubkCRJuLm5id69e4u5c+eKAwcOiIcPH4rTp0+LMWPGCBsbG4MPwvIgMzNTHDp0SJw8eVION/o/dM8eDr9+/boYO3askCRJuLq6WqK5ZqH/kN+zZ4+oXr26kCRJhISEiLCwMPHw4cNc9dPS0kT//v3L3ZcBIYSIiooSly9fzrUvPDsTGhsbKz799FNhb28vXFxcLNFUs1u7dq187tuz5zplZWUZjEtycrLo3r27aNCggSWaajYnT54U3t7eYu3atUIIkSv03Lp1Syxfvlx07NjR4AtBedsndu/eLSRJEnXr1hXh4eEGy7RarcG+8PjxY/Hqq6+KunXrWqKpZhMZGSnq1KkjvvzySyFE7vOk4+Pjxffffy+GDRsmatasWeb2BQZABXn2D1paWppYunSpaNOmjbCyspJ3XpVKJWxsbIQkSWLEiBF5nudQHjwb9vT033T1b/YzZ84Ie3t7MXr06JJsXonQaDTixx9/NPgm27hxYzF27Fixfft2cfXqVfHTTz+JAQMGCLVaLT7++GNLN7lE6cOgfl+IiIgot/uC3vz584VKpRKSJIlhw4aJ8PBw8eTJE3m5/nPkwIEDwsvLS4waNcpSTTWLzMxMceXKFflCOSHynwm9ceOGGDJkiJAkSYwdO7Ykm1kitm7dKtzd3eXz3kJDQw3Oe9XvC7t27RLVqlUrd/uCENnndz77pTivvx137twR48aNE5Ikiffee6+kmlcsvA0MISkpCTdu3MCpU6dw/PhxZGVloW7dunjhhRfw1ltvWbp5Jqe/2a8QAjqd7rm3dRg/fjxWrlyJs2fPlut74f3yyy9Yv349wsPD5VteSJIEIQSsra0xduxYfPTRR4q+Aey4ceOwatWqcrkviP9/i5vHjx/jm2++wYIFC5CYmAi1Wo3mzZujXbt2CAoKgrOzM86ePYsVK1YgNTUVhw4dQsOGDS3d/BLz7OfGp59+ilmzZpXLfSIjIwPbt2/HkiVLcP78eQCAm5sbOnTogK5du8LW1haXL1/G119/DVtbW+zbtw8vvviihVtdcp7dF2bOnIk5c+aUmX2BAVAh7t+/jz/++AM3btxAWloaAgIC4O/vjypVquQKQBkZGQb3OxLl7L5vRZGSkoIxY8bg8OHDSEhIsHRzTC6vEJyQkIDDhw/jxIkTsLa2RrVq1eDv749evXpZsKWWl56ejrFjx2L37t24f/++pZtjcs++z58+fYpNmzbh22+/RURERK769evXx5QpUzB48OCSbKbZ6W96r/+imBf9WN24cQO9evWCVqtFdHR0Cbe05AghsGPHDqxduxb79u2DVqs1WN6mTRtMnz4dL7/8soVaaHk3b97Eq6++itTUVPz999+Wbk6hMAAqwJ49e/B///d/uT7EXV1d0blzZwwYMAC9evWCtbW1vKw8PvkDyD8I57yh77Mf/BkZGbh//77BU0PKsqL8bp8di/L0ZcDYfTwlJQVOTk5maFHpFRsbiwMHDuDy5cvw8PCAm5sbAgMDUbt2bUs3zaKuX7+OV199Fb169cLnn39u6eaYnMg+TczgfZKcnIwjR47g5s2bqFatGhwcHNCyZUu4ublZsKWW9/fff2PMmDHo0KEDpk2bZunmFAoDYDkXFxeHjh07Ij09HcOHD0dQUBBu3ryJCxcu4OLFi7h06RIyMjJQv359TJ06Fa+//jpsbGzK1R96vYKCcJcuXeQgXJ6e7PA8+YWgnM9HfvZpMeVRYcKgVquFJEnl8kkQe/fuxeXLlxEZGQl3d3e0aNECtWvXhre3NypXrmzw5bA8yzkObm5uaNmyJWrXrg1fX19UrlzZ4GkwOZWn90h+M585n46kBAXNAJvjdRZRgucbkgVMmzZNuLi4iO3bt+daFhcXJ0JDQ8XgwYPlCwAWLFhggVaaX2xsrPDz8xPu7u7io48+Env37hWrVq0So0aNEgEBAfJtXho0aCC2bt0q3xomvwtFyqKEhAQxadIksXfvXvHo0SODZTqdrtzdwT8/HId/PXr0SPz3v/8VkiQZXAgmSZKoXLmyeOWVV8SGDRty3dqjvI1RYcfh2f2loFvklDV5PRAgr8+/nOXPuzVMWVTYcXjWs7cTKwsYAMu5Vq1aiY4dO4rExEQhhDC4ujWnQ4cOiaZNmwpbW1vx9ddfl3QzzY5BOPsxX5IkiZo1a4oePXqIhQsXijNnzuR6sof+dh9CCHH48GGxZ88eSzTXbDgO//r888+Fvb296NOnjzh8+LC4fv262LZtm5g9e7bo2bOn/AjAZs2aiZ9//tnSzTUbjoMQq1atEv379xc7d+7MdV/HrKyscvVluCBKGgcGwHIsNTVVdOnSRfj7+8vPssy58z77zeb8+fPCxcVFvPLKK/Ly8oJBOPuRRjY2NqJ169bybX5q1KghBg8eLNavXy+uXr1qUD89PV288sorQqVSGdwGpKzjOPzL19dX9OjRQyQlJeVadufOHbFz504xevRoeVZs3bp1Fmil+XEchKhRo4Z80/tWrVqJTz75REREROT6O6Cf8UtPTxdffPGFOHTokCWaazZKGgcGwHJOf4f6vMJMzh1aHwR79+4t6tatK2JiYkqsjebGIJx9CLxGjRqiefPmIjMzU0RERIhPPvlENG7cWEiSJNRqtWjUqJEYN26cCAsLE8nJyeLMmTPCw8OjXD3yjOPwr6tXrwoHBwcxdepUuSyvGY6MjAyxa9cu4efnJ1xdXcvVk2CE4DgIIcTly5eFJEmiRYsWomvXrvKREAcHBxESEiKWLVuW64vR8ePHhSRJol27dhZqtekpbRwYAMu527dvy480Gz9+vDh37lyuWQz9N5nk5GTRr18/4ePjY4mmmpXSg/Dp06eFq6urGDZsmBBCyE89uXfvntizZ4945513hK+vr5AkSdjb24v27dvLz0V+9jFxZRnH4V9//vmnqF69uhgwYIAQIvtz4NkvRjnfG7/88ku5PD2C4yDE999/LyRJEkuWLBFCZD8BacGCBaJJkyZyCPL09BSDBg0S3377rXj48KFYvHhxmXnkWWEpbRwYABXg559/lh9T06JFCzFnzhxx+PBhERMTYxAGt2zZIqpWrVruHugtBINwVFSUeO2118TWrVvzXJ6ZmSliYmLE5s2bRf/+/YWrq2uZeqRRYXEcDLVq1Uo4OjqK3bt351qmDz36MPTgwQNRs2ZN8frrr5doG0uC0sdhzZo1QpKkPPt/5swZMXHiROHt7S2HoLp16woPDw/h7Oxc8o01I6WNAwNgOfXsYcsHDx6IDz74QPj4+MjP/+3UqZMYMmSIGD16tHjzzTeFra2t8Pf3F9euXbNQq81L6UH48ePHeZ7jlJP+j9zq1avL1CONioLj8O/nw+nTp4WXl5eQJElMmDBBnD59OtcXI/3FMSdPnhTVqlUT77//fom311w4DtljEBERISZOnCj++usvg/Kcnjx5Inbu3CmGDRsmnJ2dhSRJYty4cSXdXLNR4jgwAJZj+h03Li5O/oP2xx9/iHnz5omQkBA5DEqSJFxdXUWnTp1yPQC+rGMQzvscRv2hz/x8+OGHQpIkce7cOXM2rURxHHLTarVi48aNwtPTU0iSJF588UUxceJE8cMPP4grV67IY3P79m0xaNAgYWVlVS7HguOQfa50frcyefa9M3bsWCFJkrhw4UIJtKxkKWkceCPockir1eLEiRP45ptvcOPGDUiSBHt7e7Rs2RL9+/dH06ZNIYRAXFwcnjx5gps3b8Lf3x/e3t6wsrIqdzeB1vfn9u3bqFatGlQqFS5fvoydO3fiyJEjuHr1KuLi4gAALi4uaNKkCb788sty9UxL/RgkJCTAzc3N4GauOW/6DAC3b99Gjx49cPfuXSQmJlqqyWbBcchbYmIiVqxYgbCwMNy4cQP29vbw8vKCg4MDXF1dce3aNSQmJmLEiBFYtWqVpZtrNhyH/OnfO9HR0RgwYACSk5MRFRVl6WaVuPI0DgyA5dCiRYswZ84cpKamonbt2lCr1bh+/bq8vH79+njvvffw+uuvl+vH9zAI5x4DlUqFChUqoHHjxujbty/atm2b6zVJSUnYvHkzqlWrhgEDBlig1abHccibyPEs6CdPniAqKgpnz57FiRMncPr0aVy7dg1Vq1aFt7c33n77bQwZMgQVK1a0dLNNjuNQeDt37sQrr7yCDz/8EAsWLLB0cyymXIyDBWYdyYxu3rwpKlasKF566SVx8+ZNcfv2baHRaERcXJxYtWqVCAoKkg/7durUSZw9e9bSTTabhQsXCicnJyFJkqhTp47w9/c3uMP/iy++KFauXCnu3btn6aaazfPG4IUXXhBLliwR8fHxBq/LyMgoVzc85TgUXlZWlkhPTxcajUYkJSWVu9NCCktp41DY210lJCSIjRs35no6THmhpHFgACxnPvnkE+Hm5iYOHDgglz27Q1+6dEkMHTpU2NnZiXr16onff/+9pJtpdgzCRRuDzp07l7tzmvQ4Dv/6559/xLVr18Q///yTa1lWVpbBZ8WznxvlKQhzHAoeg+cpT4/AU/I4MACWM6+99prw8/MTt27dEkL8e2sTnU6Xa2ddunSpkCRJDB8+vMTbaW4MwsUbg/Jw82s9jsO/5s2bJ1q0aCHmzp0rDh06JO7cuZPrc+HZ+97dv3+/3D3vleNQuDF4VnkbAyGUPQ4MgOXMnDlzhCRJ4sqVK/nWyfmh1rdvX+Hj4yOio6NLonklhkGYY6DHcfiX/lYnVlZWonLlyqJXr15i+fLl4syZM3neGictLU188MEHYsSIEeVm5ksIjoMQxRuDsj7zlZOSx4EBsJz57bffhCRJokmTJuLgwYN5Xs6e8w/f1KlThb29vbh48WJJN9WsGIQ5Bnoch2zXr18XDg4Oom3btmLFihWid+/ews3NTUiSJHx9fcWwYcPE5s2bxeXLl8WjR4+EEEKcOnVKODs7i969e1u07abEceAY6Cl9HBgAyxmtVismT54sn9i+YsUKkZCQkGfdhw8fiqFDh4qqVauWcCvNj0GYY6DHcci2Y8cOYWVlJWbNmiWEECImJkaEh4eLWbNmifbt2wsHBwdhZWUlGjVqJCZMmCD27t0r3wexLD7mKj8cB46BntLHgQGwnFq9erWoVauWkCRJeHl5iXHjxoldu3aJS5cuiStXrog7d+6Ijz/+WNjZ2YlJkyZZurkmxyDMMdDjOGT74YcfhCRJIjQ01KA8MzNTREVFiR9//FH85z//EY0bNxY2NjaiYsWKwt7evtw9Bo/jwDHQU/o4MACWUzqdTty4cUN8+OGHBs8udHd3F9WrVxdqtVpIkiTeeOMNERcXZ+nmmo3Sg7AQHAM9pY+DTqcTf/75p7h586b887PS0tLE+fPnxffffy+Cg4PlZ2eXJxwHjoGe0seBAVAB0tLSxKFDh8SECRNE//79RceOHcUrr7witmzZkut5l+UNgzDHQI/jkL+8/vCNHz9eSJIkzp8/b4EWWQbHgWOgp4Rx4JNAFEaj0cDa2trSzbCI9PR0nDlzBr/++ivu3r2L+/fvw8nJCf3790ffvn1hZ2dn6SaaHccgG8chbzqdDiqVCjExMejduzcePXqE2NhYSzerxHEcOAZ65XkcrCzdACpZSg1/AFCxYkUEBQUhKChIsUGYY5CN45A3/bOR79y5A41Gg/fee8/CLbIMjgPHQK88jwNnAImIyIAQArdv34arq6tin3kLcBwAjoFeeRwHBkAiIiIihVFZugFEREREVLIYAImIiIgUhgGQiIiISGEYAImIiIgUhgGQiIiISGEYAImIiIgUhgGQiIiISGEYAImIiIgUhgGQiIiISGH+H/TKtCOuPyD8AAAAAElFTkSuQmCC",
      "text/plain": [
       "<Figure size 700x500 with 1 Axes>"
      ]
     },
     "execution_count": 19,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "plot_distribution(run_simulation(qc))"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "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.12.2"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}