QuantumSimQubitReset.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# QuantumSim - Qubit Reset\n",
    "Author: Nico Kuijpers<br>\n",
    "Date: January 2, 2025\n",
    "\n",
    "In this notebook it is explained how a reset of a single qubit is implemented in QuantumSim.\n",
    "\n",
    "Resetting a qubit requires the measurement of that qubit. Measurement of a single qubit in QuantumSim is introduced in this notebook:\n",
    "\n",
    "https://github.com/nicokuijpers/QuantumSim/blob/main/QuantumSimQubitMeasurement.ipynb"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "from quantumsim import *"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Introduction\n",
    "For some applications it is required to reset the state of a single qubit $q$ to $|0\\rangle$ and change the quantum state of the circuit accordingly.\n",
    "This is achieved by first obtaining the probabilities of measurement outcome $|0\\rangle$ or $|1\\rangle$ for qubit $q$ and then letting collapse its \n",
    "state to either $|0\\rangle$ or $|1\\rangle$ depending on a random number between $0$ and $1$. \n",
    "In case the qubit collapses to $|0\\rangle$, the reset operation is complete. In case the qubit collapses to $|1\\rangle$ a \n",
    "Pauli X operation is applied to that qubit to bring it into state $|0\\rangle$.\n",
    "\n",
    "To implement this approach in QuantumSim, class *StateVector* has been extended with a method *reset_qubit()* as defined below."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "\"\"\"\n",
    "Class representing the quantum state of a quantum circuit of N qubits.\n",
    "\"\"\"\n",
    "class StateVector:\n",
    "\n",
    "    def reset_qubit(self, q):\n",
    "        measured_value = self.measure_qubit(q)\n",
    "        if measured_value == 1:\n",
    "            combined_operation_pauli_x = CircuitUnitaryOperation.get_combined_operation_for_pauli_x(q, self.N)\n",
    "            self.apply_unitary_operation(combined_operation_pauli_x)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Example: Bell state\n",
    "Below, a circuit of $2$ qubits is defined to create the $|\\phi^{+}\\rangle$ Bell state defined by\n",
    "\n",
    "$|\\phi^{+}\\rangle = \\frac{1}{\\sqrt{2}} (|00\\rangle + |11\\rangle)$.\n",
    "\n",
    "After establishing the Bell state, qubit $0$ is reset. Upon resetting qubit $0$, also the state of qubit 1 is determined.\n",
    "\n",
    "Intermediate probabilities are shown using function *QuantumUtil.show_all_probabilities()*. \n",
    "It can be observed that measuring the state of qubit $0$ also determines the state of qubit $1$."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Measured state |01>\n"
     ]
    },
    {
     "data": {
      "image/png": "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T4WEhKhChQqSVKTP63a57kpLVlaWnnjiCf373//W6tWr9fLLL2vSpElW28TGxuq+++7T999/r4cffviG7U2dOlUvvvhiCfYYAHC7Ku3ZIMuazZW1kJAQm6sEbm5umjhxoiZMmJCvjYKG0J05c0YhISG2duWGOnfurG+++Ubff/+9WrVqpc8//1zfffed/vrXvxZL+39WsWJFy88+Pj42T+Rw+PBhubu757uHZf78+ZZhdIcOHco35Kpx48ZKT0/X2bNnLcv+XMmxpw9/FhoaWuBMjgX1wcPDQ/Xq1cuXiBfV77//rnr16lktu/69LapXr275cnytDbPZXGozMgYHB8vNzc2qupqamqqwsDCb2xg7dqzWrFmjGTNmaOPGjRozZkyBn2dhn3liYqLq1KljlVRcXwm/VZcvX1aHDh1UqVIlrV69WmvXrlVcXFyB/WzatGm+RE26Onth7dq1rZb9+fpLTEyU2WxWnTp1LEMcIyMjdfbsWZ08ebJYzuN2ue5Ki8lkUseOHTVo0CDNnDlTVatWzbfNli1btHPnTjVu3LjAkQh/NnbsWKWnp1tet1u8AAAlp7xV1mxO1tq1a6c9e/Zo//79Vsuzs7OVm5ubb/tHHnlEv//+u3bv3m3Vxp+HS0nS3r17lZSUpHvvvdfevheoffv2+vHHH7Vu3To999xz2rp1q7799lu7kzVXV9dbuun/RqpXr64rV65YbtC/5syZM5bhhTVq1NBvv/1mtf7XX39VQECAXYntrZxHQX3IycnRvn37VKNGjSK1eb3IyMh819SePXus3nt4eFgNIStouOmhQ4esEob9+/fL3d3dUqm0xa3EymQyqXHjxtq2bZulj8eOHbMk37bYsGGDJk+erHbt2ik6OtruCSOqVq2q33//3XK/oZQ/lra4URz27duny5cva/78+apXr55q1qxplTzaokqVKvmu/T9fA1WqVFFwcLBleOO114kTJ6zue7uVz+t2ue5Ki6enp6ZMmSJXV1fVr19fTzzxhNX6K1euaNCgQXr99de1ePFiLVy4UL/88ssN2/P397d6AQCA/GxO1mJjYzV48GB1795dP/30k9LT07VmzRrVq1dPX331lWU7wzAsw7+uDZm5ZvTo0fr11181ZcoUnTlzRrt27VLv3r311FNPqXLlypbtcnNzlZeXp7y8vAITwRupUKGCGjRooJUrV6pVq1aKjY3Nd1+dYRgym83Ky8uz/Hz9cWJjY7Vu3TqlpaVp+/btGjhwoKZNm2bZ/8///+d2bREcHKyBAweqf//+2rt3r86fP69FixapVq1ali+Mzz77rMaPH6+1a9cqPT1dmzdv1vDhwy3Dtq4d78/HvP69Ledx7bzNZrPMZrPVvv3799fRo0f17LPPKjk5WcePH9fAgQMVGBho9SDxP8evoHZu5PHHH9f27dv1yiuvKDU1VT/++KNldtBr6tSpozVr1ujIkSNKSkrKt94wDJ07d05DhgxRcnKy9u/fr2HDhumpp56yVD3y8vJkNpst1+e1z//6WK1evVoZGRlat26dOnfubDWJws3069dPc+fOVUpKiqZNm6YOHTpYXdc3U7VqVa1bt87yeffr189yftef759/vvb+wQcfVE5OjkaPHq0zZ85o9+7dGjJkSIFt3EhYWJiysrL0/fff69y5c3r77bfVsmVLpaenKyIiQpmZmfrmm2+Umpqq2bNna9GiRVbtX/u3W9i/rccff1zvvfeePvvsM50/f17z5s3T119/bVkfFxenyMhIzZkzRyaTSZ6envr55581YsQIbdmyxbJdbGysNmzYoJSUFO3fv19jxozRU089ZdM53k7XnWEYunTpksxms65cuaLMzEyb9y0u//73vxUTE6Pu3burRo0aGjdunJ544glduXKl1PsCALj9lZeqmmTn1P1z5sxR9+7d1b17d0VERGjatGmaOXOmOnXqJMMwNGbMGC1btkwBAQFKT09Xhw4ddP/998vHx0eSVKlSJX333XfatGmToqOj1blzZz300EOWSTOkq0Np3N3dNXnyZE2ePFnu7u5WMyTa4rHHHlPLli3l6emp7t27695777Xc3yJJ1apVk7u7uwYMGKBly5bJ3d1dHh4elqqIJMvN8+Hh4YqPj5e7u7t69+4tSZZ7gBo3bizpamK1ceNGPfDAA5ZZLW9m7ty5atu2rTp37qyqVavqgw8+0KpVq9SoUSNJUu/evTV79my98MILioiI0JAhQzR69GjLF8b58+dr2bJlGjhwoHbu3Kldu3Zp8ODBWrZsmebOnWvTebRt21axsbE6duyY3N3d5e7ubvXcuaCgIG3ZskUHDhxQ/fr1FRcXJ8Mw9NVXX8nDw0PS1Rk+3d3d87VzbaKTm6latarWr1+vjz/+WFWrVtXw4cP1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GzfOMqxv165d2rt3r/744w/LNh9++KGOHTumY8eOadOmTWrSpIn+/ve/S7o6jM/b21urV6+2aiMxMVEfffSRpQ1XV1fLMEV7RUZG6sSJE7pw4YJl2enTp3X27FnLew8PD6uhi4ZhKC0tLV9be/futfycnZ2tw4cPq3r16jb35VbOQ7o6ecm2bdss7xMSEhQXF1fk9gpToUIFxcbGasmSJfr555/14Ycf5tvmnXfeUbNmzbRu3bobtuXp6Sl/f3+rFwAAtiBZA4AbyMvLk2EYkq5+6Z49e7amTJliuU9q6NChWrBggY4cOSI/Pz+dP39eb7/9tkaNGmVpY/ny5Ro6dKjS09Pl7++vzMxMeXh4SLo6bHDQoEF6+eWXdeHCBVWoUEGHDx/W5MmT9dZbb1naqF69uvbt26d9+/bpjz/+0GuvvVbojIvXu+uuu1SzZk0NGDBAJ06c0JEjR/T4449bzkuSYmNjtWfPHm3evFnnz5/XM888o/T0dMs21/5/6NCh2rdvn5KTkzV8+HBVr17d0g/DMGQ2my0xM5vNVsM9rx1n3bp1SktL0/bt2zVw4EBNmzbN5s+jT58+Wr16tfbt26c1a9bo5MmT6tKli8372+LPn3lISIimTJmiZ555Jt99eNOnT9e2bds0b968Yj0+AADlFfesAbDZzJkz9fTTT0u6WkVasWKFOnXqpPj4eMXExCgxMVFdu3ZVRkaGBg4cqMOHDyssLEzt2rXTU089ZWmnZs2aOnz4sO68805dvnxZjRs31tKlSy3rX331VU2cOFHt27dXSkqKYmJi9NBDD6lnz56WbSIjIzV58mTde++9ys7OVvPmzfXMM8/YdB6urq5au3atRowYoXr16ikkJETDhg3T//73P8s2oaGhmjJlirp16yZXV1f1799f1atX1913360//vhDcXFxMplMeuCBB/Tggw/q1KlTat++vVavXm25R61atWo6fvy4pc1ly5bJxcVFP//8s5o2bSpJGj58uLZs2aLw8HCFhITowQcfVO/evW3+TOrXr6/JkyerVatW8vf314oVK2x+WLctnnzySc2dO1fS1c982rRpGjp0qD788ENFRkbqzJkzcnO7+p+Shx9+WMePH9fDDz9cbMcHAODPyts9aybjz39KBoByrFq1avr+++9VrVq1su5KuZKRkaGAgAA999xzRU40T506pYUL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",
      "text/plain": [
       "<Figure size 600x550 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "circuit = Circuit(2)\n",
    "circuit.hadamard(0)\n",
    "circuit.cnot(0,1)\n",
    "circuit.reset_qubit(0)\n",
    "circuit.execute()\n",
    "circuit.measure()\n",
    "state_as_string = circuit.get_classical_state_as_string()\n",
    "print(f'Measured state {state_as_string}')\n",
    "QuantumUtil.show_all_probabilities(circuit)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "Run the code block above multiple times and confirm that the state after resetting qubit $0$ is either $|00\\rangle$ or $|01\\rangle$.\n",
    "\n",
    "Now, we run this circuit $1000$ times using method *QuantumUtil.run_circuit()*. A histogram showing the occurrences of measured classical states is then created by calling method *QuantumUtil.histogram_of_classical_states()*. The states $|00\\rangle$ and $|11\\rangle$ should each occur about $500$ times."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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9evXG0nW83Tu3Dnz1VdfmYiICDNv3jxrXF5envn6669NfHy8uf322014eLiZNWuWWb9+vXniiSfMF1984da4Y8eOmapVq5p27dqZ5cuXm+3bt5tXX33VhISEmL///e/WdjMzM01iYqKRZPr27Ws2b95sXn75ZeNwOMyKFSuscSdPnjRRUVHm5ptvNu+9957Zvn27mTlzpgkICHD5+T179qypV6+eady4sVm0aJFJTU01b731lomOjjbNmjVz+d7VqVPHdOrUyWzatMn897//NQ8++KBVh7vy8/PNbbfdZoKCgsyMGTPM559/bt577z1Tr149ExYWZg4fPmyNvXSMxcfHm0ceecT62Tpx4kSRttuhQwcTGhpqXnrpJbNt2zazaNEiU7NmTZdj+HLR0dEu3/9f27dvn6lVq5YZP3682bp1q1m8eLGpUqWKGTp0qMu4qVOnmrCwMPP++++bbdu2mZdfftmEhoaay/9MLFy40Pj7+5t58+aZ7du3m/nz55vo6GgjyRw6dMhl7KWfz4kTJ5ro6Ogr1lfYn31jjOnQoYO5//77zYcffmg2bdpk/va3v5nIyEiTm5t7xbnXrVtXoH53/fzzzyYwMND069fPbN261axevdp06dLFSDJPP/20Na5Xr17Gy8vLSDIOh8N4enoaT09P4+3tbRYuXOgy59y5c02TJk3MG2+8YbZv325mzJhR4BgZPXq0KVeunHE4HC7zeXl5meeee85lvt69e5uwsDDzyiuvmG3btpmVK1eali1bmsqVK7t8T/r3729uuukms2rVKrNlyxYzefJk4+/vb2644Yareo7KMkLOdeJSyDHGmNtuu81MnjzZGOMacoz57YP68l+QrVu3NuPGjbPmLl++vLl48aL56aefjCSTmppqjPkl5Egy69evd5nvueeeM56enubo0aPGGGPq1atnHnvssQLbHTJkiAkKCjI///yzS3t0dLSJjo42R44ccet5uFy9evVM69atjdPpdGmfOnWq8fDwMAcOHHBpL45feu5sNy4uztxxxx0FHj98+HDTvXt3635hxx08eNAl5FzyW3/kWrdubYKDg82uXbt+d3/+aNyAAQNMfHy8uXjxokv70qVLjSSzfft2q61Pnz6mYcOGLs9Nu3btzOOPP27df/TRR014eLjJyMhwmW/58uUmMjLSuv/ss8+aatWqmXPnzrmM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K9eR0nqdDIV34cIFM2HCBBMfH2/27t1rvS788ssvG0ku6wPOnz9vQkNDTdeuXc2WLVvMkiVLTO3atY0k8/bbb5v8/Hxz6tQp07RpUzNgwACTnZ1t5s2bZyIiIkxaWpox5pf1O++8847Jzc01kydPNpJMlSpVzJtvvmk+//xzM2XKFOPr62ueeuopa7vz5883DofDPProo2b9+vVm48aN5umnnzaRkZEmJibGGnf8+HGzZ88eExERYSZOnGi9zpyZmVmk5+bjjz82Xl5eJjEx0axevdps3LjRjBgxwpQrV85lYfRvLTz+5ptvCqyrKc7trlmzxpQrV87ce++9Zs2aNeazzz4zgwYNKrBAubDjjDGmbt26pmXLluazzz4zH330kWnatKmRZCZPnmy99n/q1Kkrrg84deqUy1yFHbd3714TEBBg2rdvb1atWmW2bdtmkpOTTePGjU25cuXMd999Z4wx5syZM9Yagkuv+2dkZFhtl77PJ06cMJGRkaZhw4ZmyZIlZuvWrea5554zISEhplmzZtb3JC0tzYSHh5smTZqYDz74wGzfvt289dZbpk2bNsbhcLisM5NkoqOjzauvvmo2b95sVq5caerWrWvq16/v9vf34sWLpk2bNiYkJMTMmjXLWrDboEEDU7lyZZc1Ub+18PjX6x4K69KC58qVK5vXX3/dbNu2zbz99tumbt26pnLlytYaOGOMOX36tLWtXx9PX331lXVhgtPpNFWrVjW9evUy27ZtM59++ql56KGHjKenp4mIiDD/93//Z83Xp08f4+npaYYOHWo+/PBDs3XrVvPggw8aT09PlzVX48aNM5JMv379zLJly8z27dvN6NGjjSTzwQcfWONyc3PNV199Zfbs2WMmTpxoIiIirHq///57a1xhf/aHDx9uYmJizKpVq8zWrVvNzJkzTUREhJFk5s+fb86ePWuN3b9/v9mzZ0+B433//v1uf08urYO7+eabzbx586yfhYiICNO5c+cC4x977DFTrVo188knn5hNmzaZCRMmmHr16plnnnnGGGPMV199ZTw9Pc2zzz5rduzYYT744ANz++23G4fDYRITE82xY8dc5ps5c6YpX768+c9//mO2bt1qXnjhBdO0aVPzj3/8w/oet2vXzoSHh5vXX3/dbN++3Sxbtsz07NnTlCtXzowfP96aq3Xr1sbf39+MHz/e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mj59uuLi4jRt2jT16NFDPj4+1uOTkpLUqlUrDR06VPv379fx48fVuXPnUtkXAABQ9pTamZywsDDVqVNHa9asUb9+/ZSamqqRI0da/WPHjpUxRhEREcrMzNSkSZNcHh8XF6cJEyaoRYsWGjx4sBYuXChfX99rvRsAAKCMchhjTGkXURqys7MVFBSkrKysEnnp6oYRq4p9TsAuDk39W2mXUCw4zoHfVxLHujt/v0v9zQABAABKAiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADYEiEHAADY0lWHnA8++EArVqwojloAAACKjdshp0aNGgoMDNTZs2c1evRoDRkyRA8++KDGjh1bEvUBAAAUidshp3LlyhozZowqVKigFStWaOXKlfr44481d+7ckqgPAACgSLzcfcA333yjvn37SpJ+/PFHRUZGKiAgQD/++GNx1wYAAFBkbp/J8fX1ldPplNPpVHZ2tkJDQ7VhwwbVrFmzJOoDAAAoErfP5HTt2lX33HOPYmJidMcdd+jDDz/UQw89pBtuuKEEygMAACgat0POrFmz9O9//1u5ubnq3bu3li1bpocfflhVqlQpifoAAACKxO2Q4+XlpT59+lj377vvvmItCAAAoDgU6X1y8vLytHjxYs2cOVOStHnzZl28eLE46wIAALgqbp/JOX78uG677TadO3dOp0+fVlJSkmbNmqXWrVtrwIABJVEjAACA29w+kzNkyBC1a9dOhw8fVnBwsPLz89WjRw8tWLCgJOoDAAAoErfP5Kxfv17ffvutPD09rbbWrVvrgQceKNbCAAAArobbZ3ICAgKUlZXl0vbzzz/Ly8vtvAQAAFBi3A45nTp10qBBg5SdnS2HwyHpl8vK27VrV+zFAQAAFJXbp1+mTJmibt26qWrVqrpw4YIaNmyoyMhIPokcAACUKW6HnAoVKujjjz/Wzp07deDAAVWrVk0JCQny8CjS1egAAAAlosgLaRo1aqRGjRoVZy0AAADFxu3TLx07dlTjxo31yCOPSJJOnjyprl276uzZs8VeHAAAQFG5HXICAwOVm5trhZyqVasqNzdXkydPLvbiAAAAisrtkLN161YtXrxY9evXt9qmTp2qhQsXFmthAAAAV8PtkJORkaGqVau6tEVFRSkjI6PYigIAALhaboecxo0bF/gIh/fee08NGzYsrpoAAACumttXVz3//PNq27attm7dqri4OO3evVurVq3SunXrSqI+AACAInH7TE58fLx27typ0NBQbdq0SVWqVNHOnTvVpEmTkqgPAACgSIr0Pjm1atXSiy++6NJmjLE+5gEAAKC0FfnNANPT05WXlydJcjqd+stf/qITJ04UW2EAAABXw+2Q89FHH6lv376SJD8/P6s9PT292IoCAAC4Wm6HnAEDBmjGjBm6//77XdrvvffeYisKAADgarm98Dg7O1t33nlngfZFixYVS0EAAADFwe2Qc++9917xIxy6devm1jz5+fkaO3asIiIiFBISokGDBunixYtW/7lz59SlSxf5+/urY8eOysrKKjBHcnKyQkNDFRMTo7Vr17q7KwAAwMbcfrlq9erVOnz4sObMmaPg4GBJv1xZdeTIEbfmOXDggA4ePKj//ve/KleunNq3b69atWppyJAhkqQJEybI6XTq2LFjGjhwoEaNGqVXXnnFevzevXs1evRobdy4Ufv371f37t115MgRl3VCAADgz8vtkHP+/HkdPHjQpc3pdKpZs2ZuzXPjjTfq7bfftu5369ZN27Zts+ZLSUnR4sWLFRISouHDh6tt27Z64YUX5OPjI0lKSUnRPffco9jYWMXGxmrcuHFavny5unfv7u4uAQAAG3L75aq0tDRFR0e73GJiYpSWllbkIi5cuKCtW7eqadOmkqRjx44pLS3NeoPBBg0aKCcnR9999531mNTUVJc3IExISFBqaupvbiMvL0/Z2dkuNwAAYF9uhxyHw6G8vDwtXrxYM2fOlCRt3rzZZT2NO95++21Vr15dnp6eGjx4sKRfLkf39fW1XnpyOByqWLGiS5BKT09XSEiIdT80NPR3g9aUKVMUFBRk3aKioopULwAAuD64HXKOHz+uBg0a6PHHH9fIkSN1+vRpzZo1S2+88UaRCujQoYNeeOEFHThwQJMmTZKkK75zstPpdGm/fMzl/ZcbOXKksrKyrNvRo0eLVC8AALg+uB1yhgwZonbt2unw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nXe0YcMGHT16VAMHDlRGRoZ+/vlna8ztt9+uCxcuaMyYMVd8Kalbt246ePCg1q1bp++//161atXSvn37lJWVJUny8PBQ27Zt9cknn+iHH35Qly5dNGLEiELvY2H8+9//1s6dO7Vr1y7t379fXbt21alTp6yQkpycrFWrVikiIkK7du3Srl27tHPnTlWuXNmao3z58ho6dKi+/fZb7du3Tzt37tSqVaskSY0aNdKXX36pzp0765lnnrHm+HXI2bRpkxITEzV48GAdPXpUr732msaMGaM333zTGtOnTx898cQTOnXqlBYuXChvb2+dO3euWJ8L4HpTNs5VAyg2p06dUnh4+FXPk5+fr9dff12PP/64fH19df78ee3Zs0dxcXGSpNzcXCUkJCgwMFCBgYFKSUmxwsel/oiICFWrVk0+Pj568MEH9fe//11BQUEu2/H09JSHR8H/t7788ktt2rRJJ06cUHBwsCRp1qxZOnXqlBUgLly4oMOHD+vVV1/VmTNnVKlSpQIvyV2t3NxcxcTEKCwsTJ6enho+fLj69+9v1ezv76/KlSvL09PzN593Y4wWL16sp556Sg6HQxcuXNCePXt01113SZKqVKkiPz8/BQUFXXGO5557TkOGDFGPHj0kSW3atNHTTz+t559/Xv/4xz+sOhs1aqTy5curWbNm2rhxo/Lz84v1uQCuN5zJAWymUqVKV70+5Pjx4/rrX/+qhIQErV69WosXL1bt2rVdFig//fTTmjNnjipUqKBq1arp1ltv1YoVK6z+9u3bq169egoNDVWVKlVUr149jRgxQufPny9UDQcOHFC1atWsgCP9EogWL16syMhISdLIkSO1fPlyPf/88/rss8/0xBNPFPsi6t69eys3N1eBgYEKDw/XzTffrGnTpsnpdBbq8Tk5OWrfvr0qV66spUuXauXKlUpISHCrzv379+u1116zXsoKDw/X6NGjdfz4cWtMcnKy7rjjDlWsWFExMTHq1KmT9uzZ4/b+AnbCmRzAZm677TYNHDhQX3/9terWrWu15+XlycvLS56enn84x9atW1WrVi2NGzfOavP393cZM3fuXC1btkyVK1dWRkaGUlNT1aVLF7Vv315hYWHavHmzGjZsqOTkZJ0+fVqnTp1Sz5499corr2jYsGF/WEPNmjV19OhRZWZmugSdEydOqGrVqnI4HPrvf/+riRMn6rbbbpMkpaen/+G87lq2bJn69u2rRYsW6fTp0zp+/Lg6deqkRo0aWWuQPD099dNPP13x8fv27VNOTo5effVVqy0kJKTAuN+bo1q1anrggQfUq1cvl/YKFSpYXy9evFiHDx/WuXPnlJWVpeTkZD3wwAPau3ev2/sM2AVncgCbqVWrlh566CF169ZNW7duVVZWlpYvX67Y2Fh98skn1rj8/HxdvHjR5etL60yqV6+u77//Xrt27dKpU6f01FNPafXq1Va/9Mti2u7du+vbb79VcHCwcnNz5eHhYV2x9f333+tf//qX3nvvPfn6+srHx0e5ubny9va25nA6nbp48aKcTqfL15LUuHFjtWzZUklJSTp48KB++OEHTZ06VXXq1LEWL1evXl0ffvihsrKytHHjRvXp00eSXOq8NK8xpsB+Fsa3336rhx9+WJ9++qnKly8vDw8P/fzzzy77ERYWptzcXK1fv16nT5/WnDlz1Lx5c2VlZSkiIkLnz5/XmjVrlJGRoVmzZmn27NkFaqhVq5Y+/PBDZWZm6osvvtCDDz6oqVOnSpL69++v119/XQcPHlSFChV05swZzZkzR0OGDLEe/+6776p///7KyspSYGCgzp8/71Ij8KdkANjOxYsXzdixY01kZKTx9/c3zZo1M//5z3+s/u3btxtPT08jyeXWu3dva8yYMWNMcHCwqVKliunevbt5+OGHjSQzb948Y4wx999/v7n99ttNtWrVjLe3t7npppvMwoULrcevWrXKNGjQwDRo0MD4+vqaSpUqmYceesjk5eUZY4zJzs42AQEBBWrw8fExJ06cMMYYk5WVZR5++GETHh5ugoKCzF133WW2b99ubePrr782TZo0Mf7+/ubmm282ycnJxt/f30RHRxtjjDl+/Ljx9fUtsI1WrVoV+rl85ZVXzC233GLq1KljvL29TdWqVc2oUaOM0+l0GbdgwQITERFh/Pz8TPPmzU1KSorVl5ycbKpUqWIqVqxoOnbsaEaNGmUkmXHjxlljMjMzTceOHY2Pj4+JjIw0/fv3N0eOHLH658+fb+rVq2d8fX1NdHS06devn9m1a5fVX7t2bXPbbbeZkJAQq4adO3cWej8BO3IY48a/NAAAANcJXq4CAAC2RMgBAAC2RMgBAAC2RMgBAAC2RMgBAAC2RMgBAAC2RMgBAAC2RMgBAAC2RMgBAAC2RMgBAAC2RMgBAAC29P8AdixMol0IseIAAAAASUVORK5CYII=",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "result = QuantumUtil.run_circuit(circuit, nr_runs=1000)\n",
    "QuantumUtil.histogram_of_classical_states(result)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Example: Greenberger-Horne-Zeilinger state\n",
    "The Greenberger-Horne-Zeilinger (GHZ) state is an entangled quantum state involving 3 or more qubits. The GHZ state for 3 qubits is defined by\n",
    "\n",
    "$|\\text{GHZ}\\rangle = \\frac{|000\\rangle + |111\\rangle}{\\sqrt{2}}$\n",
    "\n",
    "Below a circuit of $3$ qubits is defined to create a GHZ state. \n",
    "After establishing the GHZ state, qubit $1$ is reset. Upon resetting the state of qubit $1$, also the state of the other qubits is determined.\n",
    "\n",
    "As before, intermediate probabilities are shown. Run the code block below multiple times to confirm that resetting qubit 1 determines the final state to be either $|000\\rangle$ or $|101\\rangle$."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Measured state |101>\n"
     ]
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA7IAAAFoCAYAAABquseUAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjcuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8pXeV/AAAACXBIWXMAAA9hAAAPYQGoP6dpAAB6XElEQVR4nO3dd3xN9/8H8Ne9uTfjZsoekggRI9RKokbttEaJvYuasVXVqFm0ZopYRamGmlWjKFpaq7RGECMqRsQIiSyyb+75/eGb83Ml4d5I3OH1fDzuQ+4Zn/N+33Nw3/l8zudIBEEQQERERERERGQgpLoOgIiIiIiIiEgbLGSJiIiIiIjIoLCQJSIiIiIiIoPCQpaIiIiIiIgMCgtZIiIiIiIiMigsZImIiIiIiMigsJAlIiIiIiIig8JCloiIiIiIiAwKC1kiIiKiEnLu3DmsWbNG12GQljIzM7FgwQI8fPiwRNoTBAFLlizB9evX9bI9ImPAQpaIiIhIA0+ePIFCoYBEIsHw4cML3WbVqlUYNmzYW47McGVnZ8PGxgZSqRSnT58ukTb9/PwgkUiwdetWjfeJjIzE+PHjceTIkULXL168GBKJBBKJBFKpFP/+++8r23v48CHGjBmDn3/+WavY31Z7RMaAhSwREdE7bvv27ZBKpeIX9Re/sO/atatYbV69ehWVK1cu2UB1zMHBAVeuXEFISAjS09ML3eajjz7CyJEjS+R4FStWNPoeODMzM1y6dAmCICArK6tE2vzrr7/g7u6OzMxMjfcpX748+vbtizp16hS6fsiQIbh69SqioqIgCAIyMjJe2Z69vT369++Pxo0bF7nN1KlT8dVXX2kUnybtEb1rZLoOgIiIiHQrJCQEV65cQV5eHqZMmQIAmD17NkxMTODr61usNh8/fmyURZiPjw/s7OyKXN+pUyd06tSpRI4VExOD+Ph4VKpUqUTa01flypUr0fbc3d0hl8u12sfV1RXr168vcr2FhQWqVKmicXvm5uZYu3btK7eJi4uDRCIpsfaI3jXskSUiInrHmZqaokqVKqhWrRrs7OxgZ2eHatWqoUqVKmJBkJmZKQ4B/fbbb9GoUSNYW1ujRo0a+Pvvv4t97L///hstW7aEra0t7Ozs8MEHH+DAgQNq23zzzTdiL/H27dtx/PhxNGnSBAqFAj4+Prh69SqaN28OiUSCZs2awc3NDd7e3oiIiEDNmjVhZ2eHr7/+WuvjAsDBgwcRFBQEc3NzuLm5Ydy4ccjJySmw3bRp08QYq1WrVmS+O3fuRIMGDWBrawtLS0vUq1fvlcNUBUF45ed379499OvXD66urlAoFHjvvfcQHh4OpVL5yv1elpubC3t7e0ilUmzcuBGdO3eGtbU17Ozs0KNHDzx48EDc9vjx45DJZOIQ67t376Jnz54oU6YMypQpg02bNonb3r9/H59++ilcXV1hamqKChUqYPLkyYX2lkZHR6N169awtLSEnZ0devbsWeCe1aioKISEhMDZ2RlmZmbw8/NDREREoTk9ePAA3bp1g52dHaysrPDxxx/jv//+K3BMU1NTjYcMv87Tp09haWkpXguvGwr8uvOraXsqlQqLFi2Cv78/zM3N4e3tjX79+uH+/ftq26WlpWHw4MEoW7YszM3NUaFCBTRu3BgffvihdokS6QOBiIiI6H/69u0r9O3bt9B1d+7cEQAI1tbWwnfffSf8/fffQkhIiODu7i5kZWUJgiAIly9fFhQKhSCVSgUAgomJifiqXr26WnsHDx4U5HK5MGTIEOHPP/8U/v77b2HixImCVCoVli9fLm737Nkz4erVq4K7u7vQpk0boWzZssIPP/wg/P7778LIkSOF27dvCwkJCUJgYKDg4+Mj/PHHH0KLFi0EAML06dOFFStWCHK5XHjy5IlWx927d68glUqFQYMGCceOHRN27dolVK9eXZBKpQU+o2fPngmXL18WZs+eLXh7exf5+X744YdCjx49hP379wsnTpwQ2rRpI3h4eIifnyAIgre3tyCTyQQAglQqFT8/a2tr4c6dO+J29+7dE9zc3IRmzZoJe/bsEf79919hxYoVgr29vdClS5dXnufCxMbGChYWFoKJiYkwbNgw4dixY8KOHTuEKlWqCOXLlxeSk5MFQRAEpVIpXL9+XQgJCRHq1asneHh4CDNnzhSOHz8uTJ48WTh06JAgCIJw//59wcPDQ6hUqZKwefNm4dSpU0J4eLhQpkwZ4YMPPhByc3PFYwMQZDKZMGLECOH48ePCzz//LFSqVEnw9fUVUlNTxe2mT58uNG7cWNi4caPwzz//CJMmTRKkUqlw8eJFtVy8vb0FExMToXv37sKff/4p7N27V6hbt67g6OgoxMbGitupVCrhv//+E6KiogQAwp9//vnaz+l12926dUuIiooS3N3dhR9++KHA+smTJwtyuVyQSCSCRCIRz69MJhMWLFigdXuCIAh9+vQRXFxchOXLlwv//POPsHfvXuGDDz4QnJyc1K6Z0NBQoVKlSsK+ffuEv//+W/jmm28EhUIhlCtX7rV5E+kbFrJEREQkelUhKwjPv8QvWrRIfH/37l0BgFhI5OXlCdHR0cK6desEAEJUVJT4un//vlpbVatWFcaMGVPgGKNHjxZsbW2FnJwcteXe3t6Ct7e3cPfu3UJja9y4sTB9+nRBEARhzZo1gpWVlaBUKoX09HQBgHDmzBmtjlu5cmUhJCREbZtHjx4Jtra2RX5GP/zwwysL2Zflf36XLl0Sl8XGxoqF1bp168TP78aNG2r7Dhs2TAgICBCUSqXa8p07dwoAhH///VfjOPJZWloKn3zyidqyBw8eCNbW1sLMmTPVlvft21cwNTUVC9eXDRs2THB0dBQeP36stvzkyZOCVCpVK8oACP369VPbLr+wnjNnzitjrlChghAeHq62zNvbW2jSpInasrS0NMHNzU0YMmRIoe2UVCH7YgyFFZ6pqalCVFSUEBISIoSEhIjn9/Lly0J6errW7f3777+CRCIRIiMj1ZZnZmYKrq6uwrBhw8RlPXv2FEJCQsRf6giCIJw4cUIYNGjQa/Mh0je8R5aIiIi0UqNGDfFnT09PAEBSUhIAQCqVolKlSuKQ0KKG2T558gRXr15FdHQ0li5dqrZOEASoVCqkpKTAyclJbd3UqVPFY76KTCaDg4MDTExMoFAoAADPnj3T+LhSqRTR0dEYP3682jbOzs744IMPXnv8ovzwww9YtWoVYmJikJWVJd6D/OTJE3EbLy8v8WcfH58iP8Njx47hypUrMDMzK3T9nTt3EBgYqHWML9/j6+bmhg8++ABHjx7F1KlT1dZ17doVwcHBRcbXqlWrAuewfv368PPzw9GjR9GvXz9xeefOndW28/LyQlBQEE6cOCEuO378OObMmYOLFy8iOTkZbm5uSEpKUvv8imrP2toaH374oVp7umBjYyMO4weK/juiqWPHjkEQBAQEBBRYp1KpcOfOHfH9rFmz0Lt3bzg4OEAikcDGxgY+Pj4YN27cG8VApAssZImIiEgrmk5Q8yp5eXkAgK+//hoff/xxgfatra0LFEAAYGJi8laO+/jxYwDPC+Ki2tDWmjVrMHLkSEycOBHNmjWDpaUlbt26ha5duxarvby8PHTo0KHQmW9NTU2LPVGXUMR9m9nZ2QWWvep8CIKg1bVS2HFfbCMqKgrBwcHo2rUr1q1bBycnJzx69AijR48uVnvGIi8vDzKZDOfOnYNUqj79jVQqhYeHh/i+fPny+Pvvv5GSkoJHjx7h6dOn2L59Oz755BPUrFkT/v7+bzt8omLjZE9ERERU4vILwOTk5ELXOzs7w9PTE9HR0ahWrZraq2LFikhLSyuVuDQ9rrOzM7y9vbFz5061/R89eoSTJ08W69h79+7FwIEDMWPGDDRq1Ah16tR5ZY+piYlJkZ8fANSpUwdRUVHw8/MrkEtWVtZrJxIqSmE5nzhxoshH0xTlgw8+wG+//Vagt/TMmTP477//0KhRI7XlL09kdO/ePZw9e1Z85Mwff/wBX19fRERE4KOPPkLt2rURHBxcZJ47duxQe//s2TP8/vvvevMIG5lM9srzq6k6depAqVQiKSmpwHVQpkwZtUcF9erVC5s3b4adnR0qVaqEgIAAjB49GoIgGOUs42Tc2CNLRET0jsvJycHNmzeRl5eHlJQUAMDly5dhYmKCChUqwNTUFABw+/ZtAMDdu3ehVCohk8lw69YtAM+Ljry8PLGHrlKlSpDL5Zg1axZ69uyJ27dv45dffsGRI0dw584dWFhYYNasWfj0009hbW2Nzp07w8TEBIcPH8aaNWtgamoqtv3gwQMkJSUhNzcX9+/fx+XLlwE8H9Zsa2sLAEhISEBGRgYSEhLw9OlTAM9n4n306BFcXFwAPJ9BVxAEjY87a9Ys9OnTB4MHD8Ynn3yCpKQkTJ06Fc+ePUNKSgrS0tJgY2OD7OxsxMTEQBAE3L9/H7m5uWKMlpaW8PHxAQBUqVIF27Ztw/79++Hg4IDTp09j/vz5AIDY2Fg8e/YMVlZW4nmpXr06li9fDjc3N6SmpmL//v3Yvn07Nm/ejMaNG2PSpEkICgrCxx9/jDFjxsDR0RHnz5/HmjVrEBUVhatXrxarV3bTpk2wsbFBt27dkJiYiGnTpsHExARjx44FAKSmpiIuLk7tWgGeP+vU3d1dbGfKlCnYvXs3GjdujGnTpsHb2xvnz5/H9OnT8f7776N3794AIA593bBhg3jcR48eYcqUKfD29kZoaKj4+cXExGDt2rWoUaMGrl+/jiVLluDmzZtISEjA48eP4ezsLJ6Do0ePokePHggNDUVGRgZmz54NlUqFL7/8Uozx1q1baoXe7du34ejoCIlEgooVK4rXfnx8PBITEwtsJ5VK4efnJ/7iJi4uDqmpqeL1l3+9SiQSlCtXDpaWlmrnN/8zcnV1xd9//43Nmzfjvffew/fff69xe82aNUOzZs3Qo0cPfPXVV6hVqxYePnyIbdu2Ydu2bZgyZQqmTZsG4PnfgYEDB+LGjRto0KABzMzMsGDBAlhaWhZrGDqRTunixlwiIiLSH1u3bhUAFHhJpVJhx44dgiAIQlZWlmBtbS0uP3z4sJCdnS0oFApx2cGDB9XazZ951tTUVPDw8BB69+4tHD58uMA2AQEBgpmZmeDg4CDUq1dPCAsLU5uMxs/Pr9D4XpzE5sMPPxSXf/nll+KMw/kT/pQvX16QyWTCzZs3NT6uIAjChg0bhEqVKglyuVwoX768sGzZMqFt27ZqkxOtWLGi0PgACAqFQsjIyBAE4fnMxv369RPKlCkjlClTRmjQoIGwc+dOoWbNmgKAApMpRUVFCQ0bNhTMzc0Fe3t7oWXLlsIPP/ygNrlTZGSk0Lp1a8Ha2lqwtLQUqlWrJnzxxRfCf//9p/2FIDyf7GnVqlVCx44dBRsbG8HCwkL46KOPhMuXL4vbDB48uNBcq1atWqC9u3fvCn369BGcnZ0FmUwmlCtXTpg4caI4qVFOTo54Xc2ePVto3ry5YGFhIdjZ2Ql9+vQpMFHUvHnzBA8PD8HS0lKoXr26MG/ePGHkyJECAKFZs2aCIAhCpUqVBADC2LFjhQ4dOghWVlaCpaWlEBISIp5/QRCEpKQkwdzcvNBcJBKJsH79enHbGjVqFLndnj17xO1cXFyKvBZmzJihlktOTo4wdOhQwcHBQbCwsBCqV68uTJkyRbh3757W7aWnpwuff/654OnpKZiamgre3t5Cp06dhF9//VVQqVTidn369BE+/PBDoW7duoKNjY1gZWUlNGjQQPjrr780u0CI9IhEEIo57oSIiIiIjIqVlRV27dqFFi1a6DoUIqJX4j2yRERERIS7d++Ks9xevnxZbSgtEZG+YY8sERER0TsuNzcXzs7O4n2vAPDhhx/i4MGDuguKiOgVWMgSERERERGRQeHQYiIiIiIiIjIoLGSJiIiIiIjIoLCQJSIiIiIiIoMi03UAREREr6JSqfDgwQNYW1tDIpHoOhwiIiKtCIKAp0+fwt3dHVIp+xFLCgtZIiLSaw8ePICnp6euwyAiInojcXFxKFu2rK7DMBosZImISK9ZW1sDAD777DOYmZnpOBoiIiLtZGdnY9GiReL/Z8Ziy5Yt2L59O06ePIn4+Hit91+5ciWmTJkCGxsbrF27Fs2aNdNqfxayRESk1/KHE5uZmcHc3FzH0RARERWPMd0eo1QqsXfvXlSuXBm//PKL1vtfuXIFkydPxvHjxxETE4Nu3brh7t27sLCw0LgNDtImIiIiIiIijclkMmzcuBGDBg0q1v4RERHo2LEj/P39ERISAg8PD+zZs0e7GIp1ZCIiIiIiItJLWVlZyMnJ0WofQRAK9BqbmZmVym09Z86cQZcuXcT3QUFBOHPmDLp166ZxGyxkiYiIiIiIjERWVhZ8LCyg7V2rVlZWePbsmdqy6dOnY8aMGSUWW75Hjx7B3t5efO/g4IC4uDit2mAhS0REREREZCRycnIQD+AuABsN90kD4PXsGeLi4mBj8/97ldYkiy/3/KpUKq3vIWYhS0REREREZGSsIYE1NCsOBQgABNjY2KgVsqXFxcUFSUlJ4vukpCS4uLho1QYneyIiIiIiIjIyAiRavUragQMHEBgYiHXr1hVYFxAQgLNnz4rvz5w5g6CgIK3aZyFLRERERERkZEq7kM3OzkZGRgYA4NmzZ8jNzVVbv3TpUpw9exZhYWEF9v3kk0+wc+dOXL16FXv27MH9+/fRrl07rY7PocVERERERERGRpsCVdCy7YSEBJQtW1acGdna2hoeHh64d++euE379u1x9OhRdO3atcD+1apVw6xZs9CwYUPY2Nhgy5YtWj8rXiIIgrZxExERvTVpaWmwtbXFxIkTtf5PrigpKSnib5ENhUKhgJ2dndoy5qE7zEO/MA/9Ysx5FEdWVhbmzp2L1NTUt3L/af7/mwmQw0bDQjYNApyQ+9ZiLAnskSUiondKSkoKVixbhhylUtehaMVUJsOwESPEL1UpKSlYtmwFlErtnhOoazKZKUaMGMY89ATz0C/MQ7+8nIehKc0eWX3AQpaIiN4pGRkZyFEqsRFAFV0Ho6FrAHorlcjIyBC/UGVkZPzvS6FhZaJU9mYeeoN56BfmoV8K5mFoWMgSEREZoSoAaus6iBJhLJkwD/3CPPQL8yDtsZAlIiIiIiIig8JCloiIiIiIiAwKC1kiIiIiIiIyKCxkiYiIiIiIyKCwkCUiIiIiIiKDwkKWiIiIiIiIDAoLWSIiIiIiIjIoLGSJiIiIiIjIoLCQJSIiIiIiIoPCQpaIiIiIiIgMjqaFrCGWslJdB0BERERERESkDfbIEhERERERGRnthhZr2nOrP1jIEhERERERGRkWskRERERERGRQWMgSERERERGRQTH2QpaTPRGRzmzevBmXL18u9v7379/HypUrSzAiIiIiIuOQX8hq+jI0LGSJSGemTZuG3bt3F3v/v/76C6NGjSrWvn369IFEIoFEIsHWrVuLHQMRERGRPmIhS0T0ggEDBogFYP6rUqVKxWorLCwMXbp0KXRd3bp1kZCQ8Mr9mzZtih9//LFYx46IiIBSqUSfPn2QmZlZrDY0Ub58+Tfaf/HixQgPDy+haIiIiOhdwUKWiOgFa9euhVKpxNq1a9GnTx/k5uYiOjq6WG21a9cOfn5+ha579OgR0tPTX7m/u7s7evbsWaxjA4CJiQkkktL9h/v27dtvtH9KSgqSkpJKKBoiIiJ6V7CQJSJ6iYmJCaRSKSQSCWQymVgMqlQqODs7o1y5chg6dCgcHBxQrlw5/Pbbb2r7r127tshhvd999x3c3d0RFxeHwMBAuLq6wt3dHfv371fbztPTExKJBFWqVCk0xlGjRsHDwwNmZmaoXr06zpw5U4KfwHPTp0+Hh4cHLC0tUatWLXh7e+Px48cAgMmTJ8PNzQ0A4OrqCldXV5QtWxYXL14U97958yaaNm0KGxsbWFtbo3v37mLv8OPHj+Ht7Y2FCxdi4cKFYhv9+vVTi+HcuXNo1qwZ7OzsUL58eXzzzTfIy8sr8VzfpuzsbKSlpam9iIiISDssZImINCSVSvHvv/8iNjYWCoUCN27cwDfffIN+/fpBEARxuwEDBhQ5rHfgwIE4f/68WLxeuHABkZGRaNWqldp2d+/eRUxMTJHDggMCAvDLL78gISEBkydPxtChQ0s017/++gsbN27EsWPHEBcXh+HDhyMpKQk5OTkAnt//GxkZCQC4cOGCmEeNGjXENszNzfHpp58iMjISsbGxyM3Nxdq1awEAzs7OOHfuHEJDQxEaGiq28eLkVjdv3kTjxo3Rrl073Lp1Cz///DMiIiIwY8aMEs31bZszZw5sbW3Fl6enp65DIiIiMjjGXsjy8TtEVOJsbW2xcOFCSCQS9OzZE2PGjEF8fLzYQwkUPaxXJpPB1dUVJiYmcHJygqura6HHkEgkMDExKXSdSqXC48ePsWzZMjx69Aju7u6IiooqmeT+JysrC+7u7ihbtizMzMwwcOBAdOnSBba2tgAAMzMzMfaicsjLy8ORI0cwZ84c5OTkwNTUFI6OjuJ6R0dHWFlZFdlGeHg42rZtizFjxgAA7O3tsXjxYnTu3BlfffUVpFLD/F3lpEmTMHbsWPF9Wloai1kiIiItGfvjd1jIElGJs7OzUytSFQoFsrOz39rxw8PDsWTJEqxYsQLVq1dHbGwsmjRpUqLHCA4Oxs6dO+Hg4ACFQgFHR0c0btwYYWFhUCgUGrXRrl07+Pr6YtOmTbCzs0N4eDiSk5M1jiEmJgbHjx9XK3JVKhUyMjKQlJSkVhQbEjMzM5iZmek6DCIiIoNm7IWsYf66noiMnomJyWsneyrK4cOHMW7cOLRt2xblypUr8j7aN3Hy5EnUrFkTaWlpuHLlCrZv345Tp05h+fLlattJpdJC83jy5AkuXryItWvXolatWvDx8VHrsc73qs+hbNmy+PTTT8VhxxcuXMClS5eQkpJS4kXsnTt30LhxY4wYMaLIbUaPHo1GjRoVOcHVgQMHEBgYiHXr1pVobERERFSQsQ8tZiFLRFrLy8uDSqWCIAhQKpVq97+++POLXlyuUqnE/fJ/VqlUatv7+vpi586dSEtLw/79+9G6dWscOXJEXK9UKsVJjZRKJZRKpbjOy8sLf/zxB5KSkhAZGYkOHToUK4ZXuXXrFsaPH4+tW7fC3NwcZmZmyMrKgqmpaYE8duzYgZSUFGzbtg1NmjRBdHS0eP/nrl27kJqaik2bNmH27NkFPj9fX18cPnwYCQkJuHbtGsaOHSs+O3fw4MHYsmULLl26BEtLS2RkZGDLli345JNPNM5DU9u3b8exY8ewfPnyQh+LlJCQgPDwcBw/fhw///xzoW0sXboUZ8+eRVhYWInHR0REROpYyBIRvWDAgAGQyWQYMGAAIiIiIJfLUblyZQDPC8X3338fsbGx6NixIwCgS5cuiI2NRb169ZCXl4fr16/D3NwccrkcERERGDBgAORyORwdHdVm212wYAG2bdsGZ2dnjBs3DvXr10e9evUAAH379oVcLoevry9iY2Mhl8shl8uxaNEiAMDUqVORnp6OsmXLolu3bujcuTM8PT1hbW2NZ8+eQalUwsnJqUAMPj4+Gn8Ozs7OqFChAubNmwdnZ2fUq1cPjRs3LjCp1MqVK/HVV1/B1dUVc+fORadOnVCxYkXIZDKsX78eU6dOhZeXF1avXo3Jkydjw4YNajMTd+nSBf7+/vD29kbjxo2RkJCA0NBQAECdOnXwww8/YNKkSXBxcUGjRo1w+vRpfP7559qf2Ndo3rw5nJycEBwcXGhvr4ODA5o3bw5nZ2cEBwcX2kb79u1haWmJrl27lnh8REREpM7YC1neI0tEWlm7dq04s+7LJBIJHj16pLZs+/btau8rVaokzuz7Ku+99x4uXbpU6Loff/wRP/74Y5H7urq6qvXeAsBnn32m9v7JkyevjeFVWrdujdatW792u2bNmuHmzZuFrmvfvj3at2+vtmzChAlq72UyGTZs2IANGza8URxvqnbt2uKjhQojlUrxxx9/vLKNQYMGYdCgQSUdGhERERXC2O+RZSFLRERERERkZFjIEhERERERkcExxAJVUyxkiYiIiIiIjAx7ZImIiIiIiMigsJAlIiIiIiIig8JCloiIiIiIiAwKC1kiIiIiIiIyKCxkiYiIiIiIyKCwkCUiIiIiIiKDwkKWiIiIiIiIDAoLWSIiIiIiIjIoxl7ISnUdABEREREREZWs/EJW05e2Tp48iYoVK6JMmTL49ttvtdo3NzcXo0ePhpOTE9zc3PDVV19pfXz2yBIRERERERmZ0uyRVSqV6NatG+bPn4/AwEA0aNAADRs2RFBQkEb7L168GKdPn8b58+fx7NkzfPzxxyhfvjw++eQTjWNgjywREREREZGRKc0e2d9//x3m5ubo2bMnKlasiJ49e+KHH37QeP+jR4+iT58+8PT0RJUqVdCxY0ecOnVKqxjYI0tERO+ka7oOQAuvjtVYMmEebx/z0C/MQ78YUqyFK06PbFpamtpyMzMzmJmZFdj+zJkzqFOnjvg+KChIq+HFnp6e2L17N/r374+srCwcPHgQX3zxhcb7AyxkiYjoHaNQKGAqk6G3UqnrULRiKpNBoVCI7xUKBWQyUyiVvXUYlfZkMlPmoUeYh35hHvrl5TwMTXEKWU9PT7Xl06dPx4wZMwps/+jRI9jb24vvHRwcEB8fr3Fs06dPx4cffogyZcpApVKhS5cuWg0rBljIEhHRO8bOzg7DRoxARkaGrkPRikKhgJ2dnfjezs4OI0YMYx46wjz0C/PQL8aah6EpTiEbFxcHGxsbcXlhvbEAIJGot6tSqQose5Xo6GiYmpri5MmTSExMRPfu3XHs2DE0atRI4zZYyBIR0TvHzs7OoL+c5GMe+oV56BfmoV+MJQ9DUpxC1sbGRq2QLYqLiwsuX74svk9KSoKLi4vGsU2bNg2hoaHi8OTu3bvjxx9/1KqQ5WRPRERERERERqY0J3sKCAjA2bNnxfdnzpwpMGPxgQMHEBgYiHXr1hXYPy0tDVLp/5eipqamWvXoAuyRJSKid1BKSopRDHFjHrrDPPQL89AvxpyHoSnO82E1ERwcjMzMTGzevBmBgYHYtGkT9u7dq7bN0qVLcfbsWYSFhaF///5q61q2bIlly5ahRYsWePLkCTZv3ozvv/9eqxhYyBIR0TslJSUFy5ctR64yV9ehaEUuk2P4iOHil6qUlBQsW7YCSmWObgPTkkxmihEjhjEPPVFYHvz7oTvGfF0ZQx6GpjSfIyuTybBt2zb069cPiYmJmDZtWoEe2fbt2+Po0aPo2rVrgf2nTZuG5ORk1KpVCxYWFpgwYQLatWunXQxabU1ERGTgMjIykKvMRQd0hBMcdR2ORhKQiJ3KX5CRkSF+ocrIyPjfl8KNAKroMjwtXINS2Zt56I3C8+DfD10x7uvKGPIwNKVZyAJAw4YNERMTU+T6QYMGYdCgQYWuUygUWLVqFVatWqX1cfOxkCUioneSExzhBnddh1ECqgCoresgSgDz0Cf8+6FvmAdpr7QLWV1jIUtERERERGRkWMgSERERERGRQWEhS0RERERERAaFhSwREREREREZFBayREREREREZFBYyBIREREREZFBYSFLREREREREBoWFLBERERERERkUFrJERERERERkUFjIEhERERERkUFhIUtEREREREQGhYUsERERERERGRQWskRERERERGRQWMgSERERERGRQWEhS0RERERERAbHEAtUTUl1HQARkbHbvHkzLl++rOswiIiI6B2S3yOr6cvQsJAlMlATJkyARCJBaGiorkMpUlJSEhQKBUxMTPDgwQNdh1NiEhMTYWFhgZYtW2q0/bRp07B79+5SiSUvLw+DBw+GpaUl6tWrh7i4uFI5DhERERkWFrJE9MZ27doFqVQqFp779u2DiYkJJBIJlixZUqw2582b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9Avz0C/GnIchKU6PrKenp9ry6dOnFzrkVyJRb1elUhVY9io//PADGjduDFdXV433eRkLWSIieqekpKRg+bLlyFXm6joUrchlcgwfMVz8UpWSkoJly1ZAqczRbWBakslMMWLEMOahJ5iHfjHmPIzh311DU5xCNi4uTu0eWTMzs0K3d3FxweXLl8X3SUlJcHFx0Ti2RYsW4eeff1ZblpSUpNbL+zosZImI6J2SkZGBXGUuOqAjnOCo63A0koBE7FT+goyMDPELVUZGxv++3G4EUEWX4WnhGpTK3sxDbzAP/WLceRjDv7uGpjiFrI2NjUaTPQUEBGD9+vXi+zNnzhSYsfjAgQOYOnUqhg4div79+4vLc3NzERMTg8DAQADPZ0AWBAFKpRKzZ8/WKF6AhSwREb2jnOAIN7jrOowSUAVAbV0HUQKYh35hHvrFOPIwnn93DUNpTvYUHByMzMxMbN68GYGBgdi0aRP27t2rts3SpUtx9uxZhIWFqRWycrkcMTExyM7OhiAIWLp0KSQSCSZNmqRVDCxkiYiIiIiIjExpFrIymQzbtm1Dv379kJiYiGnTphXokW3fvj2OHj2Krl27Ftjfx8cHANC5c2fs2LEDAPD+++/jk08+0TwGrSImIiIiIiIivVeahSwANGzYUHyObGEGDRqEQYMGvbKNl++T1QYLWSIiIiIiIiNT2oWsrrGQJSIiIiIiMjIsZImIiIiIiMigsJAlIiIiIiIig8JCloiIiIiIiAyOIRaommIhS0REREREZGTYI0tEREREREQGhYUsERERERERGRQWskRERERERGRQWMgSERERERGRQWEhS0RERERERAaFhSwREREREREZFBayREREREREZFCMvZCV6joAXTp16hT27dun6zDoLdq8eTMuX76s6zDoHcPrjoiIiN62/EJW05eheacL2XXr1mHx4sVa71enTh1YWFiUfEAG6Pr16zA1NYVEIkGVKlXe+vETExNhYWGBli1barT9tGnTsHv37lKJJTY2FpMnT0a1atWwcOHCUjmGNqKioiCXy2Fubq7rUIyOPl13p0+fRmBgIBQKBRo1aoQbN26UynGIiIjIsLCQfcmiRYtQoUIFmJqawsfHB1WqVMHhw4fx008/QSqVwtXVFU+ePAEA1K5dGxKJBBYWFkhISAAAXL16FcHBwbCwsICHhwdmzJgBlUoF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",
      "text/plain": [
       "<Figure size 700x600 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "circuit = Circuit(3)\n",
    "circuit.hadamard(0)\n",
    "circuit.cnot(0,1)\n",
    "circuit.cnot(1,2)\n",
    "circuit.reset_qubit(1)\n",
    "circuit.execute()\n",
    "circuit.measure()\n",
    "state_as_string = circuit.get_classical_state_as_string()\n",
    "print(f'Measured state {state_as_string}')\n",
    "QuantumUtil.show_all_probabilities(circuit)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "Now, we run this circuit $1000$ times and create a histogram showing the occurrences of measured classical states. \n",
    "The states $|000\\rangle$ and $|101\\rangle$ should each occur about $500$ times."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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9u3dHrdmzRojyXqeTp8+bXbt2mUiIiLMvHnzrHGFhYXmm2++MfHx8eaOO+4w4eHhZtasWWbNmjVmyJAh5quvvnJr3OHDh03t2rVNp06dTFpamtmyZYt54403TEhIiPnTn/5kbTcnJ8ckJiYaSaZfv35mw4YN5rXXXjMOh8MsXbrUGnfs2DETFRVlbrrpJvPee++ZLVu2mJkzZ5qAgACX1++pU6dM48aNTYsWLcz7779v0tPTzdtvv22io6NN69atXX52DRs2NF27djXr1683//nPf8wjjzxi1eGuoqIic/vtt5ugoCAzY8YM8+WXX5r33nvPNG7c2ISFhZmDBw9aYy8cY/Hx8ebxxx+3XltHjx4t1XY7d+5sQkNDzauvvmo2b95s3n//fVOvXj2XY/hi0dHRLj///7Vnzx5Tv359M378eLNp0yazaNEiU6tWLTN06FCXcVOnTjVhYWHmgw8+MJs3bzavvfaaCQ0NNRf/mVi4cKHx9/c38+bNM1u2bDHz58830dHRRpI5cOCAy9gLr8+JEyea6OjoS9ZX0te+McZ07tzZPPjgg+bjjz8269evN3/84x9NZGSkKSgouOTcq1evLla/u86ePWsCAwNN//79zaZNm8yKFStM9+7djSTz/PPPW+Meeugh4+XlZSQZh8NhPD09jaenp/H29jYLFy50mXPu3LmmZcuW5u9//7vZsmWLmTFjRrFjZPTo0aZKlSrG4XC4zOfl5WVefPFFl/n69OljwsLCzOuvv242b95sli1bZm677TZTs2ZNl5/JgAEDzI033miWL19uNm7caCZPnmz8/f3N9ddff0XPUWVGyLlGXAg5xhhz++23m8mTJxtjXEOOMb9+UF/8C7J9+/Zm3Lhx1txVq1Y158+fNz///LORZNLT040xv4QcSWbNmjUu87344ovG09PTZGRkGGOMady4sXn66aeLbXfw4MEmKCjInD171qU9OjraREdHm0OHDrn1PFyscePGpn379sbpdLq0T5061Xh4eJh9+/a5tJfFLz13thsXF2fuuuuuYo8fPny46dWrl3W/pOP279/vEnIu+LU/cu3btzfBwcFm+/btv7k/lxs3cOBAEx8fb86fP+/SvmTJEiPJbNmyxWrr27evadasmctz06lTJ/PMM89Y95988kkTHh5usrOzXeZLS0szkZGR1v0XXnjB1KlTx5w+fdpl3LZt24wk8/7771ttERERZvLkyebnn3+22l577TWXkF1S77//vpFkVq1a5dKenZ1tateu7XLMXfC/x1RpffDBB0aS2bhxo0v7gQMHTJ06dcyOHTsu+bjfCjmX8re//c20aNHCpW3UqFGmVatW5tixY9bP7ttvvzXdu3d3Gff3v//dREdHm/3795uioiJjjDGZmZmmS5cu5syZM5fc3rx583415JT0tX8phw4dMpLMf//730v2l8Xx/vPPP5sqVaqYd955xyVMjRw50vz73/+27v/000+XDLu7d+8u9vvvUjp16mSGDBli3c/NzTU7d+40iYmJJjEx0Zpv165dLq/xLVu2GIfDYbZt2+YyX35+vgkPDzcDBw602pKSkkxiYqL1n1hjjFm/fr35y1/+4tZzci3h7apr0MyZM/Xiiy/q+PHjZTLfhStBPD095e/vL0kup51DQ0PVvn17l8f07NlTRUVF2rRpk06cOKE9e/Zo1qxZ8vLycrm9+uqrys3NVU5OTrHtjhkzRlFRUaWu+8J2+/TpU+w96379+snpdGrdunWlnv9Kt/vTTz9p165deuCBB4rNMXXqVC1cuFCSSjyutJ588kk1bdr0isatXbtWX331lXx8fFx+vj179pQkHThwwGV8kyZNXJ6bqKgoZWdnW/dXr16tu+66S9WrV3d5XNeuXXX48GGX7R45ckRBQUEu242Pjy+23Tlz5mj27NkKCAiQp6enatWqpSVLllhj3bF27VpFRUWpY8eOLu3Vq1dXYmKivvjiC7fnLInVq1crOjparVu3dmmPjo5WRkaGmjRp4vacP/30k55++mk1aNBAVatWVc2aNfX222/rxIkTLuOGDBmi0NBQRUZGytPTU9WqVVP37t112223uYx76KGH1LZtW91www3W74w2bdqoWbNm8vb2drs2d1778+bN0y233KIaNWqoatWq6tq1qyQV25ey5O/vr7///e8aNmyYfH19VaVKFdWuXVu7d+9Wo0aNrHGhoaGKi4tTQECAatWqpbi4OMXFxalx48bF1kz997//1f3336/rrrtO/v7+uu6667R7926X/QgMDFRcXJyCg4MVHBxszRcbG2v9npZ+ea0aYxQfH+9yjFStWlVZWVkux8iECRN0/PhxhYaGysPDQ8HBwXryySeL/X63ExYeX4Pi4uKUlJSksWPHlmi8ucz7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GT9+vFm5cqVZt26d6datmwkICLji9ZGVFSHnGrBq1SrjcDiMJCPJWll//vx507x5c/PEE0+4jP/ss89MbGys8ff3N82bNzeLFi0yAQEBxsPDw6xatcp07tzZmmvUqFFm2bJlxsPDw3To0MEYY0zdunWNl5eXmThxopFkfH19TWpqqqlXr56pUqWKqVevnnn11VeL1fnBBx+Y+Ph44+PjY0JDQ03r1q3N9OnTXX7Z33DDDda2//f2v4vj3LVhwwbTuXNnU61aNePj42OaNWtmZs+e7TJm586dpkqVKsW26+npWWyRZ1lu1xhjNm7caO644w4TEBBggoODTadOnczixYtLPe6rr74yCQkJxt/f3zRq1MikpKSYxo0bG0nm7bffNsYYl5/x/966dOniMldJxxnzy2LfLl26mGrVqpmAgAATFxdnhg0b5vKH8i9/+Ys1x4Xw/ec//9lq6927tzU2IyPDJCcnm9DQUOPn52eaNWtmZsyYUexKmR9++MHcf//9JiQkxPj5+Zkbb7zRPP744+brr792GdegQQPTo0cP06hRI+Pn52eFfXev2LsgPz/fPPfcc9bxUKNGDdO7d+9i8z344IMlfg5LoqCgwIwePdpER0cbb29vU7duXTN06FBz7Ngxl3EXrmK71O21116zxm3evNkkJCQYPz8/c91115mkpCTz4YcfGi8vL+Pt7W394R8zZoxp27atadeunfVcN2/e3CW4GGPMnDlzTPPmzc2dd95patasaXx8fEzDhg3Nm2++6TLujTfe+NX6/P39XRYpl+S1f/r0adOvXz9TvXp1U716ddOmTRuzZMkS06xZMyPJChHHjh0zPj4+l9yuj4+P2+EzJyfHREREmJ49e5r69esbHx8fExYWZvr3729++umnS45/4IEHTGBgoAkICDAJCQlmypQpLovs3377bVOvXj3r9Tx8+HDrP5R169Z1me/s2bPm8ccft46Tm266yTz33HMuYejnn382Q4cONVFRUcbb29tER0ebHj16mKVLl7r8J65Pnz6mc+fO5uabbzaBgYGmatWqpk2bNsUuLLEThzHlsGADAACggrEmBwAA2BIhBwAA2BIhBwAA2BIhBwAA2BIhBwAA2BIhBwAA2NLv9msdnE6njh49qmrVqlXYx7cDAAD3GGN06tQpRUREFPsqi4v9bkPO0aNHr+jLIQEAQMXJyMhQnTp1fnPM7zbkVKtWTdIvT1JgYGAFVwMAAEoiLy9PUVFR1t/x3/K7DTkX3qIKDAwk5AAAcI0pyVITFh4DAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABb8qroAuzq+hHLK7oEoNI6MPWPFV0CgN8BzuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbIuQAAABbqrCQk5aWJk9PTzkcDjkcDnl7e+urr76y+k+fPq3u3bvL399fXbp0UW5ubrE5UlJSFBoaqpiYGK1atepqlg8AACq5Cgs52dnZeuihh3Tu3DmdO3dOBQUFatmypdU/YcIEOZ1OHT58WEFBQRo1apTL43fv3q3Ro0dr7dq1mjlzpnr16qX8/PyrvRsAAKCSqtC3qxwOh7y8vOTl5SUPj/9fitPpVGpqqoYNG6aQkBANHz5cCxYsUGFhoTUmNTVV9913n2JjY5WYmKjIyEilpaVVxG4AAIBKqFKuyTl8+LAyMzOtMztNmzZVfn6+vv/+e2tMenq6y5mfhIQEpaen/+qchYWFysvLc7kBAAD7qrCQ43A4tGHDBsXHx6tx48YaO3aszp07J0nKysqSr6+v/Pz8rLHVq1dXZmam9fisrCyFhIRY90NDQ136LzZlyhQFBQVZt6ioqHLaMwAAUBlUWMiJjY1V79699e677yolJUXvvvuuJk6cKOmXUHMxp9Pp0n7xmIv7LzZy5Ejl5uZat4yMjDLaEwAAUBlV2LeQx8fHKz4+XpLUsGFDjR8/XhMnTtT48eMVFhamgoIC5efny8/PT8YY5eTkKCwszHp8WFiYsrOzrfvZ2dku/Rfz8fGRj49P+e0QAACoVCrNmhwfHx9r8XFkZKTCw8O1detWSdKOHTvk7++vBg0aWOPj4+OtfumXNToJCQlXt2gAAFBpVVjImTt3rlatWqXTp09r+/btGj9+vHr37v1LUR4eSk5O1vTp03Xy5ElNmzZNSUlJLmdikpOTtWTJEu3Zs0dpaWk6cuSIunXrVlG7AwAAKpkKe7uqqKhIAwcO1P79+xUWFqb+/ftrxIgRVv/YsWPVu3dvRUREqEOHDkpJSXF5fFxcnCZMmKC2bdsqMDBQCxculK+v79XeDQAAUEk5jDGmoouoCHl5eQoKClJubq4CAwPLfP7rRywv8zkBuzgw9Y8VXQKAa5Q7f78rzZocAACAskTIAQAAtkTIAQAAtkTIAQAAtlRhV1cBwLWOCwyA31bRFxlwJgcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANgSIQcAANhSpQg5d911lx5++GGXttOnT6t79+7y9/dXly5dlJubW+xxKSkpCg0NVUxMjFatWnW1ygUAANeACg85mzZt0p49e7R//36X9gkTJsjpdOrw4cMKCgrSqFGjXPp3796t0aNHa+3atZo5c6Z69eql/Pz8q1k6AACoxCo85EycOFGDBg1yaXM6nUpNTdWwYcMUEhKi4cOHa8GCBSosLLTGpKam6r777lNsbKwSExMVGRmptLS0q10+AACopCo05Gzfvl15eXlKSEhwaT98+LAyMzPVsmVLSVLTpk2Vn5+v77//3hqTnp5u9UtSQkKC0tPTf3VbhYWFysvLc7kBAAD7qtCQM3HiRD3zzDPF2rOysuTr6ys/Pz9JksPhUPXq1ZWZmekyJiQkxLofGhrq0n+xKVOmKCgoyLpFRUWV4Z4AAIDKpsJCzjfffKP//ve/SkxMLNbncDiKtTmdTpf2i8dc3H+xkSNHKjc317plZGRcQfUAAKCy86qoDc+YMUNPPfWUPDz+f846ceKEQkNDFRYWpoKCAuXn58vPz0/GGOXk5CgsLMwaGxYWpuzsbOt+dna2S//FfHx85OPjUz47AwAAKp0KPZMzdOhQ+fr6qnPnzlq7dq3uvfdeSVJkZKTCw8O1detWSdKOHTvk7++vBg0aWI+Pj4+3+qVf1uhcvLYHAAD8flXYmZwPPvhAJ0+elCR9+eWXSklJ0eLFiyVJHh4eSk5O1vTp0xUXF6dp06YpKSnJ5UxMcnKy2rVrp6FDh2rv3r06cuSIunXrViH7AgAAKp8KO5MTFhamhg0bauXKlerfv7/S09M1cuRIq3/s2LEyxigiIkI5OTmaNGmSy+Pj4uI0YcIEtW3bVk899ZQWLlwoX1/fq70bAACgknIYY0xFF1ER8vLyFBQUpNzcXAUGBpb5/NePWF7mcwJ2cWDqHyu6hDLBcQ78tvI41t35+13hHwYIAABQHgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlgg5AADAlq445Hz44YdaunRpWdQCAABQZtwOOXXr1lVgYKBOnTql0aNHa/DgwXrkkUc0duzY8qgPAACgVNwOOTVr1tSYMWNUrVo1LV26VMuWLdOnn36quXPnlkd9AAAApeLl7gO+/fZb9evXT5L0008/KTIyUgEBAfrpp5/KujYAAIBSc/tMjq+vr5xOp5xOp/Ly8hQaGqq1a9eqXr165VEfAABAqbh9JqdHjx667777FBMTo7vuuksff/yxHn30UV1//fXlUB4AAEDpuB1yZs2apX/+858qKChQnz599NFHH+mxxx5TrVq1yqM+AACAUnE75Hh5ealv377W/QceeKBMCwIAACgLpfqcnMLCQi1atEgzZ86UJG3YsEHnz58vy7oAAACuiNtnco4cOaLbb79dp0+f1okTJ5ScnKxZs2apffv2GjhwYHnUCAAA4Da3z+QMHjxYnTp10sGDBxUcHKyioiIlJSVpwYIF5VEfAABAqbh9JmfNmjX67rvv5OnpabW1b99eDz/8cJkWBgAAcCXcPpMTEBCg3Nxcl7azZ8/Ky8vtvAQAAFBu3A45Xbt21aBBg5SXlyeHwyHpl8vKO3XqVObFAQAAlJbbp1+mTJminj17qnbt2jp37pyaNWumyMhIvokcAABUKm6HnGrVqunTTz/Vtm3btG/fPtWpU0cJCQny8CjV1egAAADlotQLaZo3b67mzZuXZS0AAABlxu3TL126dFGLFi30+OOPS5KOHTumHj166NSpU2VeHAAAQGm5HXICAwNVUFBghZzatWuroKBAkydPLvPiAAAASsvtkLNp0yYtWrRITZo0sdqmTp2qhQsXlmlhAAAAV8LtkJOdna3atWu7tEVFRSk7O7vMigIAALhSboecFi1aFPsKh/fee0/NmjUrq5oAAACumNtXV7300kvq2LGjNm3apLi4OO3YsUPLly/X6tWry6M+AACAUnH7TE58fLy2bdum0NBQrV+/XrVq1dK2bdvUsmXL8qgPAACgVEr1OTn169fXK6+84tJmjLG+5gEAAKCilfrDALOyslRYWChJcjqduvXWW3X06NEyKwwAAOBKuB1yPvnkE/Xr10+S5OfnZ7VnZWWVWVEAAABXyu2QM3DgQM2YMUMPPvigS/v9999fZkUBAABcKbcXHufl5enuu+8u1v7++++XSUEAAABlwe2Qc//991/yKxx69uxZJgUBAACUBbffrlqxYoUOHjyoOXPmKDg4WNIvV1YdOnSorGsDAAAoNbdDzpkzZ7R//36XNqfTqdatW5dZUQAAAFfK7ZCTmZl5yc/DyczMLJOCAAAAyoLba3IcDocKCwu1aNEizZw5U5K0YcMGnT9/3q15ioqKNHbsWEVERCgkJESDBg1ymeP06dPq3r27/P391aVLF+Xm5habIyUlRaGhoYqJidGqVavc3RUAAGBjboecI0eOqGnTpnrmmWc0cuRInThxQrNmzdLf//53t+bZt2+f9u/fr//85z/asmWLli1bptdff93qnzBhgpxOpw4fPqygoCCNGjXK5fG7d+/W6NGjtXbtWs2cOVO9evVSfn6+u7sDAABsyu2QM3jwYHXq1EkHDx5UcHCwioqKlJSUVOybyS/nhhtu0DvvvKNGjRqpfv366tmzpzZv3izplzU+qampGjZsmEJCQjR8+HAtWLDA+oRlSUpNTdV9992n2NhYJSYmKjIyUmlpae7uDgAAsCm3Q86aNWs0YcIEeXp6Wm3t27fXnj17Sl3EuXPntGnTJrVq1UqSdPjwYWVmZlpf+tm0aVPl5+fr+++/tx6Tnp7u8qWgCQkJSk9P/9VtFBYWKi8vz+UGAADsy+2QExAQUGx9zNmzZ+XlVbqvwXrnnXd03XXXydPTU0899ZSkX74iwtfX1/raCIfDoerVq7ssbs7KylJISIh1PzQ09DcXP0+ZMkVBQUHWLSoqqlT1AgCAa4PbIadr164aNGiQ8vLyrKusZs2apU6dOpWqgM6dO+vll1/Wvn37NGnSJEm65NVbTqfTpf3iMRf3X2zkyJHKzc21bhkZGaWqFwAAXBvcPv0yZcoU9ezZU7Vr19a5c+fUrFkzRUZGaunSpaUqICwsTA8++KDOnz+vsWPHauzYsQoLC1NBQYHy8/Pl5+cnY4xycnIUFhbm8rjs7GzrfnZ2tkv/xXx8fOTj41OqGgEAwLXH7ZBTrVo1ffrpp9q+fbv27t2rOnXqKCEhQR4ebp8UcuHv72+FkMjISIWHh2vr1q267bbbtGPHDvn7+6tBgwbW+Pj4eG3dutW6n56eXuwKLAAA8Pvldsg5efKkgoOD1axZMzVr1qzUGx4/frz8/PzUt29fnTp1SpMnT1avXr0kSR4eHkpOTtb06dMVFxenadOmKSkpyeVMTHJystq1a6ehQ4dq7969OnLkiLp161bqegAAgL24ffqlffv2+uCDD654w/fcc48+/vhj1a1bV+3atdOdd96p5557zuofO3asjDGKiIhQTk6OtV7ngri4OE2YMEFt27bVU089pYULF8rX1/eK6wIAAPbgMMYYdx4QGBioffv2qWbNmi7tycnJeuedd8q0uPKUl5enoKAg5ebmKjAwsMznv37E8jKfE7CLA1P/WNEllAmOc+C3lcex7s7fb7fP5HTp0kVr1651aSsqKnL7wwABAADKk9trcl555RXdc889CgsLU9u2bcujJgAAgCvmdsiJiYlRQUGB2rVrZ30ujTHmNz+jBgAA4GpzO+QUFBTI6XS6tJ0/f17e3t5lVhQAAMCVcntNzpIlS4q1eXl5qV+/fmVRDwAAQJlwO+QkJiZesn3u3LlXXAwAAEBZcTvkDB06tNjVVQAAAJWN2yFnzpw5Cg0NLda+cuXKMikIAACgLLgdcurWrSsvL9f1yk6nU3/4wx/KrCgAAIAr5XbImTJlih5//HEVFBRYbcaYYldcAQAAVCS3LyFPS0vTwYMHlZCQoPj4eEm/nMnhc3IAAEBl4nbIefPNN/WPf/xDHh7//yRQUVHRNfW9VQAAwP7cDjn33nuvHn74YZc2Y4yefvrpsqoJAADgirm9Jmfx4sXF2hwOhzIzM8ukIAAAgLLgdsj5NfPnzy+rqQAAAK6Y229XPfPMM8rNzXVpM8YoNTVVAwcOLLPCAAAAroTbIeeVV17R3LlzraupsrOzNXPmTD3zzDNlXhwAAEBpuR1yunfvXuzLOG+77TYWHgMAgErF7TU5H374YbG2evXqaceOHWVSEAAAQFlw+0zO1q1bdebMGet+fn6+5s2bp2bNmpVlXQAAAFfE7ZBz8803q3379jLGSJK8vb3VsGFDTZ8+vcyLAwAAKC23Q85TTz2lGTNmlEctAAAAZcbtNTkEHAAAcC1wO+R06dJFLVq00OOPPy5JOnbsmHr06KFTp06VeXEAAACl5XbICQwMVEFBgRVyateurYKCAk2ePLnMiwMAACgtt0POpk2btGjRIjVp0sRqmzp1qhYuXFimhQEAAFwJt0NOdna2ateu7dIWFRWl7OzsMisKAADgSrkdclq0aKEFCxa4tL333nt8Tg4AAKhU3L6E/KWXXlLHjh21adMmxcXFaceOHVq+fLlWr15dHvUBAACUittncuLj47Vt2zaFhoZq/fr1qlWrlrZt26aWLVuWR30AAACl4vaZHEmqX7++XnnllbKuBQAAoMy4fSZnypQpGjJkiGbPni1JysnJ0auvvlrmhQEAAFwJt0PO+vXrNWfOHFWpUkWS5OPjozfeeENvvfVWmRcHAABQWm6HnIMHD2rBggXq16+fJMnPz0+vvPKKUlJSyro2AACAUnM75Bw4cEAdOnRwaWvdurX27t1bVjUBAABcMbdDTt26dbV+/XqXts2bNysmJqbMigIAALhSbl9d9de//lX9+vXTpEmTFBsbq//+978aN26cXnrppfKoDwAAoFTcDjkPPfSQHA6HXnjhBe3bt0/16tXT9OnTlZSUVB71AQAAlEqpPiend+/e6t27d1nXAgAAUGZKFXIOHDigV155xTqTM3jwYF1//fVlXBoAAEDpub3wePv27WrSpImOHTumtm3b6vjx42ratKl27NhRHvUBAACUittncoYNG6axY8fq2WeftdpmzpypZ599Vp9//nmZFgcAAFBabp/J+eqrr9S/f3+Xtj59+mjr1q1lVhQAAMCVcjvkBAYG6sSJEy5tJ06cUGBgYJkVBQAAcKXcDjldu3bVoEGDlJubK0nKy8vT4MGDde+995Z1bQAAAKXmdsiZPHmynE6nIiIi1LBhQ9WuXVtOp1OTJk0qj/oAAABKxe2Fx9WqVdNnn32mbdu2WZeQN2/evDxqAwAAKLVSfU6OJDVv3pxwAwAAKi23364CAAC4FhByAACALRFyAACALRFyAACALRFyAACALRFyAACALRFyAACALRFyAACALbkdcnr16qVPPvmkPGoBAAAoM26HnOXLl+vGG28s1v6Pf/zDrXkKCwv117/+VTVq1FB4eLgmT57s0n/69Gl1795d/v7+6tKli/WFoP8rJSVFoaGhiomJ0apVq9zbEQAAYGtuh5xmzZopOzvbpa2oqEiPPvqoW/NMmjRJK1eu1Pr167Vq1Sq9+uqrWrx4sdU/YcIEOZ1OHT58WEFBQRo1apTL43fv3q3Ro0dr7dq1mjlzpnr16qX8/Hx3dwcAANiU2yFnxowZevzxx/Xjjz+6tBtj3Jrn7rvv1pIlS9SwYUM1btxYDzzwgJYtWyZJcjqdSk1N1bBhwxQSEqLhw4drwYIFKiwstB6fmpqq++67T7GxsUpMTFRkZKTS0tLc3R0AAGBTbn9B57hx43T06FE1a9bMetvK6XTK4XC4NU/r1q1d7mdkZCgqKkqSdPjwYWVmZqply5aSpKZNmyo/P1/ff/+94uLiJEnp6en605/+ZD0+ISFB6enp6tWr1yW3V1hY6BKS8vLy3KoXAABcW9wOOZ988olWrVrlEmrOnz+vzp07l7qIrVu3aunSpfr6668lSVlZWfL19ZWfn58kyeFwqHr16srMzLRCTlZWlkJCQqw5QkNDlZGR8avbmDJlisaPH1/qGgEAwLXF7ZDz9NNPq0OHDsXao6OjS1VAdna2HnzwQQ0dOlSxsbGSdMmzQhefLbp4zOXOJo0cOVJDhgyx7ufl5VlnjgAAgP24HXJefvnlS7b/8MMPbm+8oKBAiYmJql+/viZMmGC1h4WFqaCgQPn5+fLz85MxRjk5OQoLC3MZ878LoLOzs136L+bj4yMfHx+3awQAANemEi88vv/++5WRkaFDhw5d8paVleXWhouKivTAAw+ooKBAixYtkqenp9UXGRmp8PBwbd26VZK0Y8cO+fv7q0GDBtaY+Ph4q1/6ZY1OQkKCWzUAAAD7KvGZnA8++EBbt251uYrqwttDhw4dUkBAwCU/y+bXjBkzRuvXr9eiRYt04MABZWVlad26dXr++efl4eGh5ORkTZ8+XXFxcZo2bZqSkpJczsQkJyerXbt2Gjp0qPbu3asjR46oW7duJd4+AACwtxKHHE9Pz2JvSa1cuVJjxozRrbfe6vJ2U0msWLFCJ06cUKdOnay2fv36Wf8eO3asevfurYiICHXo0EEpKSkuj4+Li9OECRPUtm1bBQYGauHChfL19XWrBgAAYF8lDjlbtmyx/r1582aNGjVKfn5+euutt9SkSRO3N7xt27bf7K9atao++uij3xzzxBNP6IknnnB72wAAwP5KHHKaN2+u3bt3a9SoUTpx4oSmTJmi2267zerv27ev3n777XIpEgAAwF0lXnj86KOP6uabb1b9+vU1efJkGWO0du1arV27VqtWrdK7775bnnUCAAC4pcRncubMmaP27dvr66+/tj60DwAAoLIqccjp3LmzPvnkk1/tv9z6GQAAgKupxG9X/VbAkaTExMQrLgYAAKCsuP0t5AAAANcCQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALAlQg4AALClCg05CxcuVI8ePRQeHl6s7/Tp0+revbv8/f3VpUsX5ebmFhuTkpKi0NBQxcTEaNWqVVejZAAAcI2osJBz/vx5LVu2TA0bNlRWVlax/gkTJsjpdOrw4cMKCgrSqFGjXPp3796t0aNHa+3atZo5c6Z69eql/Pz8q1U+AACo5Cos5Hh5eendd9/VX/7yl2J9TqdTqampGjZsmEJCQjR8+HAtWLBAhYWF1pjU1FTdd999io2NVWJioiIjI5WWlnY1dwEAAFRilXJNzuHDh5WZmamWLVtKkpo2bar8/Hx9//331pj09HSrX5ISEhKUnp7+q3MWFhYqLy/P5QYAAOyrUoacrKws+fr6ys/PT5LkcDhUvXp1ZWZmuowJCQmx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",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "result = QuantumUtil.run_circuit(circuit, nr_runs=1000)\n",
    "QuantumUtil.histogram_of_classical_states(result)"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "base",
   "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.9.7"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}