From af0afaa60f8efa98002eaa03d16f1763e8a166c3 Mon Sep 17 00:00:00 2001 From: Becky Dimock Date: Thu, 14 May 2026 11:40:13 -0500 Subject: [PATCH 1/9] Set up Box link --- scripts/config/api-html-artifacts.json | 1 + 1 file changed, 1 insertion(+) diff --git a/scripts/config/api-html-artifacts.json b/scripts/config/api-html-artifacts.json index b4ef47fc1e6..9dae83389d6 100644 --- a/scripts/config/api-html-artifacts.json +++ b/scripts/config/api-html-artifacts.json @@ -90,6 +90,7 @@ "0.3": "https://ibm.box.com/shared/static/qiskfdazhq1dpxcl9b627x9yi60gncb4.zip" }, "qiskit-addon-aqc-tensor": { + "0.3": "https://ibm.box.com/shared/static/uzw1mzmypuqf2one830vdrvy27x2brvu.zip", "0.2": "https://ibm.box.com/shared/static/dhuyxtri674xvb3oky5rg019bd1a44hf.zip", "0.1": "https://ibm.box.com/shared/static/jnxlji7b6cguhbvp1txdi2vhym38wcnc.zip" }, From 4783629dd5feaf6abbb9013f43a3e856b9bbdbf3 Mon Sep 17 00:00:00 2001 From: Becky Dimock Date: Wed, 3 Jun 2026 12:15:29 -0500 Subject: [PATCH 2/9] Restore old info --- ...assical-feedforward-and-control-flow.ipynb | 238 ++++++++++++++++-- 1 file changed, 216 insertions(+), 22 deletions(-) diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 0d2eb4eeaf6..df7338385b8 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -2,7 +2,6 @@ "cells": [ { "cell_type": "markdown", - "id": "943cf52c-41c8-4a2b-bf1d-6df8a90a6353", "metadata": {}, "source": [ "---\n", @@ -16,7 +15,6 @@ }, { "cell_type": "markdown", - "id": "b1d96290-2e64-43aa-bae9-c74b8529894d", "metadata": { "tags": [ "version-info" @@ -45,7 +43,6 @@ }, { "cell_type": "markdown", - "id": "85a4d698-ee2a-4b3d-9331-1b91eea49338", "metadata": {}, "source": [ "Dynamic circuits are powerful tools with which you can measure qubits in the middle of a quantum circuit execution and then perform classical logic operations within the circuit, based on the outcome of those mid-circuit measurements. This process is also known as _classical feedforward_. While these are early days of understanding how best to take advantage of dynamic circuits, the quantum research community has already identified a number of use cases, such as the following:\n", @@ -57,9 +54,21 @@ }, { "cell_type": "markdown", - "id": "5d846edf-fc09-4808-bd62-3a8cfdcc1585", "metadata": {}, "source": [ + "This guide demonstrates the functionality available in the Qiskit SDK for performing classical feedforward and control flow. These features are sometimes referred to collectively as \"dynamic circuits.\" Classical feedforward refers to the ability to measure qubits in the middle of a circuit and perform additional quantum operations that depend on the measurement outcome. Qiskit supports four control flow constructs for classical feedforward, each implemented as a method on [`QuantumCircuit`](../api/qiskit/qiskit.circuit.QuantumCircuit). The constructs and their corresponding methods are:\n", + "\n", + "- If statement - [`QuantumCircuit.if_test`](../api/qiskit/qiskit.circuit.QuantumCircuit#if_test)\n", + "- Switch statement - [`QuantumCircuit.switch`](../api/qiskit/qiskit.circuit.QuantumCircuit#switch)\n", + "- For loop - [`QuantumCircuit.for_loop`](../api/qiskit/qiskit.circuit.QuantumCircuit#for_loop)\n", + "- While loop - [`QuantumCircuit.while_loop`](../api/qiskit/qiskit.circuit.QuantumCircuit#while_loop)\n", + "\n", + "Each of these methods returns a [context manager](https://docs.python.org/3/reference/datamodel.html#with-statement-context-managers) and is typically used in a `with` statement. In the rest of this guide, we will explain each of these constructs and how to use them.\n", + "\n", + "\n", + " There are some limitations of classical feedforward and control flow operations on quantum hardware that might impact your program. For more information, see [Hardware considerations and limitations for classical feedforward and control flow](./dynamic-circuits-considerations).\n", + "\n", + "\n", "## `if` statement\n", "\n", "The `if` statement is used to conditionally perform operations based on the value of a classical bit or register.\n", @@ -70,13 +79,13 @@ { "cell_type": "code", "execution_count": 1, - "id": "60924bfa-50ed-4d9d-a17b-9d64f2cc053f", "metadata": {}, "outputs": [ { "data": { + "image/png": "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", "text/plain": [ - "\"Output" + "
" ] }, "execution_count": 1, @@ -105,7 +114,6 @@ }, { "cell_type": "markdown", - "id": "bef3f447-7282-4de9-9410-6b671e9902c3", "metadata": {}, "source": [ "The `with` statement can be given an assignment target which is itself a context manager that can be stored and subsequently used to create an else block, which is executed whenever the contents of the `if` block are *not* executed.\n", @@ -116,13 +124,13 @@ { "cell_type": "code", "execution_count": 2, - "id": "20f0640a-a3f7-41b3-aada-b66bc89b0555", "metadata": {}, "outputs": [ { "data": { + "image/png": "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", "text/plain": [ - "\"Output" + "
" ] }, "execution_count": 2, @@ -152,7 +160,6 @@ }, { "cell_type": "markdown", - "id": "f0f00f48-a1f2-40cc-b5f5-9a122d8dd24e", "metadata": {}, "source": [ "In addition to conditioning on a single classical bit, it's also possible to condition on the value of a classical register composed of multiple bits.\n", @@ -163,13 +170,13 @@ { "cell_type": "code", "execution_count": 3, - "id": "98e8f552-4169-42a3-8182-e14e9ffb59e2", "metadata": {}, "outputs": [ { "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAgEAAAEvCAYAAADcqBK6AAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjksIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvJkbTWQAAAAlwSFlzAAAPYQAAD2EBqD+naQAANTFJREFUeJzt3XlclOX+P/7XzQyDsqkICkiIQChogoGmkCblgqapmFppbqWZxyxN0TbPUokm9av42TmY4TFLDyZqJqR+EDXCTFzzuBGyJMtkKIrszsz9/YOYIzKDzDAwMPfr+Xj4kHt/jwjzmuu+7usSRFEUQURERJJjZe4CiIiIyDwYAoiIiCSKIYCIiEiiGAKIiIgkiiGAiIhIohgCiIiIJIohgIiISKIYAoiIiCSKIYCIiEiiGAKIiIgkiiGAiIhIohgCiIiIJIohgIiISKIYAoiIiCSKIYCIiEiiGAKIiIgkiiGAiIhIohgCiIiIJIohgIiISKIYAoiIiCSKIYCIiEiiGAKIiIgkiiGAiIhIohgCiIiIJIohgIiISKIYAoiIiCSKIYCIiEiiGAKIiIgkiiGAiIhIohgCiIiIJIohgIiISKIYAoiIiCSKIYCIiEiiGAKIiIgkiiGAiIhIohgCiIiIJIohgIiISKLk5i6ATEsURaC62txlGMbGBoIgmORUoihCrVab5FytRSaTmez1ExEZgiHA0lRXQzV1lrmrMIh8+2agQweTnEutViMxMdEk52otkydPhlzOH0Uian28HUBERCRRDAFEREQSxRBAREQkUQwBREREEsUQQEREJFEMAURERBLFEEBERCRRDAFEREQSxRBAREQkUQwBREREEsUQQNTCNBqNuUsgItKJA5bfRRRFHD16FHv27EFaWhouXbqE27dvw8nJCQMHDsT8+fPx1FNPmbtMaiU3b95ETk4OfvvtN1RVVQEAFAoFevToAW9vb3Tt2vW+E/+UlpZizZo1GDduHEJDQ1ujbCKiJmMIuEtqaipGjBgBABAEAT4+PvD29kZWVhaSkpKQlJSEuXPnYuPGjZz1zUKVlJQgNTUVR44cwbVr1xrdt1OnTggLC8PIkSPh5ubWYHtpaSnef/995OXlITY2FnK5HIMGDWqp0omIDMYQcBdRFOHt7Y0lS5bgmWeegbOzM4DameliY2OxdOlSxMfHIzg4GAsXLjRztWRKpaWl2LJlC44ePdrkqYhv3bqF5ORkJCcnY8CAAZg1axZcXV2156sLAADQuXNneHh4tFj9RETGEERRFM1dRFtRWlqKjh07wtraWuf2BQsWIC4uDoGBgThz5kzrFtdEYlWVSaYSPlJ8DSN/Oow1Af2x1KePzn0U323H2G5u2P3I0GZdS759MwQTTSWsUqkMnkr42LFjiI+PR2lpqXadIAjo3bs3fHx80KtXLzg6OkIQBJSXlyM3NxfZ2dm4ePEi7ty5oz3GxsYGzz77LAYPHozo6GhtAOjSpQveeecduLu767w+pxImInOx+N88xcXF+OCDD7Bz507k5+fDxcUFkZGRWL16NRYvXoz4+HjExsZi0aJFcHR0bPRco0ePRlxcHC5fvtxK1VNLEkURX331FZKSkrTr7OzsMGrUKDzxxBPalqB7DR48GEBtaDxy5Aj27duH69evo7q6Gv/+97+xfft2VFRUALh/ACAiMieLDgFnzpzBmDFjoFQqYWdnh4CAABQWFuLTTz/FlStXcOPGDQBAUFBQk85X1znM1ta2pUqmViKKIjZt2oQDBw5o1w0cOBAvvPACOnfu3KRzODo6Yvz48Rg5ciS2bt2qPVddAOjcuTMDABG1aRb7iGBxcTHGjx8PpVKJ119/HUVFRTh16hSUSiXWrl2LpKQkZGRkQBAE9O/fv0nnTEhIAAAMHdq85m8yv71792rftAVBwIsvvoilS5c2OQDcrUOHDnj66afRrVu3euv79OnDAEBEbZrFhoDFixcjPz8fixYtQkxMDBwcHLTboqKiEBgYCJVKBS8vr/veBgCA5ORkfPvtt9rjpaJCrUZxdbXOP+3V1atXtYEOAF5++WWMGDHC6Cc+6joB3vs0wbFjx3D69Olm1UpE1JIsMgRcvHgRCQkJcHZ2RnR0tM59goODAQCBgYH3Pd+VK1fw/PPPA6gNF7qe987JycFTTz0FBwcHdOnSBTNnzsT169eb8Srahn9cPg/3A9/q/NMeqdVq/POf/4RKpQIAjB8/HsOGDTP6fPc+BdClSxdMnTpVu33Dhg0oLy9vXtFERC3EIvsEbNu2DRqNBtOnT4e9vb3OfTp27Ajg/iFAqVQiIiICN27cwKhRoxATE9Ngn9u3byM8PBxOTk7Ytm0bKisrERUVhXHjxiE9PR1WVsZlrZCQECiVSoOO6WhlhQtBQ4y6ni4venpjsvsDOreNOXbEJNfw8/NDpYlG1VMoFHqDHwBkZGQgOzsbAODu7o4pU6YYfS1dAeCdd96Bm5sbLl++jLNnz6KkpAQHDhzApEmT9J7Hz88PNTU1RtdBRNLm6uqKEydOGHWsRYaA1NRUAEB4eLjeffLz8wE0HgLq3vizsrIQFhaGXbt26Xx8cMOGDSgoKMAPP/wAT09PAICHhwdCQ0OxZ88eTJw40ajXoVQqUVBQYNAxtjIZEGTU5XTytbfHEy7dTXdCHQoLC1HRxGfz78fGxqbR7Xd3BJw1axYUCoVR19EXAOr6AMyZMwdLliyBKIpISUnBhAkT9IbBwsJCVLfj2ytE1H5ZZAio+8Xcs2dPndtVKhXS09MB6A8BpaWliIiIwLlz5/Dwww8jKSlJ71MBe/fuxaOPPqoNAAAwZMgQeHt747vvvjM6BNQNPGOIjka2OpiTu7u7SVsC9CkoKMCFCxe012xqh9B73S8AALXfu6CgIJw+fRrXr1/HqVOnEBISovN87u7ubAkgIqMZ815RxyJDQN092MrKSp3bExISUFxcDAcHB/Tq1avB9oqKCowbNw4ZGRnw9/fH/v370alTJ73Xu3Dhgs5m5b59+2rfdIxhTPOOqQYLak2ZmZmtMljQ2bNntV8//vjjRnUEbEoAqPPEE09oOwb+8ssvekNAZmYmBwsiIrNofx8bm6AuFZ06darBtqKiIixfvhwA0L9//wZvBDU1NZg0aRLS0tLg4+ODlJQUvYPG1CkpKdH5aJmTk5N2LAIyv5ycHO3X/v7+Bh9vSAC49xp3X5uIqK2wyBBQNwnQ2rVrkZmZqV2fkZGB8PBwFBcXA2g4SJBarcZzzz2HAwcOwMPDAykpKXzO24LUvRHLZLJ6t26awtAAANSOPti9e21/itzc3CbPSUBE1Fossg0yKioKW7duxdWrV9G3b1/06dMHVVVVyMrKwpgxY+Dl5YX9+/c36A+wfft2bVOyQqHAjBkz9F5jx44d2haHLl264ObNmw32uXHjBpycnEz3wqhZSkpKAAAuLi5654fQxZgAUMfd3R2///477ty5g/Ly8iaNSUFE1FosMgR4eHggLS0Ny5cvx5EjR5Cbm4uAgADExcVh3rx58PHxAdCwU+DdPbSzs7O1j5LpUjeEMFDb7Kvr3v+FCxea9Qy6OT3m3A0146c2us/9trc1EydORGVlJezs7Aw6bvPmzUYFAKB2ngEvLy8oFAqjn0QgImopkptFsKysTDsj3O3bt00yD0BMTAzefPNNZGdna6eL/fnnnzF48GDs3Lmz0WfETa09dgw09yyC91NaWor33nsPt2/fbpG5ADiLIBGZi+R+85w/fx6iKMLPz89kEwHNnz8fsbGxmDBhAv7+97+jqqoKUVFRGDRoECZMmGCSa5D5ODo64u2330Z5eTnc3NzMXQ4RkclYZMfAxpw7dw5A04YLbipHR0ekpqbCzc0NzzzzDF588UWEhoZi7969Ro8WSG2Lo6MjAwARWRzJtQS0RAgAAB8fH+zdu9ek5yQiImpJkvuY2lIhgIiIqL2RXEtA3bwCREREUie5lgAiIiKqxRBAREQkUQwBREREEsUQQEREJFEMAURERBLFEEBERCRRDAFEREQSxRBAREQkUQwBREREEiW5qYQtnSiKQHW1ucswjI0NBEEwyalEUYRarTbJuQBgXVwCbpeXw8HODstfmtZg2RRkMpnJXj8RkSEkN2ywpRMEAejQwdxlmI0gCJDLTfffWgSgEWv/lsvlDZaJiNoz3g4gIiKSKIYAIiIiiWIIICIikiiGACIiIoliCCAiIpIohgAiIiKJYgggIiKSKIYAIiIiiWIIICIikiiGACIiIoliCCAiIpIohgAiIiKJYgggIiKSKIYAIiIiiWIIICIikiiGACIiIoliCCAiIpIohgAiIiKJkpu7ADItURSB6mpzl2EYGxsIgmDuKiyGKIpQq9XmLqPJZDIZv/9EZsIQYGmqq6GaOsvcVRhEvn0z0KGDucuwGGq1GomJieYuo8kmT54MuZy/iojMgbcDiIiIJIohgIiISKIYAoiIiCSKIYCIiEiiGAKIiIgkiiGAiIhIohgCiIiIJIohgIiISKIYAoiIiCSKIYCIiEiiGALuIooi0tPTsWLFCoSGhsLJyQnW1tbo3r07xo0bhz179pi7RKJWV11djT/++ANFRUUoLi5GTU2NQcfn5OTg2LFjLVQdETUHB+y+S2pqKkaMGAEAEAQBPj4+8Pb2RlZWFpKSkpCUlIS5c+di48aNnPCELFZNTQ2OHTuGc+fOIScnBwUFBbUTU/1JJpPBw8MDvXr1QlBQEEJCQvSO/Z+Tk4P33nsPFRUV0Gg0CA0Nba2XQURNwBBwF1EU4e3tjSVLluCZZ56Bs7MzgNoJWWJjY7F06VLEx8cjODgYCxcuNHO1RKZVUlKC5ORkHDp0CGVlZXr3U6vVyMvLQ15eHg4fPowuXbrg8ccfx5gxY2Bvb6/dry4AlJeXAwBSUlIwePBgWFmxAZKorWAIuMugQYNw6dIlWFtb11svk8nw2muv4dKlS4iLi8OGDRssPgQcKb6GkT8dxpqA/ljq00fnPorvtmNsNzfsfmRoK1dHpiSKItLS0rB582btG3YdmUyGBx54AK6urpDL5aipqUFRURHy8/O1rQMlJSVITExEamoqXnzxRQQHBzcIAL1790ZUVBQDAFEbY/EhoLi4GB988AF27tyJ/Px8uLi4IDIyEqtXr8bixYsRHx+P2NhYLFq0CI6Ojo2ea/To0YiLi8Ply5dbqXqillVVVYX169cjIyNDu04ul2Pw4MF4/PHH4evrC4VC0eC46upqXLp0CQcPHsSJEyeg0WhQUlKCdevWITg4GJcuXaoXAN544w104HTRRG2ORYeAM2fOYMyYMVAqlbCzs0NAQAAKCwvx6aef4sqVK7hx4wYAICgoqEnnq6qqAgDY2tq2VMlEraaiogLR0dH49ddftevCwsLw/PPPo3Pnzo0ea2Njg8DAQAQGBuKPP/5AfHw8Tp8+DQA4efKkdj8GAKK2zWLb5oqLizF+/HgolUq8/vrrKCoqwqlTp6BUKrF27VokJSUhIyMDgiCgf//+TTpnQkICAGDoUDZ/U/umUqkQExOjDQC2trZYunQpXnnllfsGgHu5uLggKioKkydPrrfe3t4eK1asYAAgasMsNgQsXrwY+fn5WLRoEWJiYuDg4KDdFhUVhcDAQKhUKnh5ed33NgAAJCcn49tvv9UeLxUVajWKq6t1/qH2a+fOnbhw4QKA2jfrVatWYdCgQUafLzc3F/v27au3rqysDD/++GOz6iSilmWRtwMuXryIhIQEODs7Izo6Wuc+wcHBOHv2LAIDA+97vitXruD5558HUBsu7n3MKT8/H2vWrMHx48dx9uxZ1NTU1Hukqj37x+Xz+Mfl8+Yug0woJycHu3fvBlDb8W/FihXw8vJq1vnu7gTo4eGB/Px8AMDXX3+NoKAgdOvWrbllE1ELsMgQsG3bNmg0GkyfPr3eI0t369ixIwDcNwQolUpERETgxo0bGDVqFGJiYhrsk5WVhcTERAwcOBAKhQLp6enNfxFtxIue3pjs/oDObWOOHWnlasgUvvjiC2g0GgDAxIkT8eCDDxp9Ll1PAbzxxhvYsmULDh48iOrqanz55ZdYtmyZSWonItOyyBCQmpoKAAgPD9e7T90nlcZCQN0bf1ZWFsLCwrBr164Gjw8CwLBhw1BUVAQA+Nvf/mayEBASEgKlUmnQMR2trHAhaIhJrg8Avvb2eMKlu8nOp4ufnx8q/3xTamsmzXkNdvaOKFIWwcPDo8FyW6RQKPS2gF25cgVZWVkAaj+xT5o0yejr6AsAHTp0wPTp03Hq1CmUlJTg5MmTuHbtmt7WAD8/P4NHISSi/3F1dcWJEyeMOtYiQ0BeXh4AoGfPnjq3q1Qq7Ru1vhBQWlqKiIgInDt3Dg8//DCSkpL0PhXQUs8+K5VKFBQUGHSMrUwGBLVIOS2msLAQFWq1ucvQSfNnXRq1GgUFBQ2W2yIbGxu92w4cOKD9euzYsXpH+rufxgIAUNvRcNSoUUhISIAoijh48CCeffZZnecqLCxENfuYEJmFRYaAul9MlZWVOrcnJCSguLgYDg4O6NWrV4PtFRUVGDduHDIyMuDv74/9+/ejU6dOLVqzLq6urgYf07EdDsbi7u7eZlsCrGQy7d89evRosNwW6XquH6gd6a9uDH87OzuEhYUZdf77BYA64eHh2LFjB9RqNdLT0/WGAHd3d7YEEDWDMe8VdSwyBLi6uqKkpASnTp3CkCH1m8aLioqwfPlyAED//v0bzAFQU1ODSZMmIS0tDT4+PkhJSdEOH9zajGneEauqoJo6qwWqaTmZmZkQ2uhjZKvXf43SsnK4ubohPz+/wXJbpFKpkJiY2GB9QUGB9hP3Qw891GiLgT5NDQAA0LlzZ/j5+eHixYsoLi5GaWmpzidxMjMzjW6RIKLmaX8fG5ugbhKgtWvXIjMzU7s+IyMD4eHhKC4uBtBwkCC1Wo3nnnsOBw4cgIeHB1JSUuDu7t5qdRO1pOzsbO3X3t7eBh9vSACoc3dL293XJ6K2wSLjd1RUFLZu3YqrV6+ib9++6NOnD6qqqpCVlYUxY8bAy8sL+/fvb9AfYPv27dpPUAqFAjNmzNB7jR07djSrCYaotRUWFmq/1tdfRh9jAgCAeo8eFhQUNHl0TiJqHRYZAjw8PJCWlobly5fjyJEjyM3NRUBAAOLi4jBv3jz4+PgAaNgp8O7OSdnZ2Y1+cqkbQthSPebcDTXjpza6z/22U9vSoUMHODs7486dO/UGz7qfvLw8owIAADg6OqJTp05QKBR6+yoQkflYZAgAAH9/f+zdu7fB+rKyMuTm5sLKygr9+vWrt2327NmYPXt2K1VI1LoiIyMRGRlp8HFdunRB165dUV5ebvBcAEFBQYiLizP4mkTUOiw2BOhz/vx5iKIIPz8/k04EtGPHDgDQDsVat+zl5YWQkBCTXYeotTk6OuLtt9/Gf/7zH8ycOZNzARBZEMmFgHPnzgG4/0iBhpoyZYrO5VmzZuHf//63Sa9F1NocHR0xf/58c5dBRCbGEGAiljJXABERSYdFPiLYmJYKAURERO2N5FoC6uYVICIikjrJtQQQERFRLYYAIiIiiWIIICIikiiGACIiIoliCCAiIpIohgAiIiKJYgggIiKSKIYAIiIiiWIIICIikiiGACIiIomS3LDBFs/GBvLtm81dhWFsbMxdgUWRyWSYPHmySc61Li4Bt8vL4WBnh+UvTdO7rjlkMlmzz0FExmEIsDCCIACc713SBEGAXG6aH20RgEas/bvunLrWEVH7xNsBREREEsUQQEREJFEMAURERBLFEEBERCRRDAFEREQSxRBAREQkUQwBREREEsUQQEREJFEMAURERBLFEEBERCRRHPOTiCyWqNFAzMwC8gsgllcAGo25S6KmsJZDsLOH4N8bgms3c1dj0RgCiMjiiAWF0Hz/f9CkHwOu3zB3OdQMgq83hLDBsBo7GkJHzotiagwBRGRRxJw8qN55Fyi9be5SyATErOzaPxmnIPvrGwwCJsY+AURkMRgALJd44RLUf4+GWFll7lIsClsCiMhiqD/7XHcAcHOF0M0Z4NTHbZ8IoKYGYt5V4Hb976V44RI03yVDNjXSPLVZIP5EEJFFEP8ohnj513rrhL7+kL38AgTPB8xUFRlLVKshnvkF6v9vfb1gp0k/xhBgQrwdQEQWQZN+rP4KezvIVq1kAGinBJkMVsEDIHt9cf0NOXkQCwrNU5QFYksAEVkE8cKlesvCIyGS7EQmiiIqKlXmLsMgth3lEARB5zahfz+gS2eg5KZ2nXj+EoQe7nrPJ4oi1Gq1iatsWTKZTO+/QUtiCCAiy1BWXm9R8O5lslMfOnQIb7zxBs6fP4+ysjJs2rQJs2fPNtn5TamiUgX7wV+auwyDlB2bCTtba53bBJkVBC9PiHeHgLKyRs+nVquRmJhoyhJb3OTJkyE3Q58VhgAisgw1NfUWBRuFwacYPnw4Tpw4gbK73mRKSkoQGRkJDw8PfPjhh7C1tUVoaGizyyUD2NjUX665Y546LBBDABFZKNM0rWZkZODmzZv44osvEBnJDmlmYYZmcqlgx0AiokYolUoAgJOTk5krITI9tgQQEenh5eWFvLw8AEB4eLh2vSiK5iqJyKQYAoiI9Pj444/x/fffY8OGDXjzzTfh7+9v7pKITIohgIhIj4kTJ+LmzZvYsGEDRo4cieHDh5u7JCKTYp8AIiIiiWIIICIikiiGACIiIoliCCAiIpIohoB7iKKI9PR0rFixAqGhoXBycoK1tTW6d++OcePGYc+ePeYukYiI2hGNRoPi4mJzl6ETnw64R2pqKkaMGAEAEAQBPj4+8Pb2RlZWFpKSkpCUlIS5c+di48aNZpnsgYiIWp5KpUJOTg6uXLmCnJwcXL9+HXfu3IFcLoejoyN69eoFb29v+Pj4oGPHjnrPo9Fo8MUXX+D48eNYtWoVHnigbc1qyRBwD1EU4e3tjSVLluCZZ56Bs7MzgNoJKWJjY7F06VLEx8cjODgYCxcuNHO1RERkSsXFxTh48CBSU1Nx69Ytvfv99NNPAAAbGxsMHToUI0eORM+ePevtUxcADh48CAB4//338fHHH6NDh7YzuyVvB9xj0KBBuHTpEhYtWqQNAEDtNI+vvfYa5s+fDwDYsGGDuUokohZy+PDhepMHAcDs2bMhiqIkxwh4f3EwxF9ewJyJD+rcfuiLsag6MRt9fbu0cmWmV11djS+//BKvvPIKdu3a1WgAuPe4lJQUrFixAh9++CFu3rwJoGEAEAQBM2fObFMBAJBIS0BxcTE++OAD7Ny5E/n5+XBxcUFkZCRWr16NxYsXIz4+HrGxsVi0aBEcHR0bPdfo0aMRFxeHy5cvt1L1RETm8bfPTmP8Y574aNkjOPBTAQp+r9Bue21GXwwf6IaVH2fgfFaJGatsvszMTHz22WfaeSKA2g9+wcHB6NevH3r16oUePXpAoVBApVLh2rVryM7ORmZmJo4ePYqqqioAtZNNXbx4EXPmzMGFCxfqBYBXXnmlTc4+afEh4MyZMxgzZgyUSiXs7OwQEBCAwsJCfPrpp7hy5Qpu3LgBAAgKCmrS+eq+2ba2ti1VMhFRm3BHpcGst3/Az189hS/+NhQRL+8HAPh5dcL7r4Tg2C/XsO7f58xcZfMcP34cn376KVQqFQDA2toa48aNw8iRI3VOGiWXy+Hp6QlPT08MHz4cM2bMQFpaGhITE1FaWoqysjLExsZq92/LAQCw8NsBxcXFGD9+PJRKJV5//XUUFRXh1KlTUCqVWLt2LZKSkpCRkQFBENC/f/8mnTMhIQEAMHTo0JYsnYioTTh98TqivziL0WEemDe5N6ysBHz5/jAIAjDr7R+g0bTfyZROnjyJjz/+WBsAHnzwQaxZswbTpk1r8qyRtra2GD16NGJiYvDII4/U29bWAwBg4S0BixcvRn5+PhYtWoSYmJh626KiorB161acPXsWvXr1uu9tAABITk7Gt99+qz2eiEgK3t1wGk8N90TM64MQ1KcrHnmoG5au+xmZuU27b94WFRYW4pNPPoFGowEADBs2DC+99BJkMplR57O3t4e9vX29daIoQqFQNLvWlmSxLQEXL15EQkICnJ2dER0drXOf4OBgAEBgYOB9z3flyhU8//zzAGrDxb3JbseOHZg8eTJ69uwJW1tb9OnTB2+99VaDTkZERO2NSiVi1ts/oIONDAun+SPtlBIff/Vfc5dlNI1Gg3/961+oqakBAISGhmLBggVGBwBdnQDrbNy4sU2/D1hsCNi2bRs0Gg2mT5/eIJ3VqXu2834hQKlUIiIiAjdu3MCoUaMatCoAQExMDGQyGVavXo3vv/8eL7/8Mv75z38iIiJCmzSJiNqrW2U1qK5RAwCS065CbL93AbBv3z5kZmYCALp374758+fDysq4t0NdAWDRokUYMGAAAODmzZv48ssvTVN4C7DY2wGpqakAgPDwcL375OfnA2g8BNS98WdlZSEsLAy7du2CtbV1g/2+++47uLi4aJcfe+wxuLi4YPr06fjxxx8xbNgwg19DSEhIvd6q1PomzXkNdvaOKFIWwcPDo8GypdP1etvqv8HO3v0xwM5Bu7xs+TJsn3vNjBWZhwbWgNPbJj/vpn8MhcJahgtXSvD2/CBs35+D7PzbJjn3g35+sMIdvds/69UbY7r875HtmJh1iF32qt79FQqF3hZglUqF7777DkDtG/aCBQuMfmxPVwCo6wPg7++PZcuWoaKiAmlpaZg6dWq9x87v5efnp22ZMJSrqytOnDhh1LEWGwLy8vIAoMHgDXVUKhXS09MB6A8BpaWliIiIwLlz5/Dwww8jKSlJ71MBdweAOiEhIQCAgoICg+sHalsgjD2WTEOjVmv/LigoaLBs6XS93rb6b1DTqw9g97/lkpKbbaq+ViMogKb1aWuyV54LQPggd7z56Ql8eygPpxImIv4fQzF8brJJzl9UWAiI+t8Aq9zq/x4vLb3d6PfWxsZG77aTJ0+ipKT2kcbg4GD4+/sbWG2txgIAADg5OWHMmDFITEyEKIo4ePAgpk2bpvd8hYWFqK6uNqqW5rDYEFBeXg4AqKys1Lk9ISEBxcXFcHBwQK9evRpsr6iowLhx45CRkQF/f3/s378fnTp1MqiGQ4cOAYDR/8lcXV2NOo5Mx+rPe4RWMhl69OjRYNnS6Xq9bfXf4N4OWF26dEYPTdupr7VoYI0iE57P19MR0a+G4Pi5P7A2/hdoNCL+9s9TiH51IF55LgCxWy80+xpu7u6NtgTc+0nd0dGh0f97jXXGq2slBoBRo0YZUOX/3C8A1HniiSewa9cuaDQapKamYsqUKXpvO7i7uzerJcBYFhsCXF1dUVJSglOnTmHIkCH1thUVFWH58uUAgP79+zeYA6CmpgaTJk1CWloafHx8kJKS0mgzji4FBQV45513EBER0eQxCO5lbPMOmc7q9V+jtKwcbq5uyM/Pb7Bs6XS93rb6b6Ba9hbEzCztcsy6GHw06nEzVmQe5RV3YD/YNPegBQH497vDILMSMOvtI9rHAT/YdA6RT3gh+tUQJP1wtdm3BX7NzISdbcPbrHVU0R9C/Om4dnnZsuVY8cxk/furVEhMTGywXqPRaAd6c3JyQr9+/QyutakBoO4agYGBOH36NG7dugWlUgl3d3ed583MzIRc3vpvyRbbMbBuEqC1a9dqO4AAtSM6hYeHa2d0uvcNWq1W47nnnsOBAwfg4eGBlJQUvd80fcrKyjBhwgQoFArEx8c374UQEZnJ67MeQtiA7lj12Slcyvnf44AajYjZ7/wAucwK8f9oP2OmFBUVaQd88/X1NbgzoCEBoI6vr6/265ycHCOqblkW2xJQNw7A1atX0bdvX/Tp0wdVVVXIysrCmDFj4OXlhf379zfoD7B9+3ZtglQoFJgxY4bea+zYsaNBM0xlZSXGjx+PnJwcpKWlwc3NzfQvjoiohfXp1Qnv/uVh/HT2Gj7c3PBxwAtXbpr8tkBLy83N1X6t6zZwY4wJAADg7e1d7/phYWEGXbelWWwI8PDwQFpaGpYvX44jR44gNzcXAQEBiIuLw7x58+Dj4wOgYafAuztmZGdnIzs7W+816hJlnTt37uDpp5/GiRMncPDgQQQEBJjwFRERtZ5LObfQceDmRvdZ88UvWPPFL61UUfPd/bx+165dm3ycsQHg3uu0xfECLDYEALUd8vbu3dtgfVlZGXJzc2FlZdXgntDs2bMxe/Zsg69VNybBwYMHkZycjEGDBhlbNhERtYCBAwfCw8MDNTU1ep8c0+WPP/7QTh1s6FDA3bp1w4oVK2Btbd3koYhbk0WHAH3Onz8PURTh5+dnsomA/vKXv+Cbb77BypUrYWtri2PHjmm3+fj46HyEkIiIWo+Tk5NRb8Tdu3fHW2+9hTVr1mDOnDkGzQXQoUMH7cBBbZEkQ8C5c7WzXjVluOCm+v777wEAa9aswZo1a+pt27Rpk1GtC0RE1Db4+Pjgk08+sbgZZBkCTOTuDidERGR5LC0AABb8iGBjWiIEEBERtTeSbAm4e8QoIiIiqZJkSwARERExBBAREUkWQwAREZFEMQQQERFJFEMAERGRRDEEEBERSRRDABERkUQxBBAREUkUQwARWSjR3AWQqYj8XrYUhgAisgwKRb1FsbrGTIWQyVVX11+2UejejwwmyWGDicgC2dvVWxSv5JipEPOy7ShH2bGZ5i7DILYd9b8ViWoNxJy8eusEOzs9e9eSyWSYPHmySWoDgHVxCbhdXg4HOzssf2lag2VTkMlkJjmPoRgCiMgiCH39IR7L0C6LP2dArKiAYIEzvzVGEATY2VqbuwyTEc/8Aty8VW+d0M+/0WMEQYBcbrq3NxGARqz9Wy6XN1huz3g7gIgsglXY4Poryiug/ls0xCs5EHlPud0R76igOZYB9Uex9Tf08oLg7maeoixQ+44wRER/Epy7QujjB/FSpnadeCkTqiUrgW4uEFycgXb+qU0aRKC6BuLVAqC8vMHWBmGPmoU/EURkMWSL5kP11j+AW6X1N1z7A+K1P8xTFJmM8FAArJ4aY+4yLApvBxCRxRA8H4D8/VVAJ0dzl0ImJjwUANk7KyB06GDuUiwKWwKIyKIIng9A/sG70OxLgSb9GMAWgHZN6OMHIWwwrEY/wQDQAhgCiMjiCG6ukM2ZAavZ0/H/b/gPbpdXwl5mhb94uWB97jWUqdSwl8vwF69u5i6VdFEoINjb1QYAF2dzV2PRGAKIyGIJgoDbKg1K76gAGzvIJjyJsvVfo7SqHOjQEbIJT5q7RCKzYp8AIiIiiWIIICIikiiGACIiIoliCCAiIpIohgAiIiKJYgggIiKSKIYAIiIiiWIIICIikiiGACIiIoliCCAiIpIohgAiIiKJYgggIiKSKIYAIiIiiWIIICIikiiGgHZsy5YtCA4ORpcuXdCxY0f4+/vjo48+giiK5i6NGpGcnIygoCDY2NjAy8sLH330kblLalU//PADJkyYgJ49e0IQBLz33nvmLomoVa1btw5DhgxBly5d0LlzZzz66KPYt2+fWWqRm+WqZBLdunXDO++8g969e8PGxgZpaWlYuHAhZDIZXn31VXOXRzqcOHECEyZMwLJly7Bt2zb8/PPPWLBgAWxtbbFgwQJzl9cqysrKEBAQgOeeew6vvfaaucshanWpqamYO3cuBg4cCFtbW2zcuBHjxo3DkSNHEBYW1qq1MAS0Y6NHj6637O3tjd27d+Pw4cMMAW3URx99hIEDByI6OhoA4O/vj/Pnz2PNmjWSCQFjx47F2LFjAQArVqwwczVEre/777+vt/zBBx9g37592LlzZ6uHAN4OsBCiKOL48eNIT09HeHi4ucshPdLT0xEREVFvXUREBPLy8pCfn2+mqojInDQaDUpLS2FnZ9fq12ZLQDt369Yt9OjRAzU1NdBoNPjrX/+KxYsXm7usdqequga/FV5rsF6lVmv/zszJb7B8N1cXJzja2zZ6naKiIri6utY/7s/loqIieHh4GP0amisvX4nqO6p663S9Xn3/BrYdbeDh6tJK1RKZXuHvxSirqGqwvqm/B6zlMvR6wM3g665evRo3b97E/PnzjazceAwB7ZyDgwPOnDmDiooKHD16FG+88Qbc3d3xwgsvmLu0dkVhLcehn04j52qRzu0VlVWI356sd9mpswNenfN0i9fZkq7duInE73/Que3e16tr3eynI+49jKhdqaquwabtydDXtfp+vwfGPxFqcAj47LPPsHr1auzZs8csHwJ4O6Cds7Kygq+vL/r3748FCxYgKioKb731lrnLanesrKww5cnhsFFYG3ysIAiY9mR4k451c3ODUqmst+7333/XbjOnkId6I+DBnkYd+0iQP/r4eJq4IqLW5e3pjkcH9jfqWN+ePTAkuK9Bx8TE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", "text/plain": [ - "\"Output" + "
" ] }, "execution_count": 3, @@ -198,7 +205,196 @@ }, { "cell_type": "markdown", - "id": "ef8fd422-6bab-46c9-9455-c79244cf1fb7", + "metadata": {}, + "source": [ + "## Switch statement\n", + "\n", + "The switch statement is used to select actions based on the value of a classical bit or register. It is similar to an if statement, but allows one to specify more cases for the branching logic. In the example below, we apply a Hadamard gate to a qubit and measure it. If the result is 0, we apply an X gate on the qubit, and if the result is 1, we apply a Z gate. The resulting measurement outcome should be 1 with 100% probability." + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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VBSSk5PRpEmTMtvp06cPPvroI/z5559o1aoV1q5di7feegtAxXvmhg8fjnXr1ikvgHj06BECAgIAAN988w2eP3+Oq1evolOnTvDz80PXrl0r/wMgIiKd4dWsRFpy/vx5TJs2DZmZmZBIJFi4cCFWrFiB9PR0GBkZwdLSEosWLUJwcPBr2/n1118xY8YMyGQyeHh4YMuWLbC2tq5wHU+ePMGYMWMQGxsLExMTfPPNNwgKCsLly5cxdOhQ/PHHH2jQoAF+//13jB49GhcuXICtrS28vLyQkpKCJ0+ewNHREUFBQdi2bVtlfyxERFTFGOaIiIiIRIxj5oiIiIhEjGPmiHSgQ4cOkMlkKsvc3d2xY8cOHVVERERixdOsRERERCLG06xEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIvb/6neN8lmBoRcAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "execution_count": 4, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qubits = QuantumRegister(1)\n", + "clbits = ClassicalRegister(1)\n", + "circuit = QuantumCircuit(qubits, clbits)\n", + "(q0,) = qubits\n", + "(c0,) = clbits\n", + "\n", + "circuit.h(q0)\n", + "circuit.measure(q0, c0)\n", + "with circuit.switch(c0) as case:\n", + " with case(0):\n", + " circuit.x(q0)\n", + " with case(1):\n", + " circuit.z(q0)\n", + "circuit.measure(q0, c0)\n", + "\n", + "circuit.draw(\"mpl\")\n", + "\n", + "# example output counts: {'1': 1024}" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Because the example above used a single classical bit, there were only two possible cases, so we could have achieved the same result using an if-else statement. The switch case is mainly useful when branching on the value of a classical register composed of multiple bits, as demonstrated in the following example. Here, we also show how to construct a default case, which is executed if none of the preceding cases are. Note that in a switch statement, only one of the blocks are ever executed. There is no fallthrough.\n", + "\n", + "In the example below, we apply Hadamard gates to two qubits and measure them. If the result is either 00 or 11, we apply a Z gate to the third qubit. If the result is 01, we apply a Y gate. If none of the preceding cases matched, we apply an X gate. Finally, measure the third qubit." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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1+N6gBHQIwTA5dWtW1dHjhzRypUr8/yFLkldu3bVhAkTdPz4cdWtW1eStHHjRrm5uemXX35RYmKiKlWqJEmKiopSQECAWrVqZbetsLAwvfPOO3rhhRfUr18/63HLli1r3ea1117TlClT1LhxY73wwgsKDg7W8ePHtWLFCr355pvy8vrzPqd58+bpt99+0+OPP67AwEAtWbJEY8eOVWhoqB5++OFC/b0sX75ckjRixIh87/Ppp5/qwoULGjx4sEJDQ3X27Fl99NFHuvPOO7Vp0yZ16tRJknT+/Hl17dpVkvTkk0+qZs2aSkxM1N69e/XDDz+oV69ekqTMzEz16NFD33//vR599FE9++yzunz5shYsWKCOHTtq69atef4dw7G4HnA9rgcYAUEIgMsbP368vvvuOw0YMED169fXHXfcodatWysiIkJhYWHW7XKCUFRUlDUIRUVF6eGHH9aSJUsUFRWlgQMHymKxaPPmzercubPc3d3tHrNq1aq677779MILLyg8PFyPPGI7i9Xu3bs1ZcoURUZGau3atTbD6qZNm5arvdOnT+vw4cMqV66cJOnvf/+7atasqTlz5hQ6CP3vf/9TQECA6tSpk+99FixYID8/P5tlTz75pJo0aaKpU6da3+js2LFD586d09KlSzVw4MA823vvvfe0efNmrVu3Tnff/edDAp9++mk1bdpUL7/8comfbMJVcD3gelwPMAKGxgFwee3bt9ePP/6oIUOG6PLly/rkk0/09NNPq3HjxurcubNOnDghSWrTpo3Kli2rqKgoSdKpU6d08uRJPfTQQ2ratKk2btwoSdbeoZxPNAvj888/lyRNnTo1171FOcPorjd06FBrCJIkX19ftWvXTkePHi10DUlJSfL39y/QPte/yUlOTtb58+fl7u6utm3bWocJSrLW+s033ygpKSnP9pYsWaJGjRqpZcuWSkxMtH5lZGSoe/fu2r59u1JTU/PcH47D9YDrcT3ACOgRAmAIzZo106effirpWsDZsmWLPvroI23btk19+/bVjz/+KC8vL91xxx3W6bQ3btwoDw8Pde7cWV27dtXatdceTpMTlG4lCB09etTuvUd5sfepbMWKFXX+/PlC1xAQEKArV64UaJ/jx4/rtdde07fffqtLly7ZrLs+vHXp0kWDBw/Wp59+qs8//1ytW7dWt27d9OCDD6px48bW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QKl35swZBQcHy8PDQ5JkMplUo0YNnT17VjNnztTAgQO1efNmvf/++1q8eLHc3Gx/9H388cd69NFH5enp6YzyAQCAE3g4uwAAKEoPPfSQNm3apLvvvlsbN25U5cqVbdZfvXpV//rXv7Rr1y4nVQgAAJyBHiEApV716tUVHx8vs9ksSbJYLDp9+rRq1Kghs9ms//3vf6pQoYLOnj2ba99///vfatKkiRo3blzcZQMAACciCAEo9apUqaLbb79dS5YskSStWLFCoaGhqlevnl555RU1bNhQ27Zt08svv6xjx47Z7Pvxxx/r8ccfd0bZAADAiZg1DoBLOHLkiB577DGdP39eAQEB+uSTT3Tq1Cm98sor2r17t3x9ffXvf/9bU6dO1ffffy8fHx8dOXJErVq1UlxcnPz9/Z19CgAAoBgRhAAAAAAYDkPjAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABjO/wNa8nfBRao1WgAAAABJRU5ErkJggg==", + "text/plain": [ + "
" + ] + }, + "execution_count": 5, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qubits = QuantumRegister(3)\n", + "clbits = ClassicalRegister(3)\n", + "circuit = QuantumCircuit(qubits, clbits)\n", + "(q0, q1, q2) = qubits\n", + "(c0, c1, c2) = clbits\n", + "\n", + "circuit.h([q0, q1])\n", + "circuit.measure(q0, c0)\n", + "circuit.measure(q1, c1)\n", + "with circuit.switch(clbits) as case:\n", + " with case(0b000, 0b011):\n", + " circuit.z(q2)\n", + " with case(0b001):\n", + " circuit.y(q2)\n", + " with case(case.DEFAULT):\n", + " circuit.x(q2)\n", + "circuit.measure(q2, c2)\n", + "\n", + "circuit.draw(\"mpl\")\n", + "\n", + "# example output counts: {'101': 267, '110': 249, '011': 265, '000': 243}" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## For loop\n", + "\n", + "A for loop is used to iterate over a sequence of classical values and perform some operations during each iteration.\n", + "\n", + "In the example below, we use a for loop to apply 5 X gates to a qubit and then measure it. Because we perform an odd number of X gates, the overall effect is to flip the qubit from the 0 state to the 1 state." + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 6, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qubits = QuantumRegister(1)\n", + "clbits = ClassicalRegister(1)\n", + "circuit = QuantumCircuit(qubits, clbits)\n", + "(q0,) = qubits\n", + "(c0,) = clbits\n", + "\n", + "with circuit.for_loop(range(5)) as _:\n", + " circuit.x(q0)\n", + "circuit.measure(q0, c0)\n", + "\n", + "circuit.draw(\"mpl\")\n", + "\n", + "# example output counts: {'1': 1024}" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## While loop\n", + "\n", + "A while loop is used to repeat instructions while some condition is satisfied.\n", + "\n", + "In the example below, we apply Hadamard gates to two qubits and measure them. Then, we create a while loop that repeats this procedure while the measurement outcome is 11. As a result, the final measurement should never be 11, with the remaining possibilities appearing with approximately equal frequency." + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAkEAAADuCAYAAAA+0dO/AAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjksIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvJkbTWQAAAAlwSFlzAAAPYQAAD2EBqD+naQAANahJREFUeJzt3XlYU1fCBvA3C4QdZBMQ2VRUlMUFUXREXHFvQeliXdpa285ntcug1m7TT6tW/dqOtQudarW2Yx2VanE61n3fsCql7oqgIGhVEEEEktzvDyYZIgFJCCTkvr/n8ZG7nxuSw5tzzz1XIgiCACIiIiKRkZq7AERERETmwBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKIkN3cBiIiaglBaCuFIBtTHfgXuFEEofwBAMHexiOhRJBJIHByA1t6Q9ukFSY8oSBSKpjmUIAisFYjIaggPHkD1ty8gHM0AlCpzF4eIGstOAemQgZA+NwkSmWkvYDEEEZHVEB48gOp/P4Tw+xlzF4WITEwyMA6yV14yaRBinyAisgqCIEA1bzEDEJGVEnbthTp1hUn3yT5BRGQVhAuXIGSd1p1pY1PdnyAqHBJnZ0AiMU/hiKjhVGoIxcUQjp+o/kyr/3vBSr1tF6TPPAGJi4tJDsUQRERWQThwWHeGkyPk89+FJCTILOUhokYaOxLqjBNQLVz63/59ajWEwxmQDBtkkkPwchgRWQX14WM609IRwxiAiFo4aXR3SHr11JmnPnTUZPtnS5AVEQQBqKgwdzEMo1BAYsJLFIIgQKVqWXcEyWQyk74GYiRUKYGbf+jMk8T0rGNt6yb2eoB1gPWRxkRDVSP4CAWFJts3Q5A1qaiAMnmyuUthEPk/VwN2dibbn0qlwsaNG022v+aQlJQEuZwfxUa5f7/WLImnhxkKYgFEXg+wDrBCXg99lktLTbZrXg4jopZPra49TyZr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SJQYgoiIiEiUGIKIiIhIlBiCiIiISJREN2K0VVMoIP/nanOXwjAKhUl3J5PJkJSUZLL9LUldh3tlZXB2dETKi0/UmjYFmUxmkv0QARB9PcA6gAzBEGRFJBIJYGdn7mKYlUQigVxuure1AEAtVP8vl8trTRNZGrHXA6wDyBC8HEZERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREoiQ3dwHIdARBACoqzF0MwygUkEgk5i6F1RAEASqVytzFMIhMJuN7wIRYDxDrgYZjCLImFRVQJk82dykMIv/nasDOztzFsBoqlQobN240dzEMkpSUBLmcVZHJsB4QPdYDDcfLYURERCRKDEFEREQkSgxBREREJEoMQURERCRKDEFEREQkSgxBREREJEoMQURERCRKDEFEREQkSgxBREREJEoMQURERCRKDEFE1KRu374NtVpt7mIQkZkIgoA//vjD3MXQiw/sqcemTZuwYsUKHD9+HHfu3IG7uzs6deqEESNGICUlxdzFI2oyRUVFuHTpErKzs3H16lXcv38fgiDA1tYWfn5+CAkJQUhICNq0aVPvQw/z8/Mxb948RERE4KWXXoJUyu9dRC2BSqVCTk4OsrOzceXKFdy8eRNVVVWQyWRwdnZGcHAwgoOD0b59ezg6Ota5H0EQsHbtWmzfvh1z585Fhw4dmvEsHo0hSI/KykpMmDABGzZsAACEhISgbdu2uHHjBvbv34+srCyGILI6arUamZmZ2LZtG06dOlX9NHI9fvvtN+3PAQEBGDJkCPr16wd7e3ud9TQBqLi4GPv27UPr1q2RlJTUpOdARI1TVFSEXbt2YefOnbhz506d6x09ehQAYGNjg9jYWAwdOhTt2rXTWUcTgH766ScAwMKFC/HJJ5/AxcWl6U7AQAxBekydOhUbNmxAQkICli9frvOL1VToRNbk8uXL+OKLL5CXl2fQdlevXsWKFSvwww8/YOLEiYiLi4NEItEJQAAQFBSEYcOGNUHJicgUlEol0tLSsHnzZqhUqgZvV1VVhb1792Lv3r2IiIjAtGnT4OnpWSsAAcDTTz9tUQEIYAiqZdu2bViz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", + "text/plain": [ + "
" + ] + }, + "execution_count": 7, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qubits = QuantumRegister(2)\n", + "clbits = ClassicalRegister(2)\n", + "circuit = QuantumCircuit(qubits, clbits)\n", + "\n", + "q0, q1 = qubits\n", + "c0, c1 = clbits\n", + "\n", + "circuit.h([q0, q1])\n", + "circuit.measure(q0, c0)\n", + "circuit.measure(q1, c1)\n", + "with circuit.while_loop((clbits, 0b11)):\n", + " circuit.h([q0, q1])\n", + " circuit.measure(q0, c0)\n", + " circuit.measure(q1, c1)\n", + "\n", + "circuit.draw(\"mpl\")\n", + "\n", + "# example output counts: {'01': 334, '10': 368, '00': 322}" + ] + }, + { + "cell_type": "markdown", "metadata": {}, "source": [ "## Classical expressions\n", @@ -213,8 +409,7 @@ }, { "cell_type": "code", - "execution_count": 4, - "id": "7581ac2f-53e9-43d0-bad0-2c80790172e1", + "execution_count": 8, "metadata": {}, "outputs": [], "source": [ @@ -274,17 +469,17 @@ }, { "cell_type": "code", - "execution_count": 5, - "id": "d0f0abdb-50d5-408d-a704-a1a555acdd85", + "execution_count": 9, "metadata": {}, "outputs": [ { "data": { + "image/png": "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XOP+888/V3FxsQYNGtToet0hOjq61rYpU6YoIiJCy5Yt04YNGxQaGqqLL75YEydOrF7wo0pqaqr69OmjoKCTryILzzIMQxNGRGvOf9Ld3vcVI7rKavWOzxa6R7XSl7NH6tLbv1Hh0ZPfN6l3t9ZaNHuUAgNMfdkEAAAt0PbdhxU48J2THvPknM16cs5mN1XkPiMGd9K8xy7Q1EdWyWY7+XvBi8/tpHmPm2sUJICWo0W+k926dascDodiYmIaFWRdf/316t69u84+++zqRUCefvppxcfHa9KkSU1QsetER0fXCgEtFovGjh2rsWPHnrRtYWGhdu7c2ah7HML9br861iMBoLdNiUjq315r/j1Of39tvRYuzVTlCS/8WoX46oZxvfTo7Wc7NVoQAAAA3mHyuF7qHBmix9/YoJSfay+r0umMIN02MVYzpvaTr693fNANACdqkQHgli1bJNW+/19D9enTR++//75efPFFHTt2TFFRUfrjH/+omTNnumRl3uaq6v6G3P/PO5wdF67B/SL04+YDbutzQO92GtzvDLf15yq9u7XRB08PV15+iT78ercefDlVRSWVahPqp71LJynkJDeqBgAAgPcbOrCDhg7soLRdhfp8eZb+8eZGFZVUKqy1nzKXXC0fH4I/AN6tRV7FTjcA/Nvf/qYtW7boyJEjqqio0O7du/X888+rdWvvuO9ZYw0bNkzvvvuuwsLCPF0KGujlvyU5dU+T02EY0uwHkrzuPpi/FxkepLuu66PWIceD/OBAH8I/AACAFiS2exvdf1P/6teDgf4+hH8ATKFFXslONwBsqaxWq3x9CUO8SWKfCM24sZ9b+rp38lk6N769W/oCAACul5mZKavVqvj4eG3cuFGStGjRIiUkJMjf31/33HNPjeNfeOEF9ezZ85SLw23atEnt27dXXFyc9u/f77J6DcNQ37599dVXX1Vv+8c//qEePXqoR48eevDBB6u3JycnKy4uTm3atHFZ/wAAeJMWOQU4JSXF0yUAbjPztgFK+XmfftrS8KnAefklNf4+lbNj2+kfdyQ0qj4AANB8hIaGVod/ktSrVy/NnTtXH330kYqKimoce++992rAgAG1gsHf++WXXzRhwgQtWLBAO3bs0MiRI/Xtt98qIiLCJfWuWrWqOtRbuXKlFixYoM2bN8vHx0fnnXeezj33XI0ZM0ZXX321zjnnnFOGlQAAmFWLHAEItCT+flZ99erF6n9mw6duD7zmc3Ue+YEGXvP5KY/t06ONlrx2MavjAgDQTBmGoX/+858655xzFB0drU8//VSzZs1SYmKievXqpeXLl9fbNiYmRv3795ePj/O/59PS0nTDDTfok08+0fDhw3Xrrbfq8ccf17hx43Tw4ME620RHR+uhhx7Sueeeq86dO+v111/XvHnzlJSUpOjoaH3wwQf19pecnKzJkycrODhY/v7+uummm7RgwQKn6wYAwIwIAIEWIKy1v5bPuVRDB3Zw6XnPG9BeK+aNUURYoEvPCwAAXCskJEQ//fST5syZo+uvv14dOnRQamqqnnjiCd13331N0mdsbKzWr1+vfv3+dzuS8ePH68cff1S7du3qbVdcXKzVq1fru+++07333qucnBytWbNGH330ke6888562+3Zs0ddu3atfhwdHa09e/a45skAAODlCACBFqJNK38te2u0XpxxjgIDrKd1Ln8/q56+d6BWzL1U7doEuKhCAADQVK6++mpJUmJiooqLizVp0iRJ0qBBg7Rjxw5PllZLVa09e/ZUQECArrzySknHaz906JAKCws9WB0AAN6JABBoQSwWQ3dff5Y2fXS5bhjXU/5+zgWBfr4WXTemhzZ+dJnum9pPViuXEAAAvEFAwPEP7KxWa63HlZWVHqurLlW1Scfrq3psGIYMw6i33i5duigrK6v6cWZmprp06dK0xQIA4CV49w60QL26ttY7/xyi7KWT9PS9AzVicEe1beVX57FtQv00fFAHzbo7UXu/maR/zxqq3t3auLdgAACAU7jqqqs0f/58FRcXq6ysTHPnzq0e6QgAQEvHXfuBFiy8bYDum9pP903tJ4fDocycIu07UKKycpv8/ayKDA9U96hQGYbh6VIBAIAHLFu2TFOmTNGRI0fkcDj08ccf69VXX9X48eM9XVotQ4cO1dVXX62+fftKOj6VeOzYsR6uCgCA5oEAEICk49NqukWFqltUqKdLAQAALuRwOKr/HRISUuNxVFSUioqK6m170UUXKTs7u0nr+73MzMwaj/Pz82s8PtV05UceeUSPPPKIq8sCAMDrMQUYAAAAgKxWq4KCghQfH6+NGzee8vgXXnhBt99+u8LDw5u+uDq0b99eQ4YM0VdffXXKY5OTkzVu3Di1b9/eDZUBAND8MAIQAAAA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gQMHFBkZWepw4zNnzig3N1chISGF+8LCwvT777+X2lb37t31008/le/i4JL41g64CDc3Q688Gqkdn49QeJPqFTpX80aB2rpkhF5/ootMJt5GAAAAgKps3LhxkqTIyEhdunRJd955pySpS5cuZRpGeuDAAd17771asWJFYe+8ypCUlKQ6deoU2de9e3c1bNhQ0pX4O3fuXFimc+fOVWoYbLNmzdSpUydJV2Jt1qyZWrVqJansr3VZhYSEKCkpyWrng/PjmzvgYrq2r609K0bpH8/3UkSrmhbVbde8hhb9taf2/es29exY58YVAAAAANjd1V5sJpOp2HZeXt5168bHx2vEiBH69NNP1atXr0qN09fXV1lZWUX2XY1VuhLvtds3it+WyhtrrVq15O7urtTU1MJ9x48fL0x8liQrK0s+Pj5WiBquwt3eAQCwPW8vd025vaXuH91CO/ef1g//Ttbu+DTtjk/TydOZMpuvDPENCfJVp/Ba6tQ6SIO711ePiNrM9QcAAAC4iISEBA0bNkwfffSRBg8eXOnttW/fXr/++mult1MVjRkzRosWLdILL7yg6OhoJScnq2/fvqWWT0hIUIcOHWwYIRwdCUDAhRmGoW4daqtbh9qF+8xms/LyzHJ3N0j2AQAAAC5s2rRpOn/+vGbNmlW4Au68efM0ZMiQSmnvjjvu0H333adXXnnFKuf7f//v/2nt2rVKTU3VkCFDFBAQcN1ViO1p3rx5mjhxopo3by5PT0998cUX8vDwKLX8+vXrdccdd9gwQjg6EoAAijAMQx4eJP4AAAAAZ2A2mwv/7e/vX2Q7NDT0uqvobty4sVJju1a7du1Uu3ZtRUdHq3Pnzpo8ebImT55cePyRRx4pUv6555677vk+/PDDygizRP369VNsbGzh9ogRIzRixIjC7bvvvlt33313qfXr1KmjH374oUxtpaWlaffu3Ta9Pjg+5gAEAAAAAMDFmUwm+fr6KiIiokgiqzQrVqzQLbfcUmzRjopauHCh/vjjD4vr+fv767vvvtPIkSPLVL5///7asmVLpS5qUhofHx/FxsYqMjKyTOUnTJigL774QoGBgZKko0ePatGiRfL09KzMMOFk6AEIAAAAAICLa9CggU6ePFnm8uPGjStcXdiamjZtqqZNm1pc76mnntJTTz1V5vKbN2+2uA1rsfS1+/LLL4tsd+3a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", "text/plain": [ - "\"Output" + "
" ] }, - "execution_count": 5, + "execution_count": 9, "metadata": {}, "output_type": "execute_result" } @@ -295,7 +490,6 @@ }, { "cell_type": "markdown", - "id": "7c80c5d0-a447-4590-8426-6eb33ae2d817", "metadata": {}, "source": [ "## Next steps\n", @@ -310,7 +504,7 @@ ], "metadata": { "kernelspec": { - "display_name": "Python 3", + "display_name": "Python 3 (ipykernel)", "language": "python", "name": "python3" }, @@ -324,7 +518,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3" + "version": "3.12.3" } }, "nbformat": 4, From 24a240642d89be3160087ff8cf54aeb2262fa4f9 Mon Sep 17 00:00:00 2001 From: Becky Dimock Date: Wed, 3 Jun 2026 13:09:31 -0500 Subject: [PATCH 3/9] put back store --- ...assical-feedforward-and-control-flow.ipynb | 62 +++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index df7338385b8..15bf3b73f78 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -488,6 +488,68 @@ "qc.draw(output=\"mpl\", style=\"iqp\", idle_wires=False, fold=-1)" ] }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "### `Store`\n", + "\n", + "You can use the [`store`](/docs/api/qiskit/circuit#store) instruction to save the result of a classical expression, if that expression will be used repeatedly. Operations are automatically parallelized, making your code significantly more efficient at runtime.\n", + "\n", + "For example, it is more natural and more efficient at runtime to write $B[0] \\oplus B[1] \\oplus B[2] \\ldots$, where $B = \\neg A$, than $(\\neg A[0]) \\oplus (\\neg A[1]) \\oplus (\\neg A[2]) \\ldots$.  The former computes the negation in a single parallel step before the XOR chain, instead of evaluating each negation sequentially inside the expression.\n", + "\n", + "Full example:" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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8vDwkMViUceOHZ1cLQB7HTlyRLNmzVJGRoZtXfv27TV48GBdddVVcnd3r/BYwzC0Z88effHFF9qyZYskae/evXrwwQdL9WYRogAAruyrr77S66+/LsMwJEmenp5KTExUUlKSmjdvXu4xXbt2lSTl5eVp48aNWrlypY4cOSLDMLRs2TKtWrXKFrBcNURJBKlqMXnyZKWlpWnSpEmaN29eqW3Tp0/XO++8o507dyoyMlJBQUFOqhLA5UhLS9OTTz6pzMxMSVJgYKDuuusu9ejRo0qhx2KxKC4uTnFxcfrxxx/18ssv69dffyVEAQBqjc8//1wLFy60Lbdu3Vq///3vFRYWVqXjfXx8dM0116hfv35atmyZPvjgA1mtVluI8vLyctkQJTFGyuH27t2rxYsXq1GjRnrqqafK3adz586SpE6dOtnWffjhhxo9erRatmwpPz8/tWnTRo888oiysrJqpO7qkFNcrFP5+eX+B9RmmZmZmjVrli1ERUVFae7cuerZs6ddoad9+/YaOnRoqXXu7u7q378/IQoA4JK2bdtWKkQNHz5cTzzxRJVD1IXc3d01bNgwxcTElFofGhqqtm3bXm6p1YYeKQd79913ZbVaddtttykgIKDcfXx9fSWVDlLz5s1TixYtNGvWLIWHhys5OVlPPPGE1q1bp2+++eaSU0O6oif37daT+3Y7uwzA4d544w3bOMeoqCg9+uijlzU1+apVq0o1RpJUXFysl156SU888USt/PcPAKi7zp07p1dffdW2fP311+vmm2+2+3wlE0v89FPpicp++eUXrVy5sswPG10FQcrBVq9eLUlKTEyscJ+0tDRJpYPUp59+qpCQENtyv379FBISottuu03ffvut+vbtW00VV5/ftYjS6LDyn429btO6Gq4GcIwtW7Zo48aNkiR/f389+OCDlx2iLpxY4rrrrtP333+vkydP6ueff9aKFSs0bNiwy64bAABHWbhwoc6ePSvp/JNWY8eOtftc5c3Od/PNN+vNN9+UYRh67733dNVVV9nV01XdCFIOdvjwYUlSy5Yty91eVFSkDRs2SCodpC4MUSW6dOkiSTp69KhdtXTp0qXM7CmX4uvmpj3xPey63sWiAwI0IKSJQ85VkZiYGOW66NuuJemGu6bIPyBIx9OPKzw8vMxyXVcb79/Ly6vCx3INw9DixYtty+PHj1dw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fFHh+KjY2FhJUrdu3TR48GBFRERozpw5evHFF03XYm83JRxn1j//o3NZ2Woa2lRpaWlllus67r/s/brqn0HR0/NlbNxsW37gzw9o2q03ObEiwDmycwoV0P3Nyz6PxSIt/GtfubtZNP7Rdbapzue8sUujBkToqfu7aPk3RxzyiN/P+/fL38+zwu2Ff/6LdDDFtvzcc8/phcS+l33dqqhNn4PVhbaw7t4/k004WHh4uNavX6+hQ4fKx8dHqampCg4O1ssvv6zly5dr//79ki490YQk1a9fX9HR0Tpw4EB1lw0AABxo6vgO6nVVE/3fv7brp5T/TXVutRq687Fv5OHuptef7FPJGQC4OnqkqkHbtm312WeflVmflZWl1NRUubm5qX379pc8z8mTJ7Vv3z5169atOsoEAADVoE1kPf31j1fru50n9Y9FZac633PwTLU84gegZhGkatDu3btlGIZiYmLk5+dXatvtt9+u6OhoxcfHq379+vr555/1zDPPyMPDQ3/+MzNnAQBQW/yUcla+XRdVus/TC37Q0wt+qKGKAFQHglQN2rVrl6TyH+vr3r273nzzTT333HPKy8tT8+bNlZiYqIcffrjCd1IBAAAAcA6CVA2qLEhNmjRJkyZNqumSAAAAANiBySZqUGVBCgBqi8cff1x5eXk1es2IiAjFxsbqtddes61bsGCBWrdurVatWunuu+9WYeH56Z/Xr1+v+Ph4WSwWnTlzpsJznjlzRl26dFFwcLA2btxY6fWXLl2qTZs2OeRequrxxx9XSEiIRowYYVs3efJkRUREyGKxKDk5udT+iYmJCg4O1rPPPlvpef/617/K09NTU6dOrXS/1NRUvfTSS/aWb5fU1FS5u7srPj7edn/PP/+82rdvrw4dOqhjx456++23bfsvXrxY7dq1U/369Wu0TgCQCFI1avXq1TIMQ0OHDnV2KQBgtyeeeKLGg5R0/kvz7373O0lSSkqKHnvsMa1fv14HDhzQiRMn9Morr0iS+vTpUyZkXOzcuXMaPHiwxowZoxUrVmjcuHHavHlzhfs7I0hJ0m233aZly5bZlm+88UZ9++235T7yvWbNmlKhqzxPP/20vvrqKx06dEh79uzRjBkzKtzXGUFKkgIDA5WcnGx732JcXJw2bNigXbt2afny5ZoyZYoOHjwoSRo7dqxWrHDci20BwAyCFACgyu677z5J58NKfHy8Tp48qczMTN19991KSEhQx44ddc8996igoECS1L9/f02dOlV9+/ZVixYt9Nhjj2nFihXq3bu3IiIiNH/+fNu5IyIiNG3aNHXu3FnR0dGaO3duhXV8+OGHGjFihEJDQ2WxWHTffffp3XffrdI9ZGVlaeTIkZo8ebKmT5+u7t27a+XKlfr973+vrVu3ltl/xYoVWrZsmebOnav4+Hhbr9hbb72lbt266eqrr1bfvn21c+dOSdLChQs1cOBA3XLLLWrXrp169uypPXv26IYbblDbtm01aNAgZWVlSTrf6zR69Ghdc801atOmjYYPH67ffvutwtr79u2r8PDwKt3nxebPn6/vv/9eX375pZo3b65PP/1UJ0+e1COPPFLu/vfdd5/27dun+Ph4W0D7+eefNXToUHXt2lUdO3Ys9Y5Di8Wiv//97+rWrZsiIiK0dOlSPfXUU+rSpYtat26ttWvXSjof0OrXr68HH3xQHTt2VFxcnFatWlVh3QMGDFC9evUkSc2bN1doaKiOHDli158BADgSY6QAAFX20ksv6eWXX9b69ettj1Pdc8896tOnj1599VUZhqG7775bzz33nKZNmyZJOnz4sNasWaNz584pIiJCGRkZWr9+vY4dO6bY2FhNmDDBdq4TJ05o27Zt+u2333T11VerV69e6tmzZ5k6fvnll1K9MhEREfrll1+qdA8BAQFas2ZNqXUxMTHavn17ufsPGTJEI0aMUHx8vKZMmSJJ2rBhg959911988038vb21vr163Xrrbdq9+7dkqStW7dq165datGihcaNG6fhw4dr48aNatKkiYYNG6ZFixbpj3/8o6TzjyL+8MMPCg0N1R/+8Ac99NBDtt41R3rggQdKLXt4eOiNN96ocP+XXnpJU6ZMsfXuFRcX65ZbbtHbb7+tNm3aKCcnR927d1e3bt3UtWtXSef/bDdv3qyvv/5aI0eO1Isvvqht27bpgw8+0LRp02xB9ezZs2rbtq3mzZunTZs2acSIEbZepsqsWrVKGRkZtusBgDMRpAAAl2Xp0qX67rvvbL1Lubm5cnd3t22/8cYb5e7urgYNGigqKkrDhg2TxWJRs2bNFBISotTUVNtjXBMnTpTFYlGjRo00atQorVq1qtwg5WyffPKJdu7cWeo9f6dPn1Zubq4kqUePHmrRooUkqUuXLios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ly5VQECA3nnnnXKna68u+fkFWr/l/AyHA3peTYgCrkA9evTQwoUL5V6FqcybNm2qlStXEqIAAFekOvNN+dZbb9U///lPXXXVVUpNTdW6deu0bt06paenSzo/Rfm6deu0cOFCJSUlKTs7W9u2bVNKSoqio6N1//33a926dYqJiamxmksC3tNPPy1vb2/9+OOP8vPz09ixY/X999+re/fuNVaLJG3cvls5eflqFFxPndq2qtFrA3Adt912m5YvX64OHTqUu91isWjYsGHatGlTjX5mAgDgSiyG2VHFuGxr165VYmKi+vXrp7Vr1zq7HJtNO/boq/XbNGxAD10V19rZ5QBwMsMwtGHDBr333ns6ceKEPD09FR0drQkTJigiIsLZ5QEA4FR1ZowULl/3q9rp6rjW8vC49CM9AOo+i8Wi3r17q3fv3s4uBQAAl0OQQileXp7OLgEAAABweXVmjBQAAAAA1BSCFAAAAACYxGQTAAAAAGASPVIAcIWwWCzq0KGDVqxYUWPXfOaZZxQdHa34+PgauyYAADWBHikAuEJYLBZlZGSofv36NXK9oqIieXh4aO3atZoyZYqSk5Nr5LoAANQEeqQA4ApVWFiov/zlL0pISFB8fLzGjBmjjIwM/frrr4qIiNCmTZskSR9++KE6deqk3NxcrV27Vu3bt9cdd9yh9u3bq3PnzraAtHbtWsXFxWnixImKj4/Xxx9/7MS7AwCgehGkAOAKNXfuXPn7+2vLli1KTk5Whw4d9OijjyokJERvvfWWbrvtNm3ZskVTpkzRBx98IF9fX0nS7t27NX78eP3444+aMWOGbr75ZpU83LB3717dcccdSk5O1k033eTM2wMAoFrxHikAuEItXbpUZ8+e1ZIlSyRJBQUFioiIkCT16dNHEydOVM+ePfXmm28qJibGdlxERIQGDBggSRozZozuueceHTlyRJIUFRWlfv361eyNAADgBAQpALhCGYahF154QYMGDSp3+44dOxQSEmILSRWxWCyyWCySpICAAIfXCQCAK+LRPgC4Ql1//fV65plnlJOTI0nKycnR7t27JUkvvviiMjIytHPnTr388svasGGD7bjU1FStWbNG0vnxU02aNFF4eHjN3wAAAE5EjxQAXKFmzJih/Px8devWzdajVLJu3rx52rx5sxo3bqy3335bt99+u7Zu3SpJiouL08KFCzV58mR5eXnp3XfftR0PAMCVgunPAeAK4Yjpz+2ZypzpzwEAdRGP9gHAFaJJkybq169fjb+Q9w9/+IMaNWpUY9cEAKAm0CMFAAAAACbRIwUAAAAAJhGkAAAAAMAkghQAAAAAmESQAgAAAACTCFIAAAAAYBJBCgAAAABMIkgBAAAAgEkEKQAAAAAwiSAFAAAAACYRpAAAAADAJIIUAAAAAJhEkAIAAAAAkwhSAAAAAGASQQoAAAAATCJIAQAAAIBJBCkAAAAAMIkgBQAAAAAmEaQAAAAAwCSCFAAAAACYRJACAAAAAJMIUgAAAABgEkEKAAAAAEwiSAEAAACASQQpAAAAADCJIAUAAAAAJv0/bZ7DyKr7wwYAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "execution_count": 10, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit.circuit import QuantumCircuit, QuantumRegister, ClassicalRegister\n", + "from qiskit.circuit.classical import expr\n", + "\n", + "qregs = QuantumRegister(4, \"q\")\n", + "creg = ClassicalRegister(3, \"c\")\n", + "# temp is a plain ClassicalRegister used as the store target\n", + "temp = ClassicalRegister(3, \"temp\")\n", + "qc = QuantumCircuit(qregs, creg, temp)\n", + "\n", + "qc.h([0, 1, 2])\n", + "qc.measure([0, 1, 2], creg)\n", + "\n", + "# Store bit-NOT of the full 3-bit register into temp\n", + "qc.store(temp, expr.bit_not(creg))\n", + "\n", + "# Compute parity of temp using bit-indexed XOR\n", + "parity = expr.bit_xor(\n", + " expr.bit_xor(expr.index(temp, 0), expr.index(temp, 1)),\n", + " expr.index(temp, 2),\n", + ")\n", + "\n", + "# Flip q3 if parity of ~creg is 1\n", + "with qc.if_test(parity):\n", + " qc.x(3)\n", + "\n", + "qc.measure([0, 1, 2], creg)\n", + "\n", + "qc.draw(\"mpl\")" + ] + }, { "cell_type": "markdown", "metadata": {}, From cececbf7b44b56f15185bb24f2d3e45b4f4abe07 Mon Sep 17 00:00:00 2001 From: Becky Dimock Date: Wed, 3 Jun 2026 13:57:31 -0500 Subject: [PATCH 4/9] broken link --- docs/guides/classical-feedforward-and-control-flow.ipynb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 15bf3b73f78..3401923e37b 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -66,7 +66,7 @@ "Each of these methods returns a [context manager](https://docs.python.org/3/reference/datamodel.html#with-statement-context-managers) and is typically used in a `with` statement. In the rest of this guide, we will explain each of these constructs and how to use them.\n", "\n", "\n", - " There are some limitations of classical feedforward and control flow operations on quantum hardware that might impact your program. For more information, see [Hardware considerations and limitations for classical feedforward and control flow](./dynamic-circuits-considerations).\n", + " There are some limitations of classical feedforward and control flow operations on quantum hardware that might impact your program. For more information, see [Job limits](/docs/guides/job-limits).\n", "\n", "\n", "## `if` statement\n", From 2934f4413dd917c10408705ab331285898dbb763 Mon Sep 17 00:00:00 2001 From: Becky Dimock Date: Wed, 3 Jun 2026 14:54:05 -0500 Subject: [PATCH 5/9] unused images --- .../20f0640a-a3f7-41b3-aada-b66bc89b0555-0.svg | 1 - .../60924bfa-50ed-4d9d-a17b-9d64f2cc053f-0.svg | 1 - .../98e8f552-4169-42a3-8182-e14e9ffb59e2-0.svg | 1 - .../d0f0abdb-50d5-408d-a704-a1a555acdd85-0.svg | 1 - .../e64ec241-41e8-40f8-ab64-af236c6c7802-0.avif | Bin 4576 -> 0 bytes 5 files changed, 4 deletions(-) delete mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/20f0640a-a3f7-41b3-aada-b66bc89b0555-0.svg delete mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/60924bfa-50ed-4d9d-a17b-9d64f2cc053f-0.svg delete mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/98e8f552-4169-42a3-8182-e14e9ffb59e2-0.svg delete mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/d0f0abdb-50d5-408d-a704-a1a555acdd85-0.svg delete mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/e64ec241-41e8-40f8-ab64-af236c6c7802-0.avif diff --git a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/20f0640a-a3f7-41b3-aada-b66bc89b0555-0.svg b/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/20f0640a-a3f7-41b3-aada-b66bc89b0555-0.svg deleted file mode 100644 index 0d66b12693e..00000000000 --- a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/20f0640a-a3f7-41b3-aada-b66bc89b0555-0.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/60924bfa-50ed-4d9d-a17b-9d64f2cc053f-0.svg b/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/60924bfa-50ed-4d9d-a17b-9d64f2cc053f-0.svg deleted file mode 100644 index 65f5f15ffbe..00000000000 --- a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/60924bfa-50ed-4d9d-a17b-9d64f2cc053f-0.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/98e8f552-4169-42a3-8182-e14e9ffb59e2-0.svg b/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/98e8f552-4169-42a3-8182-e14e9ffb59e2-0.svg deleted file mode 100644 index ee624b8b10f..00000000000 --- a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/98e8f552-4169-42a3-8182-e14e9ffb59e2-0.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/d0f0abdb-50d5-408d-a704-a1a555acdd85-0.svg b/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/d0f0abdb-50d5-408d-a704-a1a555acdd85-0.svg deleted file mode 100644 index 427fa3c3cde..00000000000 --- a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/d0f0abdb-50d5-408d-a704-a1a555acdd85-0.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/e64ec241-41e8-40f8-ab64-af236c6c7802-0.avif b/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/e64ec241-41e8-40f8-ab64-af236c6c7802-0.avif deleted file mode 100644 index e55c137ebcba3b3d39c51e31f6730fd04c5dd515..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 4576 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 Date: Wed, 3 Jun 2026 14:58:43 -0500 Subject: [PATCH 6/9] squeaky --- ...assical-feedforward-and-control-flow.ipynb | 27 +++++++++++++++++-- 1 file changed, 25 insertions(+), 2 deletions(-) diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 3401923e37b..75579e5f541 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -2,6 +2,7 @@ "cells": [ { "cell_type": "markdown", + "id": "167f5294-9267-4452-bb64-8f2c7cf8c197", "metadata": {}, "source": [ "---\n", @@ -15,6 +16,7 @@ }, { "cell_type": "markdown", + "id": "ee6e62c6-db46-4fb4-b429-efa2df579bb8", "metadata": { "tags": [ "version-info" @@ -43,6 +45,7 @@ }, { "cell_type": "markdown", + "id": "bec2cbd3-d243-4a55-a586-af7480c0c58c", "metadata": {}, "source": [ "Dynamic circuits are powerful tools with which you can measure qubits in the middle of a quantum circuit execution and then perform classical logic operations within the circuit, based on the outcome of those mid-circuit measurements. This process is also known as _classical feedforward_. While these are early days of understanding how best to take advantage of dynamic circuits, the quantum research community has already identified a number of use cases, such as the following:\n", @@ -54,6 +57,7 @@ }, { "cell_type": "markdown", + "id": "558350d9-4d25-478f-876d-0fd5ad4d6aab", "metadata": {}, "source": [ "This guide demonstrates the functionality available in the Qiskit SDK for performing classical feedforward and control flow. These features are sometimes referred to collectively as \"dynamic circuits.\" Classical feedforward refers to the ability to measure qubits in the middle of a circuit and perform additional quantum operations that depend on the measurement outcome. Qiskit supports four control flow constructs for classical feedforward, each implemented as a method on [`QuantumCircuit`](../api/qiskit/qiskit.circuit.QuantumCircuit). The constructs and their corresponding methods are:\n", @@ -79,6 +83,7 @@ { "cell_type": "code", "execution_count": 1, + "id": "101aaa8f-7061-4924-9b50-806d7e1ab728", "metadata": {}, "outputs": [ { @@ -114,6 +119,7 @@ }, { "cell_type": "markdown", + "id": "4daeddea-bf3a-4420-9dd2-f6e5f824e8a3", "metadata": {}, "source": [ "The `with` statement can be given an assignment target which is itself a context manager that can be stored and subsequently used to create an else block, which is executed whenever the contents of the `if` block are *not* executed.\n", @@ -124,6 +130,7 @@ { "cell_type": "code", "execution_count": 2, + "id": "1f6737fe-bc45-4d0c-b7b4-1096e2d7e14a", "metadata": {}, "outputs": [ { @@ -160,6 +167,7 @@ }, { "cell_type": "markdown", + "id": "2d13f95d-fe97-421e-96b2-87654fa6eed3", "metadata": {}, "source": [ "In addition to conditioning on a single classical bit, it's also possible to condition on the value of a classical register composed of multiple bits.\n", @@ -170,6 +178,7 @@ { "cell_type": "code", "execution_count": 3, + "id": "37ec3fa6-04b5-4165-b8d2-bae5fd238331", "metadata": {}, "outputs": [ { @@ -205,6 +214,7 @@ }, { "cell_type": "markdown", + "id": "56d5fa19-ec32-4488-a941-10c2a778351d", "metadata": {}, "source": [ "## Switch statement\n", @@ -215,6 +225,7 @@ { "cell_type": "code", "execution_count": 4, + "id": "fc2bc3c3-eab1-41f0-b696-5e8b30155d55", "metadata": {}, "outputs": [ { @@ -252,6 +263,7 @@ }, { "cell_type": "markdown", + "id": "eb51c4e3-f56c-48ae-9ce7-5376f660c627", "metadata": {}, "source": [ "Because the example above used a single classical bit, there were only two possible cases, so we could have achieved the same result using an if-else statement. The switch case is mainly useful when branching on the value of a classical register composed of multiple bits, as demonstrated in the following example. Here, we also show how to construct a default case, which is executed if none of the preceding cases are. Note that in a switch statement, only one of the blocks are ever executed. There is no fallthrough.\n", @@ -262,6 +274,7 @@ { "cell_type": "code", "execution_count": 5, + "id": "a5d43b4c-c538-4f34-8cf3-92c2c0d26fdd", "metadata": {}, "outputs": [ { @@ -302,6 +315,7 @@ }, { "cell_type": "markdown", + "id": "9851ed6c-6060-4892-9082-782f5205f718", "metadata": {}, "source": [ "## For loop\n", @@ -314,6 +328,7 @@ { "cell_type": "code", "execution_count": 6, + "id": "53a26ce5-3564-47a0-8803-c9c46db86923", "metadata": {}, "outputs": [ { @@ -346,6 +361,7 @@ }, { "cell_type": "markdown", + "id": "59256f23-82f8-403e-9ab0-20b44b2eab3a", "metadata": {}, "source": [ "## While loop\n", @@ -358,6 +374,7 @@ { "cell_type": "code", "execution_count": 7, + "id": "174a9675-3c8b-4b5e-808e-f7e0f8b9c805", "metadata": {}, "outputs": [ { @@ -395,6 +412,7 @@ }, { "cell_type": "markdown", + "id": "03f8666a-1af9-46eb-96ed-f49189a7e6e5", "metadata": {}, "source": [ "## Classical expressions\n", @@ -410,6 +428,7 @@ { "cell_type": "code", "execution_count": 8, + "id": "5d168ba7-9765-4b13-9056-59b523a73915", "metadata": {}, "outputs": [], "source": [ @@ -470,6 +489,7 @@ { "cell_type": "code", "execution_count": 9, + "id": "d2fdf38a-e874-4de1-9a79-08aab97f9ecc", "metadata": {}, "outputs": [ { @@ -490,6 +510,7 @@ }, { "cell_type": "markdown", + "id": "da7af15b-678b-4d0b-a8e7-f377bf0b81c4", "metadata": {}, "source": [ "\n", @@ -505,6 +526,7 @@ { "cell_type": "code", "execution_count": 10, + "id": "f76db731-afa1-4777-9482-25376aa86175", "metadata": {}, "outputs": [ { @@ -552,6 +574,7 @@ }, { "cell_type": "markdown", + "id": "df4b77c8-3680-4ea2-8ad8-c74125dd5709", "metadata": {}, "source": [ "## Next steps\n", @@ -566,7 +589,7 @@ ], "metadata": { "kernelspec": { - "display_name": "Python 3 (ipykernel)", + "display_name": "Python 3", "language": "python", "name": "python3" }, @@ -580,7 +603,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.12.3" + "version": "3" } }, "nbformat": 4, From e7c7adffdb00745c246e73e50344eb5979a1a158 Mon Sep 17 00:00:00 2001 From: Becky Dimock Date: Wed, 3 Jun 2026 14:59:06 -0500 Subject: [PATCH 7/9] squeaky --- ...assical-feedforward-and-control-flow.ipynb | 27 ++++++------------ ...01aaa8f-7061-4924-9b50-806d7e1ab728-0.avif | Bin 0 -> 2536 bytes ...74a9675-3c8b-4b5e-808e-f7e0f8b9c805-0.avif | Bin 0 -> 3382 bytes ...f6737fe-bc45-4d0c-b7b4-1096e2d7e14a-0.avif | Bin 0 -> 2711 bytes ...7ec3fa6-04b5-4165-b8d2-bae5fd238331-0.avif | Bin 0 -> 2876 bytes ...3a26ce5-3564-47a0-8803-c9c46db86923-0.avif | Bin 0 -> 1942 bytes ...5d43b4c-c538-4f34-8cf3-92c2c0d26fdd-0.avif | Bin 0 -> 4292 bytes ...2fdf38a-e874-4de1-9a79-08aab97f9ecc-0.avif | Bin 0 -> 7222 bytes ...76db731-afa1-4777-9482-25376aa86175-0.avif | Bin 0 -> 4576 bytes ...c2bc3c3-eab1-41f0-b696-5e8b30155d55-0.avif | Bin 0 -> 3372 bytes 10 files changed, 9 insertions(+), 18 deletions(-) create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/101aaa8f-7061-4924-9b50-806d7e1ab728-0.avif create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/174a9675-3c8b-4b5e-808e-f7e0f8b9c805-0.avif create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/1f6737fe-bc45-4d0c-b7b4-1096e2d7e14a-0.avif create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/37ec3fa6-04b5-4165-b8d2-bae5fd238331-0.avif create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/53a26ce5-3564-47a0-8803-c9c46db86923-0.avif create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/a5d43b4c-c538-4f34-8cf3-92c2c0d26fdd-0.avif create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/d2fdf38a-e874-4de1-9a79-08aab97f9ecc-0.avif create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/f76db731-afa1-4777-9482-25376aa86175-0.avif create mode 100644 public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/fc2bc3c3-eab1-41f0-b696-5e8b30155d55-0.avif diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 75579e5f541..0d16ca5c0b6 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -88,9 +88,8 @@ "outputs": [ { "data": { - "image/png": "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", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 1, @@ -135,9 +134,8 @@ "outputs": [ { "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAkEAAADuCAYAAAA+0dO/AAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjksIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvJkbTWQAAAAlwSFlzAAAPYQAAD2EBqD+naQAAK09JREFUeJzt3XtcVHX+P/DXmQGGuyiogAiIiIrKRYVQ8YKr5l3D1S2vlZdvtpW2/aRd16zNVjPNykqz/dpqtpF91ZVCLUkUjdRQRF3NvIJyGQXxAogwl/P7g2VyZFBmHDjDnNfz8eCh53PO+cybcpgXn/M5nyOIoiiCiIiISGYUUhdAREREJAWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgIiIikiUHqQsg6xFFEaiqkroM86hUEATBat2JogidTme1/pqCUqm06n8DIiJqGIYge1JVBe2kGVJXYRaHrzcCzs5W60+n02Hr1q1W668pTJgwAQ4OfCsSETU1Xg4jIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIInoAvV6P0tJSqNVqXLt2DRUVFWadX1lZiZSUFOj1+kaqkIiILMUHFt0nNzcXe/bsQVZWFrKysnDy5EloNBrMmDEDGzZskLo8amSiKOLMmTM4fPgwLl68iLy8PFTd91BaHx8fhISEoEuXLoiPj4enp6fJviorK/H222/j119/RUFBAZ577jkoFPy9g4jIVjAE3ef999/HBx98IHUZ1MS0Wi3S09Oxe/du5OfnP/DYkpISlJSU4Oeff0ZycjL69OmDUaNGISgoyHDMvQEIALKzs1FcXIy2bds26vdBREQNxxB0Hx8fH4wcORIxMTHo3bs3du3ahTVr1khdFjWivLw8rF27Frm5uXX2tWnTBu3bt4eLiwv0ej2uX7+O3Nxcw+iQRqPB/v37kZmZifHjx+OJJ56ARqMxCkDu7u7461//ygBERGRjGILus2jRIqPtQ4cOSVSJdDJKrmHowX14OzwCf+rYxeQxTt9+jZFt/LD9sf5NXJ117dixA19++SV0Op2hrXPnzhg6dCiioqLg7u5e5xy9Xo8rV65g//792LdvHyoqKqDT6bB161YcPnwYTk5OuHjxIoDfAlCHDh2a7HsiIqKGsfsJCiUlJUhKSkJoaCicnZ3Rvn17zJs3DxUVFZg5cyYEQcBHH30kdZnUxERRxFdffYVNmzYZAlBAQACWLFmCv/3tb4iPjzcZgABAoVAgKCgI06ZNw9q1azFhwgQolUoAQH5+PgMQEVEzYdcjQTk5ORgxYgTUajXc3NwQHh6OwsJCrF69GhcuXEBpaSkAICoqStpCqcl9++232L59u2F7zJgxmDRpEhwdHc3qx8nJCRMnTkSPHj2wdOlSVFdXAwAEQcCLL77IAEREZMPsdiSopKQEY8aMgVqtxiuvvIKioiJkZ2dDrVZj+fLl2LFjB7KysiAIAiIiIqQul5rQuXPnkJycbNh++umnMWXKFLMDUK3KykokJycbAhBQM9K0c+dOiKL4yPUSEVHjsNsQ9NJLLyE/Px8vvPACVq5cCQ8PD8O+pKQkREZGQqvVIjg4uN5bnOXujk6Hkqoqk1/NVXV1NT755BNDOElMTMTw4cMt7u/+u8Dc3NwM/9aOHz+OvXv3PnrRRETUKOwyBP3yyy/YvHkzfHx8sGzZMpPH9OrVCwAQGRlplde8dOkSxo4dCw8PD7Rs2RLTp0/H9evXrdK3VN789RT8d6eY/Gqudu7ciYKCAgBASEgIJkyYYHFf9wcgd3d3LFq0CM8//7zhmE2bNuHOnTuPVjQRETUKu5wTlJycDL1ejylTptQ7udXFxQWAdUJQWVkZEhIS0KpVKyQnJ6OyshJJSUkYPXo0MjMzLV4gr3fv3lCr1Q0+3kWhwOmoPha9limzAkMwwb+9yX0jDmVY5TXCwsJQacXVlJ2cnOoNvjqdDrt37wZQM2fnueeeM0xoNpepAHTvJOj4+Hj8+OOPqKysxP79+x842hQWFmZ0KY2IiBrO19cXR44csehcuwxB6enpAICEhIR6j6ldEM8aIejTTz9FQUEB9u/fj8DAQAA1dxr17dsX33zzDcaPH29Rv2q12jBq0RCuSiUQZdFLmRTq7o7ftW7ctW0KCwtx557b0x+VSqWqd9/Ro0cNk+F79uxp+H9lrocFIAAYO3YsfvzxRwBAWloaHn/8cQiCYLK/wsLCOqtSExFR47PLEJSXlwcARiv43kur1SIzMxOAdUJQamoq4uPjjT5U+/Tpg5CQEHz77bcWhyBfX1+zjndpho9k8Pf3t/pIUH1++uknw9+HDh1qUf8NCUAAEBgYiC5duuDMmTMoKChAXl4egoODTfbp7+/PkSAiIguZ+1l5L7sMQbUPuaysrDS5f/PmzSgpKYGHh4dVbmE+ffo0Jk6cWKe9W7duOH36tMX9mju8J969C+2kGRa/nhTOnj0LwdnZav1ptVps3brV5L7a9XtUKpVFdwQ2NADViomJwZkzZwyvXV8IOnv2LBwc7PKtSERk05rf0EED1KbC7OzsOvuKioqwYMECAEBERES9lyjMcePGDXh5edVpb9WqleHyC0mrvLwc165dA1AzQmjuPC1zAxAAo321AYyIiGyHXYagIUOGAACWL1+Os2fPGtqzsrKQkJCAkpISAFwkUU4KCwsNf6/vMml9LAlAAIxGfsyZ20VERE3DLkNQUlISvL29ceXKFXTr1g09evRAp06dEBsbi5CQEAwePBiA6flAmZmZ8PHxMXytWrUKAPDVV18ZtdfOKQKAli1b4ubNm3X6Ki0tRatWrRrnmySztWnTBi1btjTr/0lVVZVFAQiouQOxRYsW8Pb25lpUREQ2yC4nIgQEBODAgQNYsGABMjIykJubi/DwcKxbtw6zZ89Gx44dAZgOQRqNxuT6PlVVVUZ38Gg0GsPfu3btanLuz+nTpzFgwABrfEtNaqBPG1SPmfTAYx6239aEhYVh9erVZp/n6OiIwMBA/Prrr2Y/C0wQBKxbt87s1yQioqZhlyEIqAkmqampddrLy8uRm5sLhUKB7t2719k/aNAgsx91MHr0aCxcuBD5+fkICAgAABw+fBgXLlzAihUrLPsGyCYoFAo888wzcHZ2Rt++ffksMCIiO2KXl8Me5NSpUxBFEZ06dYKrq6tV+pwzZw78/Pwwbtw4pKamYsuWLXjqqacQGxuLcePGWeU1SDoKhQJTpkxhACIisjOyC0EnT54EYL3HZQCAp6cn0tPT4efnhyeffBKzZs1C3759kZqaavFq0URERNS47PZyWH0aIwQBQMeOHU1efiMiIiLbJLthisYKQURERNS8yG4kqPa5YkRERCRvshsJIiIiIgIYgoiIiEimGIKIiIhIlhiCiIiISJYYgoiIiEiWGIKIiIhIlhiCiIiISJYYgoiIiEiWGIKIiIhIlgRRFEWpiyDrEEURqKqSugzzqFQQBMFq3YmiCJ1OZ7X+VqzbjLKKCni4uWHB//yhzrY1KJVKq/43ICKihpHdYzPsmSAIgLOz1GVIShAEODhY75+1CEAv1vzp4OBQZ5uIiJovXg4jIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZ4pK3RER2RtTrgbJy40YPdwgK/t5LdC+GICI7Jl69BvGXXyGWlwMardTlUBMR796FmLzFqE146vcQZP5YnWZDpYLg1QJCRDcI7u5SV2PXGIKI7Ix49y70u9Ig/ngQ4rkLUpdDNkJM3gI+LbuZcVBCiOwBxYB4CIPi+aDlRsAQRGRHxLt3oVuyHOLJ01KXQkSPSquDeDQHuqM5UFy8BMWz0xiErIwXiInsBAMQkf3Sp+yA/rNNEEWO51kTR4KI7IQ+9TvTAcjDA0JgAKBSAfwlUhZEjRY48R/jxojuEBz5I9/m6UWgshLihUuARmO8K2UHhD6xEMK7SFSc/eE7gshO6DMPGTd4uEM5/48QoiMgOPCtLifirdvQTptt1OawYB6EFp4SVUTmEu9UQv/DXug/+7wmGNW2Zx4CGIKshpfDiOyAWKQGLlwyalP+6QUoYnoyABE1Q4KrC5RjR0KROM6oXf/T4ZolEMgq+NORyA6Ip88YN7TwhBAVIU0xEhNFEaiqkrqMhlOpONnVikRRxJ3K5rUchKuLQ73/BhSD4qHfsv23huulwLViwLdtvf2JogidTmflKhuXUqmU5H3AEERkB8TyCqNtISgQglIpUTUSq6qCdtIMqatoMIevNwJcv8dq7lRq4R73udRlmKX80HS4uTqa3tk+AHBQAtrfQo1YVg7hASFIp9Nh69at1i6zUU2YMAEOEoxa83IYkT2orjbeVjlZreu9e/ciLi4OHh4eEAQBGzZssFrf1LwIgoCnn35a6jJkRRAEQHVfSL7//U4WYwgiskcWDCsPGjQI7vetTnvjxg0kJiaioqIC7777LjZt2oQBAwZYq0qyAfv27YMgCPV+SfHbOd2HV0sbDf91E1G9srKycPPmTaxfvx6JiYlSl0ON6KmnnsLIkSPrtCv4vDGyYwxBRFQvtVoNAGjVqpXElVBj69mzJ6ZOnSp1GURNihGfiEwKDg7GjBk1E4wTEhIMl0eI7rVjxw4MHDgQPj4+cHFxQWBgIBITE3H27Fmj44qKijB37lwEBgbCyckJ/v7+mDNnDq5duyZR5UQcCSKierz//vvYtWsXPv30UyxcuBBdu3aVuiRqRHfu3EFJSUmddicnJ3h6ml5kMSMjA2PHjkX37t3xl7/8BV5eXigsLMQPP/yA8+fPIywsDABw+fJl9OnTB9XV1Zg5cyY6duyI8+fPY+3atdi7dy+OHDmCFi1aNOr3R2QKQxARmTR+/HjcvHkTn376KYYOHYpBgwZJXRI1otdffx2vv/56nfZRo0YhNTXV5DkpKSnQ6/VIS0tDmzZtDO2vvfaa0XEvvvgiNBoNjh07hoCAAEP7xIkTERcXh/feew9vvPGGdb4RIjMwBBEREebMmYOJEyfWaW/dunW959SO3mzduhWzZ882eSfZrVu3kJqaimeeeQbOzs5Go03BwcEIDQ3F7t27GYJIEgxBRESETp06YciQIWad88ILLyAlJQXPP/88Xn31VcTHx2P48OF46qmnDOHp119/hV6vx/r167F+/XqT/YSEhDxy/USWYAgiIiKLeHt7IysrCwcOHEBaWhr279+Pl19+Ga+//jp27tyJPn361DzGBMDUqVMNE+3v5+Li0pRlExkwBBERkcWUSiUGDRpkmDN24sQJ9OrVC2+99RZ27NiB0NBQCIKA6upqs0eayD6IooiSkpIHXlqVCkPQfXJzc7Fnzx5kZWUhKysLJ0+ehEajwYwZM/i4ACKie5SUlMDHx8eorUuXLnBxcUFpaSmAmtGikSNHYtu2bTh06BDi4uKMjrflD0g50+l0yM3NxcWLF3Hp0iVcu3YNGo0GSqUSHh4e6NChAzp06IDQ0FC4ubnV248oikhOTkZaWhoWLlyITp06NeF38XAMQfd5//338cEHH0hdBhFRk8rOzsYXX3xhct/48ePrPFIFAGbPno38/HwMGzYMQUFBqKysxObNm1FWVobp06cbjlu7di3i4+MxYMAATJ8+HdHR0dDr9bh48SJSUlIwffp0Toy2ETdu3EB6ejr27NljCLKmHD58GADg6OiIvn37YtiwYejYsaPRMbUB6JtvvgEALFu2DO+//369Sy5IgSHoPj4+Phg5ciRiYmLQu3dv7Nq1C2vWrJG6LCKiRpWcnIzk5GST+86dO4fQ0NA67dOmTcOGDRuwceNGFBcXw9PTE+Hh4diyZQsmTJhgOK59+/Y4evQoli9fjpSUFHzxxRdwdnZG+/btMWbMGEyaNKnRvi9qGK1Wi23btiElJQU6ne7hJ/yXRqNBRkYGMjIyEBERgTlz5sDHx6dOAAKAyZMn21QAAhiC6li0aJHR9qFDhySqhKhp7du3r07b008/LdunhmeUXMPQg/vwdngE/tSxi8ljnL79GiPb+GH7Y/2buDrrGTRokGHy8sPcf1xiYmKDnynn4+ODFStWYMWKFWbXKJW/v9QLC2dF4dnF+/HP7efq7N+7fiT6RLZBrydTcOr8DQkqtI68vDx8/PHHuHz5sqFNEARER0ejR48eCAkJQUBAAFQqFXQ6HYqLi3Hx4kWcO3cOP/30EyoqKgDUzAdbsGABpk6diqtXrxoFoFmzZtnknDC7f2xGSUkJkpKSEBoaavjNY968eaioqMDMmTMhCAI++ugjqcskIiIb88aaYzh5rhSr/t9jaNfW1Wjf/KndMCjGD6+vyW7WAejkyZNYvHixIQAplUqMGjUKq1evRlJSEkaMGIHOnTvDzc0NDg4OUKlUCAgIwIABAzBz5kysWbMGc+bMMTxfsLKyEv/4xz+aRQAC7HwkKCcnByNGjIBarYabmxvCw8NRWFiI1atX48KFC4brnVFRUdIWSkRENkej1WPGov04/MVYrH+jP4bP/R4AEBbcAn9/sTcOnbiGFRtOSlyl5U6fPo133nkHGo0GABAUFIS5c+ciODi4wX2oVCoMHjwYjz32GD7//HNkZGQY7Z85c6bNBiDAjkeCSkpKMGbMGKjVarzyyisoKipCdnY21Go1li9fjh07diArKwuCICAiIkLqcomIyAYd++U6lq0/jsf7BWD2hM5QKAR8/vcBEARgxqL90OsbdinR1pSWluLdd981BKDevXtjyZIlZgWge7m6upp8/ptKpXqUMhud3Yagl156Cfn5+XjhhRewcuVKeHh4GPYlJSUhMjISWq0WwcHBNjdRi4hsxx2dDiVVVSa/SB6WfHoMOWeuY+UrsfjwL33wWI82+OuHR3E295bUpVlEFEX84x//MMzliYqKwvz58+Hk5GRxf/dPgq61cePGB95lJjW7DEG//PILNm/eDB8fHyxbtszkMb169QIAREZGPvLr1Yat2NhYqFQqCILwyH0SkW1489dT8N+dYvKL5EGrFTFj0X44q5R4/g9dcSBbjfe/+I/UZVnswIEDOHbsGADAy8sLL7zwgsnnvjWEqQA0a9YsxMfHAwAqKirqfVyKLbDLOUHJycnQ6/WYMmWKybUtgN+WabdGCDp//jy2bt2KmJgYODk5ITMz85H7BGqGJ9VqtVX6Iss88cx8uLl7okhdhICAgDrbtmJu23ZIahds2E7bnYbZn6yWriAJuSgUOB3Vx2r9zQoMwQT/9ib3jTiUYbLdHGFhYajU6x+5n3u1cnDA0YjHjNoiIyNQqtVa9XVskR6OQKtFDz/QTLfKq1FVrYOToxI7D1xBA2+oa5BOYWFQQFPv/mMRsfBycDRsT0icgKyK2/Ue7+TkVO8AgCiK2L59u2F79uzZ9X5OPkx9AWjIkCGIi4vDyZMncevWLRw9ehRXrlxB+/am30dAzfugurraojp8fX1x5MgRi861yxCUnp4OAEhISKj3mPz8fADWCUEDBgxAUVERAOCNN96wWghSq9UoKCiwSl9kGf1/18vQ63QoKCios20rbrt4AO1+2757t9Km6mtKrkolEGW9/kLd3fG71m2t1+F9CgsLcceMdVkaospJBdw31bGoSI2SahlcwhOcgFbW7/afb/aHk6MSpy/cwKI5Ufj6+0u4mF9mlb6LCgsBsf4AoO9uHJKLS4pRUFpS7/EPmodz+vRpFBYWAqhZ3bv2qoi5HhSAAMDd3R3jx4/Hxo0bAQBpaWl49tln6+2vsLAQVRJcYrbLEJSXlwegZqa7KVqt1hBUrBGCFIrGuaro6+vbKP1SwymUSsOf7dq1q7NtK+6f1+bs7GJT9TUll0Z6PzYWf3//RhkJup+fny9UMhkJKrJyny9ODkdCrD8Wrj6ClL15yN48Hp+92R+Dnt1plf79/P0fOBJ0/2dMa5/WaOdSf9B50NyePXv2GP4+bNgwM6r8zcMCUK2BAwfiq6++QlVVFQ4cOICpU6fWW5u/v/8jjQRZyi5DUO1kr8rKSpP7N2/ejJKSEsPzT2yVpcN7ZD1LP/4XbpdXwM/XD/n5+XW2bYXu//4N/aavDNtDhw1F/qI0CSuSjnj3LrSTTD+t3BadPXsWgrOzVfsUb92Gdtpso7bjx09AaGH/N4FU3NHAPe5zq/UXGuiJZfN64+eTxVj+2Qno9SLeWJuNZfNi8OLkcHz45elHfo1zZ8/CzdWx3v2ayc8C5RWG7a3btkLRrWu9x2u1WmzdutXkvjNnzgComRISGxtrdq0NDUBAzR1jMTEx+PHHH1FZWYm8vLx6nx129uxZi+clPYrm9StTA9Wmwuzs7Dr7ioqKsGDBAgBAREQEJzETEZFJggBsWDIASoWAGYsyDLfDv/PPk8j6TzGWzeuNkACPh/RiO27evGm4U6tDhw5mhw5zAlCte0PPpUuXzKy48dllCKr9H7J8+XKcPXvW0J6VlYWEhASUlNRcS+UiiUREVJ9XZvRAv+i2WLwmG2cu/XY7vF4v4unX9sNBqcBnbzafR6bUThUBYPZVEEsCEACEhIQY/s4Q1ESSkpLg7e2NK1euoFu3bujRowc6deqE2NhYhISEYPDgwQBMzwfKzMyEj4+P4WvVqlUAgK+++sqo3VqTn4mIyPZ06dACS/7YEwePX8O7G+veDn/6wk28sTYbA3v74cXJ4RJUaL7y8nLD3729vRt8nqUB6P7XqZ2qYkvsck5QQEAADhw4gAULFiAjIwO5ubkIDw/HunXrMHv2bHTs2BGA6RCk0Whw/fr1Ou1VVVVGM9drV9kkIvs00KcNqsc8+OnmD9tPzdeZS7fgErPxgce8vf4E3l5/ookqenTdu3fHa6+9Bo1GA39//wafd+vWLaPHYZjzLDAPDw8kJSXB0dERLVu2NLvmxmaXIQgAunbtitTU1Drt5eXlyM3NhUKhQPfu3evsN+eJykRERM1FixYtTD7a4mG8vLzw2muv4a233sLvf/97s54F5ujoiJ49e5r9mk3FbkNQfU6dOgVRFBEWFgZXV9eHn9BAW7ZsAVCzBsO928HBwejdu7fVXoeIiKipBQQEYNWqVVb93LQFsgtBJ0/WPPHXGusD3WvixIkmt2fMmIENGzZY9bWIiIiamr0FIIAhyGp4CY2IiKh5scu7wx6ksUIQERERNS+yGwmqfa4YERERyZvsRoKIiIiIAIYgIiIikimGICIiIpIlhiAiIiKSJYYgIiIikiWGICIiIpIlhiAiIiKSJYYgInvEFcyJ7Affzo2GIYjIHjg5GW9XVUtTBxFZlSiKQNVd48b73+9kMdmtGE1kjwR3d6Nt8VIeRJ0OglIpUUUSUqng8PVGqatoOJVK6grsiquLA8oPTZe6DLO4ujzgo/jyFUCrM2oSPNzrObiGUqnEhAkTrFEaAGDFus0oq6iAh5sbFvzPH+psW4NSop9VDEFEdkDo1sW4oawMYnYOhJhe0hQkIUEQAGdnqcsgiQiCADdXR6nLsBr93gPGDT7eQJvWDzxHEAQ4OFjv410EoBdr/nRwcKiz3ZzxchiRHRB820IIDTFq0733MfSHsiBqtBJVRUSWEsvLofv3t9D/+1ujdkXfxyAo+NFtLc07whGRgdAvDuL5i781lFdAt3Ql4OYKoX0AoHICIEhWHzUdUVs3+GrfXgWhmf/WLguiCNy5AzE3r85lMKDmfU7Ww3cEkZ1QjB4OMecExOP/Md5RcQfimbPSFEW249QvvMmomVMkjoXQJUzqMuwKx9SI7ISgUkG5KAlCZHepSyEiK1MkjoVixuSaOW9kNRwJIrIjtUFI/90PEDMPcQSIqDlzdIQQHQnFwH4Q4vswADUChiAiOyOoVFCOGwWMG4UP13+NstvlcFcq8Meg1vg49xrKtTq4Oyjxx+A2UpdKRCYILi5AC08IPcIhuLpKXY5dYwgismNldzW4Xa0F3N2gHDcK5R//C7fvVgDOLjVBiYhIxjgniIiIiGSJIYiIiIhkiSGIiIiIZIkhiIiIiGSJIYiIiIhkiSGIiIiIZIkhiIiIiGSJIYiIiIhkiSGIiIiIZIkhiIiIiGSJIYiIiIhkiSGIiIiIZIkhiIiIiGSJIYiIiIhkiSGIiIiIZIkhqBlbsWIF+vTpg5YtW8LLywvx8fH47rvvpC6LHmLnzp2IioqCSqVCcHAwVq1aJXVJRERNZv/+/Rg3bhyCgoIgCALeeustyWphCGrG0tPT8eyzz2Lv3r34+eef0bdvX4wePRqZmZlSl0b1OHLkCMaNG4cRI0YgJycHb7zxBhYuXIhPPvlE6tKIiJpEeXk5wsPD8c4778DX11fSWhwkfXV6JLt27TLafuedd/Ddd99h27Zt6Nevn0RV0YOsWrUKMTExWLZsGQCga9euOHXqFN5++20899xzEldHRNT4Ro4ciZEjRwIAXn31VUlrYQiyI3q9Hrdv34abm5vUpTQ7JTduofRmWZ12rU5n+PPspfw62/fqGOQPpeLBg6uZmZmYOXOmUdvw4cOxcuVK5OfnIyAg4FG+DSIii10tLsWt8jt12hv6c1ChENAx0B+CIDRNwVbAEGRHli5dips3b2LOnDlSl9LsKAQBX2xPQ3W1xuT+O5V38dnXO+vdfiyqK8I6PDzAFBUV1Rn+rd0uKipiCCIiyWj1emzYsgt6vWhy/8N+Dg7p1wuhQe0avU5r4pwgO7FmzRosXboUW7Zs4QepBVp5eWLs7/padK63lydGJsRZuSIioqbVrq0Phsb3tujcAL/WSOgTbeWKGh9DkB1YuXIlFixYgG+++QZDhgyRupxmq1ePMIR3CjLrHEEQMGl0AlROjg063s/PD2q12qjt6tWrhn1ERFIa8FgkAv3bmnWOo4MSfxiVAKWy+UWK5lcxGVm8eDH+9re/YefOnQxAj0gQBCQ+PgDuri4NPmdQXBSC2jX8B0a/fv3w/fffG7V99913CAoK4ggeEUlOqVBg0uhBcHJs+GyZkQlxaO3t1XhFNSKGoGZs/vz5WLFiBTZt2oTOnTtDrVZDrVbj1q1bUpfWbLm7uSBxxIAGHduurQ9+16+nWf2//PLL+Pnnn/HXv/4VZ86cwcaNG/Hhhx/iz3/+syXlEhFZnU/LFhg1uE+Djg3rEIC46HCz+i8vL0dOTg5ycnJQXV0NtVqNnJwcnD9/3pJyHwlDkAX0ej127dqFN998E2PHjoWfnx8EQYAgCMjNzW2yOj744APcvXsXTzzxBPz8/Axf8+bNa7Ia7FF4aBBiIro88BgHpRKTRifAQak0q++YmBhs374dqampiIyMxOLFi/H3v/+dt8cTkU2JjeyCLh0DH3iMi7MKvx8x0Oy7wY4cOYLo6GhER0ejqKgIH3/8MaKjozFr1qxHKdkivDvMArdv3zascSAlUTQ9g9+U3Hw1/Nv6mDXEKWejB8fhQl4BSm/VvW0eAIYPikVbn5YW9T1q1CiMGjXqUcojImpUgiBgwvABeO+z/8OdyiqTxzwxLB6eHuYvyTJo0CCzPr8aEz8RLaBQKBAVFYWYmBj07t0b0dHRiI2NlbqselVU3sVn/7cLTg4OmDttHLy9PKUuyeapVE6YNDoB6778ts6bNTSoHfr26i5RZQ1XVlaGwwd+wM+Ze3H7ZilWvT4Pjs5u6BoZi74DOX+MiB7Mw90ViY8PwBfb0+rsiwoPRUTXjhJUZV0MQRbw9PTEsWPHDNtarVbCah7ux6wTqK7WwNvLE61aeEhdTrMRHOCLgY9FYt+hHEObs8oJvx85EAobXwzsiy++wNy5c1FeXm5ou1MOANehLriMA2kp8HGqxPz586UqkYiage6dO6Bn9zBk/+esoa2FhxvGDrWPpxJwTtA9dDodNm3ahGHDhqF169ZQqVQIDAzE8OHD8b//+7/Q/XeVzOakovIuMo+eAlCzkFVzWsnTFgyJ7wW/Nt6G7XFD+8HL013Cih7u008/xbRp04wC0P20Gg1efvllLFmypAkrI6LmaOyQvkY/9yaOHARXZ5WEFVkPQ9B/3b59G0OHDsX06dORlpYGJycnREZGQq/XY/fu3Zg9ezbKykzPD7FltaNAfm28zV4Dh2omQP9hdM36FxFdQhAVHip1SQ904sQJzJ07t8HHL168GHv27GnEioiouXNWOWHSqEEQAPTr1R2hwc1rVegHEURbmZ0ksYkTJxpWW/7888+RkJBg2Hf16lWsX78e8+bNM/lcLq1WC0fHmsXyLl26hODgYKvU9OHGbSgrr7T4fFEUUVZR8xwYV2cVHBx49dNS1RoNHB0cbH4k7d9frseRn/aadU6XHj0x7X/+1EgVEZG9sNWfgx7uLnhxRqJF5/JTEcDRo0exZcsWODg4YNeuXeje3XjSa9u2bbFw4cImr6usvBK3yyus0tedu1UATM/wp4a5W1UtdQkPVHW3EsezMs0+79f/HEN+/hV4erVqhKqIyJ7Y+s9BczEEAdi+fTuAmluX7w9AUvJwb/jKxffjKJD8XC4ugkZj/g8oURRxu/QaAgLaN0JVRESN61E+K/nJCOD06dMAgD59GrZCZlOxdHgPAL7f/zP2HsyBXxtvvPR0os0NX5L1paenY927lp07cmBvTJ482boFERHZOIYg1EyKBoAWLVpIXIkxS+cE3TsKdOt2OZat+dLapZENKrh8yeJzv//xGHJvcHogETU/nBP0iDw9axYPtLVnblljThDnAsmHawtvuHt6ofz2TbPOc3RSoVXbAKvNPyMiai4YggB069YN27Ztw8GDB6UuxYgl1zk5F0jeYuMHI33nNrPOiX4sHq19fBqpIiKixvUoc4J4izyAY8eOoWfPnnB0dEROTg7Cw817Im5j3SJvCc4Fkje1Wo2IiAgUFxc36Hg3NzccPXoUnTt3buTKiIhsDxdLBBAdHY1JkyZBo9FgxIgRyMjIMNp/9epVLFu2DBUVtn25gKtDk6+vL1JTUxs0v83Z2Rlbt25lACIi2eJI0H/dvn0b48aNw759+wAA7dq1g7+/P4qKilBQUABRFHHjxg14eXkBAMaNG4fMzN/WZLl+/ToAoGXLllAoarJlv379kJKS0mTfA0eBqNapU6fw0ksvIT093eT+uLg4vPfee4iLi2viyoiIbAcnjPyXp6cnfvjhB2zcuBGbNm3C8ePHcfz4cfj6+uLxxx/HxIkT4eHx28NHb926ZQg+97px44bRMU3JzcUFrs4qjgIRunXrhj179uCXX37Bhg0bkJeXB1EU4e/vj2nTpqFnz55Sl0hEJDmOBNmZqqpqODk5MgQRERE9BEMQERERyRInRhMREZEsMQQRERGRLDEEERERkSwxBBEREZEsMQQRERGRLDEEEdmgpUuXonPnzlAoFNi+fXuDzklNTUWXLl3QqVMnJCYm4vbt22a95rVr1zB8+HB06tQJ3bt3x/79+x96Tnl5OR5//HH4+PgYFhIlImouGIKIbNCQIUOwa9cuDBgwoEHHl5eXY+bMmdi+fTvOnTsHf39/LFmyxKzX/POf/4y4uDicO3cO//znPzF58mRoNJoHnuPo6IhXX30VP/zwg1mvRURkCxiCiCR28OBBxMfHIzIyEhEREUhJSUFsbCxCQkIa3MeuXbsQHR2NLl26AACef/55JCcnm1XH119/jeeeew4AEBMTA39/f2RkZKC4uBjBwcE4dOgQAGDLli2IjIxEZWUlVCoVBg8ezFEgImqW+NgMIgmVlpZi/Pjx2LJlC/r37w+9Xo+bN2+a3c/ly5cRFBRk2A4ODkZRURG0Wi0qKyvRv39/k+e1bdsW33//Pa5fvw6NRgNfX1+jPi5fvowhQ4Zg06ZNmDJlCpKTkzF//nykp6fDxcXF7DqJiGwJQxCRhA4ePIjOnTsbQopCoUCrVq2s+hoeHh7Iycl5pD769++PmTNnom/fvvj8888RFhZmneKIiCTEEERkBwIDA5GWlmbYzs3NhZ+fHxwcHFBWVvbQkSBvb284ODhArVYbRoNyc3MRGBhoOPbYsWNo3bo1rly50rjfDBFRE+GcICIJ9e3bF+fOncOBAwcAAHq9HqWlpWb3M3z4cGRnZ+PMmTMAgDVr1uDJJ58E8NtIkKmv77//3tDHxIkT8cknnwAAsrKyUFBQgIEDBwIAPvroI9y4cQPHjx/HunXrkJmZ+UjfNxGRLeADVIkkdujQIbzyyisoKyuDQqHAkiVLcPz4cXzyyScoLi6Gh4cHnJ2dDSMx9fnmm2+QlJQErVaL7t27Y+PGjWjRokWD67h69SqmTZuGS5cuwcnJCR999BESEhKQnZ2NxMREHD58GG3btsVPP/2EqVOnIisrC97e3oiIiEBxcTGuXr0Kf39/JCQkYNOmTdb4T0NE1KgYgoiIiEiWeDmMiIiIZIkTo4makd69e0Or1Rq1devWDf/6178kqoiIqPni5TAiIiKSJV4OIyIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIlliCCIiIiJZYggiIiIiWWIIIiIiIln6/25qP46CKAHVAAAAAElFTkSuQmCC", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 2, @@ -183,9 +181,8 @@ "outputs": [ { "data": { - "image/png": "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F69u5i6VdFEoINjb1QYAF2dzV2PRGAKIyGIJgoDbKg1K76gAGzvIJjyJsvVfo7SqHOjQEbIJT5q7RCKzYp8AIiIiiWIIICIikiiGACIiIoliCCAiIpIohgAiIiKJYgggIiKSKIYAIiIiiWIIICIikiiGACIiIoliCCAiIpIohgAiIiKJYgggIiKSKIYAIiIiiWIIICIikiiGgHZsy5YtCA4ORpcuXdCxY0f4+/vjo48+giiK5i6NGpGcnIygoCDY2NjAy8sLH330kblLalU//PADJkyYgJ49e0IQBLz33nvmLomoVa1btw5DhgxBly5d0LlzZzz66KPYt2+fWWqRm+WqZBLdunXDO++8g969e8PGxgZpaWlYuHAhZDIZXn31VXOXRzqcOHECEyZMwLJly7Bt2zb8/PPPWLBgAWxtbbFgwQJzl9cqysrKEBAQgOeeew6vvfaaucshanWpqamYO3cuBg4cCFtbW2zcuBHjxo3DkSNHEBYW1qq1MAS0Y6NHj6637O3tjd27d+Pw4cMMAW3URx99hIEDByI6OhoA4O/vj/Pnz2PNmjWSCQFjx47F2LFjAQArVqwwczVEre/777+vt/zBBx9g37592LlzZ6uHAN4OsBCiKOL48eNIT09HeHi4ucshPdLT0xEREVFvXUREBPLy8pCfn2+mqojInDQaDUpLS2FnZ9fq12ZLQDt369Yt9OjRAzU1NdBoNPjrX/+KxYsXm7usdqequga/FV5rsF6lVmv/zszJb7B8N1cXJzja2zZ6naKiIri6utY/7s/loqIieHh4GP0amisvX4nqO6p663S9Xn3/BrYdbeDh6tJK1RKZXuHvxSirqGqwvqm/B6zlMvR6wM3g665evRo3b97E/PnzjazceAwB7ZyDgwPOnDmDiooKHD16FG+88Qbc3d3xwgsvmLu0dkVhLcehn04j52qRzu0VlVWI356sd9mpswNenfN0i9fZkq7duInE73/Que3e16tr3eynI+49jKhdqaquwabtydDXtfp+vwfGPxFqcAj47LPPsHr1auzZs8csHwJ4O6Cds7Kygq+vL/r3748FCxYgKioKb731lrnLanesrKww5cnhsFFYG3ysIAiY9mR4k451c3ODUqmst+7333/XbjOnkId6I+DBnkYd+0iQP/r4eJq4IqLW5e3pjkcH9jfqWN+ePTAkuK9Bx8TE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", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 3, @@ -230,9 +227,8 @@ "outputs": [ { "data": { - "image/png": "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VBSSk5PRpEmTMtvp06cPPvroI/z5559o1aoV1q5di7feegtAxXvmhg8fjnXr1ikvgHj06BECAgIAAN988w2eP3+Oq1evolOnTvDz80PXrl0r/wMgIiKd4dWsRFpy/vx5TJs2DZmZmZBIJFi4cCFWrFiB9PR0GBkZwdLSEosWLUJwcPBr2/n1118xY8YMyGQyeHh4YMuWLbC2tq5wHU+ePMGYMWMQGxsLExMTfPPNNwgKCsLly5cxdOhQ/PHHH2jQoAF+//13jB49GhcuXICtrS28vLyQkpKCJ0+ewNHREUFBQdi2bVtlfyxERFTFGOaIiIiIRIxj5oiIiIhEjGPmiHSgQ4cOkMlkKsvc3d2xY8cOHVVERERixdOsRERERCLG06xEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIsYwR0RERCRiDHNEREREIvb/6neN8lmBoRcAAAAASUVORK5CYII=", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 4, @@ -279,9 +275,8 @@ "outputs": [ { "data": { - "image/png": "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1+N6gBHQIwTA5dWtW1dHjhzRypUr8/yFLkldu3bVhAkTdPz4cdWtW1eStHHjRrm5uemXX35RYmKiKlWqJEmKiopSQECAWrVqZbetsLAwvfPOO3rhhRfUr18/63HLli1r3ea1117TlClT1LhxY73wwgsKDg7W8ePHtWLFCr355pvy8vrzPqd58+bpt99+0+OPP67AwEAtWbJEY8eOVWhoqB5++OFC/b0sX75ckjRixIh87/Ppp5/qwoULGjx4sEJDQ3X27Fl99NFHuvPOO7Vp0yZ16tRJknT+/Hl17dpVkvTkk0+qZs2aSkxM1N69e/XDDz+oV69ekqTMzEz16NFD33//vR599FE9++yzunz5shYsWKCOHTtq69atef4dw7G4HnA9rgcYAUEIgMsbP368vvvuOw0YMED169fXHXfcodatWysiIkJhYWHW7XKCUFRUlDUIRUVF6eGHH9aSJUsUFRWlgQMHymKxaPPmzercubPc3d3tHrNq1aq677779MILLyg8PFyPPGI7i9Xu3bs1ZcoURUZGau3atTbD6qZNm5arvdOnT+vw4cMqV66cJOnvf/+7atasqTlz5hQ6CP3vf/9TQECA6tSpk+99FixYID8/P5tlTz75pJo0aaKpU6da3+js2LFD586d09KlSzVw4MA823vvvfe0efNmrVu3Tnff/edDAp9++mk1bdpUL7/8comfbMJVcD3gelwPMAKGxgFwee3bt9ePP/6oIUOG6PLly/rkk0/09NNPq3HjxurcubNOnDghSWrTpo3Kli2rqKgoSdKpU6d08uRJPfTQQ2ratKk2btwoSdbeoZxPNAvj888/lyRNnTo1171FOcPorjd06FBrCJIkX19ftWvXTkePHi10DUlJSfL39y/QPte/yUlOTtb58+fl7u6utm3bWocJSrLW+s033ygpKSnP9pYsWaJGjRqpZcuWSkxMtH5lZGSoe/fu2r59u1JTU/PcH47D9YDrcT3ACOgRAmAIzZo106effirpWsDZsmWLPvroI23btk19+/bVjz/+KC8vL91xxx3W6bQ3btwoDw8Pde7cWV27dtXatdceTpMTlG4lCB09etTuvUd5sfepbMWKFXX+/PlC1xAQEKArV64UaJ/jx4/rtdde07fffqtLly7ZrLs+vHXp0kWDBw/Wp59+qs8//1ytW7dWt27d9OCDD6px48bW7Q4fPqzU1FRVrlw5z2MmJiaqevXqBaoTBcf1gOtxPcAICEIADKdmzZoaPHiwHn30UXXq1Ek7duzQ7t27dccdd6hr165at26dDh48qKioKLVu3Vply5ZV165dNXv2bJ0+fVpRUVGqVKmSwsPDb6kOez0/eclrCN6taNq0qbZu3aoTJ07ka/hLcnKyOnfurKtXr+r5559Xs2bN5O/vLzc3N02dOtUaEHMsWrRIo0eP1jfffKNt27bpn//8pyZPnqx3331Xzz77rKRrTz9v1qyZ3n777TyPe6M3QXAcrgdcj+sBRkAQAmBYJpNJbdu21Y4dO3T27FlJf/bybNy4UVFRUXr88cclXXsOkLu7u9avX6+tW7eqe/fuNw0xN1rfoEEDffPNN/rpp5/Upk0bB51RwQwYMEBbt27VRx99pClTptx0+40bNyouLk4LFy7U0KFDbdaNHz/e7j5NmzZV06ZNNXr0aF26dElt27bVK6+8omeeeUYmk0n169fX77//rq5du8rNjdHazsT1gOtxPcAIuKryacGCBdZPb0vqgxEB2Pfdd9/Zffp5amqq1q9fL0nW4Ri33Xabypcvr3nz5ik+Pt4ajMqVK6fbb79d77zzji5fvpyvYXE5M8RduHAh17qcCQ5effVVu1NlWyyWfJ5d4Q0bNkwNGzbUrFmz9NVXX9nd5scff9QHH3wg6c9eqb/Wtn79epvx/9K1c87OzrZZFhgYqNq1ayslJUVpaWmSpMGDByshISHPT3x/++23gp8YCoXrAdfjeoAjmc1mu78LnY0eoXxISEjQmDFjnF0GgEJ64YUXdP78ed17771q1qyZfH19debMGX3xxReKjo7W4MGD1axZM0mSm5ubunTpolWrVsnHx0cdOnSwttO1a1dNnz7d+v3NVKxYUfXq1dO//vUv1a1bV1WrVpWfn5/69OmjNm3aaOzYsZo+fbpuv/12PfjggwoKCtLJkye1fPly7d69W4GBgUXy95HD19dXa9asUa9evXTffffprrvuUvfu3VWxYkX9/vvv2rRpk7799lvrz7877rhDQUFBeumllxQTE6PQ0FAdOHBAixcvVrNmzfTLL79Y2/7ss8/0zjvvqF+/fqpXr548PT21ZcsWffvttxo4cKDKlCkjSXruuef03XffafTo0YqKilLXrl0VEBCg06dPa+PGjfLx8bHes4WixfWA63E9ICMjQ8ePH9eJEyd08uRJXbx4UWazWR4eHipfvrxq166tOnXqqG7dujaPe/grs9ms//u//1NMTIwmTJhQooYzEoTyYeTIkUpKSlLv3r21Zs0aZ5cDoIDefvttffXVV9q+fbtWrFihS5cuqVy5cgoPD9fYsWP12GOP2WzftWtXrVq1Sh06dJC3t7d1+Z133qnp06erWrVqatiwYb6O/fnnn+uFF17Qq6++qpSUFNWsWVN9+vSRdG2a7ObNm+u9997TjBkzlJ2drerVq+uee+6Rr6+vw87/RurVq6f9+/dr/vz5WrFihSZPnqzk5GRVqFBBrVq10qJFi6y9V4GBgdY3PnPmzJHZbFbLli21du1affzxxzZvdCIiIrR//36tWbNG8fHxcnd3V+3atTVr1izr+H9J8vT01Ndff60PPvhAixcv1htvvCFJCgkJUZs2bTRkyJBi+XvANVwPuB7XgzHFxcVpw4YN2rJli65evZrndtu3b5d0bbbALl26qFu3bgoJCbHZJicE7dmzR9K133szZswokvteC8NkKY7xF6XY6tWr1bdvX40cOVIVKlTQpEmT1KVLF+atN4gp73+upOSrCijrp1efGZTrtauzd74l9e/A/PJrskQfs752f/YJud1V+FndSjPL5SSZHx1us8xj8QKZygU4qaLilWqWOq299XZ+7Ju/iSwavLVJ/s0ibulY2+6RyhTRR5NGux4yU9L0ed1Hbr5hPkQseEk1erbRuv5v6NzuX3Otr9KmkXqsnKTT3+zW5uH/LPRxBh1fIk9fn5tveIuMci1cTclU2Xaf3XI7k0e11KvDWujvE7bqk1W5H1Ww6eN71L55FbX821c6eOziLR0reddg+fl62l1nfu1NWX45aH3tNuIxuffuecP2zGazVqxYUaAarl69qs8++0xbtmwp0H7Xi4iI0KOPPio/P79cIcjT01OjR4+2O9HQgAED5OFR/P0zhugRSkxM1IwZM7Ry5UrFxsaqcuXK6t+/v6ZMmaJRo0Zp4cKFmjNnjs2nEJJ05coVPfPMMwoJCdFbb711w1lLAACupdYLi/Ncl55wQvFfviGPgEryqZa/3kGUPjtfWaCqbcN0x7vPaPWdL8ucmm5d517GS3e8+4zSL1zRzrEfOrFKFJWJH+xXny419PbLbbV+51md/S3Fuu75R5ooonWwXnl3zy2HoJLgwIED+vDDD23u4/H09FTbtm0VFhamOnXqKCgoSJ6ensrMzFRCQoJOnDihw4cP64cfflBmZqYkafPmzfr55581bNgwbdq0KV8hyJlcPggdOHBAPXv2VEJCgvz8/NS4cWPFxcVp9uzZOn78uPUfvEWLFrn2HTdunGJjY7Vs2TIFBLjWpyUAgBurGGG/VyE7PUW/jmkvubmr9uil8qwQXMyVobikn0/SzjHz1fWTsWr5+qP64dWPrOtavfaIAmoHa+Nj05V+oWDP20HpkGnO1pDxW/XDknv18cRO6vHUt5KkBrXKafLIVtr18znN/PSXm7RS8m3cuFEfffSRdaKLMmXKqF+/foqMjLT7UF0PDw/Vrl1btWvX1p133qkhQ4YoKipKq1atUmpqqi5cuKAZM2ZYty+pIUhy8VnjEhMT1adPHyUkJOill15SfHy89u3bp4SEBE2fPl1ff/219uzZI5PJlOsfZ+fOnZo7d6569uypBx54wElnAAAoaWJm/12pMT8rdMh0BYQbc/ilkZxet0fH/r1FjYbcpeA7rk2qEtS+iRoN7aFjyzbrzLd7nFwhitL+w+c19eOfdHfHUA0f0FBubiZ9NrmzTCZpyPitys4u3XeYbNq0SQsWLLCGoObNm2vmzJm699577YYge/z9/dW3b1/NnDlTTZo0sVnn7u5eYkOQ5OJBaNSoUYqNjdWzzz6rWbNm2fyDjhkzRs2bN5fZbFatWrVsenwyMzM1fPhweXt767333nNG6QCAEihh5Uxd3L5U5e94UFXve8nZ5aCY7B7/sVLiL6jjO0+rTNXy6vjO00qJv6Afxi90dmkoBv/4cL8O/Hpes15qoznj2qttsyp6bc6Pio657OzSbsnRo0f14Yd/Duvs3bu3XnnlFVWqVKlQ7QUGBuaa6CcrK8s6C2BJ5LJB6PDhw1q6dKkqVaqkqVOn2t2mZcuWkq6l3+tNmzZNBw8e1Pjx4/P1NGVJWr58uQYMGKCaNWvK19dXjRo10muvvabk5ORbOxEAQImQdGCDzi4epzI1m6nmyI+dXQ6KUUZSina8NFdlQyur78ZZKlu9sra/+IEyr6TcfGeUemazRUPGb5WPt7uefjBM2/Yl6N0l/3N2WbckIyNDc+fOtfYE9ezZU4MGDbrpg8Lz8teJEa5/AO7cuXPtPi+vJHDZIPTll18qOztbgwYNsj7U8K9yEur1QejIkSOaPHmywsLCNHr06Hwfb9asWXJ3d9eUKVP0zTff6KmnntLcuXPVo0ePXA8NAwCULum/xejErL/JvYy/6o77j9x9/JxdEopZ3JafdGTxevlULKfozzcofuvPzi4JxehycobSM7IkSWu3nVFpn3N5xYoViouLkyTVrVtXjzzyiMNCkKenp8aMGWPtTIiLiyvwDHbFxWUnS4iKipIkRUZG5rlNbGysJNsg9NRTTyk9PV3z5s2Tp6f9aQzt+e9//2vzgKguXbqocuXKGjRokLZv367OnTsX9BTUqlUrJSQkFHg/OE6/oc/Lr2yA4hPiFRoamuu1q7N3viX172Blw3Dd5vfn8NeXR7+sZX8/58SKnKeCh4d+DG9rs6x583BdMJudVFHxMnmVUdV3c091W1jZ6Sk6PrWfsq5eVL3xa+QdXNdhbedo0KC+LBmpDm9XMt714Glx0xtqUyRt/743Wg0fvUu/7412aLsN6jdQpqnoPzQ1yrWQLU+pwniHtvnJm53k5emuQ8cvavyIFlr27UmdiHXcJBn1GzSQmzLtrvu8fhN18A+0vp7w+gQtenK43W1zeHl55TkiKiUlRevWrZN0beKDp556qtDP9bnRFNkVK1bUuHHjZDab9e2336pv3755PiOvQYMGt9RrFBQUpL179xZ4P5cNQqdOnZIk1axZ0+56s9msHTt2SLINQvv27ZObm5sGDhyYa5+cYW7ff/+9goKCJEnR0dEKCAiw+5TcVq1aSZLOnj1bqHNISEgo9L5wjOysLOufZ8+ezfXa1dk735L6d5BRu5F03Yf0Fy9eKlH1Fad0L2/pL/elxscnKDEj3f4OLsbN21dVHdjeqfeGK/XkAYUM+ofKtbzxszsKKy4uTtnpRTPMymjXg5fJXQ69AIpBXHycMixZRX4cw1wLJi+pguOaG/lwY0W2CdGrs/fqq02ntG/pfVr4ZidF/N0BDyz7Q3xcnGSxHwTSa9STrpu34NKlm/9+u/5h4H+1bds2padf+zePiIgo9IeaN3tOUPXq1RUREaENGzYoLS1N27dv11133WW3rbi4OGtNxcllg1DOk3BTU+1/wrZ06VIlJibK399ftWvXtlmXnZ2t3377Lc+2MzMzretvNOxt06ZNkqSwsLAC1Z4jJ2zBedz++ITEzd1d1apVy/Xa1dk735L6d+Dl5WXzunz5QFXLLjn1FacKdh5KFxwcJG8X+9Q3LyYvx92Y+9tXb+vC1i9Urm1fBT3wmsPa/auQkJAi7RH6K1e+HjwtblIpG5EeEhxSbD1Cf+WK10K2PBXvoLbq1QjQ1Odaafcvv2v6wp+VnW3RxLn7NPW51hr5cGPN+eKQQ44THBKSZ4/QX0NNYGDgTX///vV34vU2btxo/b579+4FqPJP+X1Yavfu3bVhwwbrcfMKQiEhIbfcI1QYLhuEgoKCdPHiRe3bt0/t27e3WRcfH2+9/yc8PNxmTOSlS5fybHPixImaNGmSunTpos2bN9/w+GfPntXrr7+uHj162H1GUX4UposPjjXl/c+VlHxVwUHBio2NzfXa1dk735L6d2B++TVZoo9ZX8+aOUtv32XMqY3tPT3+p59+drmnx+cl1Sx1csAHtVd+3qTYT8fIu1pD1X7+s0KPn8+P6OijKlNEv5GNdj1kpqTp87r2nwFVUkUfjZanr0+RH8co18LVlEyVbffZLbdjMkmf/qOz3N1MGjJ+i3Wq7Bmf/KL+d9bS1Oda6eutZxwyRO5odLT8fO3fkmF+7U1Zfjloff3mP97U5N437p02m81278tJSUnR6dOnJUm1a9fOc+TUzdrOTwiSro3MqlWrlmJiYnTq1CmlpKTYHR4XHR0tDztBvai57GQJ3bp1kyRNnz5d0dF/juXds2ePIiMjlZiYKMn+g1RvVXJysvr27SsvLy8tXMjUmgBQ2mReiNeJmQOl7CyVbz9Al3av1vnNS+x+pcRw0zzgil4a0kwdb6uqCR/s068n/5wqOzvbosde3yoPdzctfLOTEyssuJMnT1q/r1+/foH3L0gIsnec649fErhsj9CYMWP0xRdf6MyZM2rSpIkaNWqktLQ0HTt2TD179lStWrX07bff5po6+1alpqaqT58+OnnypLZt26bgYJ44DgClTdrZIzInXfvALGH5lBtuG/y3N+Rbq2Q+LBBA4TSqXU7/eOZ27fzpnP65KPdU2YeOXyqSIXJFLSYmxvr9X28NuZnChCBJNo+iiYmJyfXQVWdy2SAUGhqqbdu2afTo0dqyZYtiYmLUuHFjzZ8/X8OHD1fdutdm/XFkEMrMzNT999+vvXv3auPGjWrcuLHD2gYAFB//ZhFq+VUpnx8XDnds2WYdW7bZ2WWgGPx68rLKtF50w22mffyzpn1cunqEr3++ZUEenFrYECRJFStWtHv8ksBlg5B0bZKCNWvW5FqenJysmJgYubm5qWnTpvlub+LEiZo4caLddTnPLNq4caPWrl2rNm2KZupOAAAAoDAiIyPVtGlTZWRkFOj+oNOnT+vAgQOSChaCJKlWrVoaO3asvLy87M6y7EwuHYTycvDgQVksFjVo0CDP+cwL6plnntG///1vvfLKK/L19dWuXbus6+rWrVvi/uEBAABgLFWqVFGVKlUKvF+dOnX08ssva/bs2XruuefyHYIkKSAgQLfddluBj1kcXHayhBv55ZdfJDl2WNw333wjSZo2bZrat29v8/X111877DgA4ChHjx5Vhw4d1KBBA7Vu3VoHDx68+U6S7rrrLoWHh6tFixbq1KmT9u/fX8SVojiMGjVKtWrVkslksn7yC+SoVKmSzf0l9nz11VcKCwtTixYtrO+1CsNkMlln8X333Xd5uHwJ0bx5c82ZM6dAIaikIwg5SExMjCwWi92vxx57zGHHAQBHeeKJJzRixAhFR0dr7Nix+f5ZtWzZMv388886cOCAXnzxRX7GuYj7779f27dvL9R0uoAkzZs3TxMmTNCBAwfUrFkzh7RJECpZHDWSqqQgCAGAAZ07d0579+7VI49ce97KgAEDdObMGR07duwme157mF+Oy5cvF+nzdVB8OnfuXOgnzMP1rF69WmFhYQoPD9eYMWOsy48ePapevXqpdevWCg8P13vvvSfpWo/itm3b9Oqrr6pDhw6SpEGDBqlVq1YKDw9Xr169rIEmJibG5udIcnKy3Z8jb775puLi4vTggw+qRYsW9FTC4Qx5j1BUVJSzSwAApzpz5oyCg4OtD7AzmUyqUaOGTp8+rXr16t10/8GDB2vTpk2SpLVrHfD0UgAlxrlz5zR06FBt27ZNjRs31ocffqjz588rKytLDz30kJYsWaJGjRopJSVF7dq1U9u2bTV79mz9/PPPev7553XfffdJutabk3OP9LRp0zRx4kTNmzcv33VMmDBBCxcu1NKlS4vkuY+AIYMQAODWfPbZtae2L1q0SGPHjiUMAS5k165dCg8Ptz4G5PHHH9fIkSOVnp6ugwcP6m9/+5t12ytXrujQoUNq3bp1rna++OILLV68WGlpaUpLSyvQdM1AcSAIAYABVa9eXfHx8TKbzfLw8JDFYtHp06dVo0aNArUzZMgQPfnkkzp//rzNsyIAuI6cYWsWi0UVKlTI1xC17du3a/bs2dq5c6eqVKmi1atXa8KECZIkDw8PZWVlWbdNS0srkrqBmzHkPUIAYHRVqlTR7bffriVLlkiSVqxYodDQUOuwuMGDB+s///lPrv0uXbqkuLg46+tVq1apYsWKqlChQvEUDqDItW/fXj///LN+/fVXSdLChQuVkZEhb29vBQQE6JNPPrFue+zYMV24cCFXGxcvXpS/v78qVqyojIwMzZ8/37ouKChIFotFhw4dkvRnD7M9AQEBunz5sqNODbBBEAIAg5o/f77mz5+vBg0aaNq0aTZvbvbu3avq1avn2ufy5cu677771KxZMzVv3lzvvfee1qxZw4QJLuCJJ55QaGioYmNjdffdd+frXjG4psqVK2vhwoXq16+fmjdvrqNHj6pixYry8PDQmjVrtHLlSoWHh6tJkyZ6/PHHlZqamquNHj16qGHDhmrYsKE6depkc4+Ph4eH5syZo969e6t169bKzMzMs5ZRo0Zp+PDhTJaAIsHQOAAwqIYNG2rnzp25lv/++++qVq2aWrVqlWtdzZo1tXv37uIoD8Xs+k/sgb59+6pv377W19OnT7d+/9///tfuPps3b7Z+7+npqaVLl9qsnzx5svX7oUOHaujQodbXY8eOtX5vsVis3w8bNkzDhg0r+AkA+UCPEADARuXKlfXdd985uwwAAIoUQQgAAACA4RCEAAAAABgOQQiAi7LcfBMAAEo8fp8VFYIQANfg5WXz0pKe4aRCAABwoLR0m5emv/y+Q+ExaxwA11DWz+al5fhJJxUCZ/Nxl7bd4+wqCsbH3dkVuA6PMt4adHyJs8soEI8y3s4uwaX4lvFQ8q7Bzi6jQHzL2H9LbknPkCX2rO3CsmVv2p67u7sGDBjgiNI0c/5SXbl6Vf5+fhr9xIN5LrsV7u7O+SFIEALgEkxNwmTZtcf62vLDHllSUmTy9XViVXAGk0nK4z0FDMBkMsnT18fZZcCJTCaT/Hw9nV2GQ1h+2COlpv25wM0kU1jDm+5nMpnk4eGYH4QWSdmWa3/mtGlvWWnE0DgALsGtYzvbBVdTlDVxqizHT9o8kwIAgJLOkpGh7G3fK+v9D22Wm5qEyVQ+0DlFuaDSG+EA4DqmShVlatRAll+jrcssv0bL/MIrUpXKMlWuJJXiT60KwmI251pmnva2TAY5f9jiekAOroXSwCKlpctyOlZKTc211vTXD/1wS7jyAbgM92dHyPzam9LlJNsV536X5dzvzimqpDh4mHmH8CeuB+TgWig1TK1vl1v3rs4uw6UwNA6AyzDVqC6PyROkcgHOLgUAAIcxtb5d7q+8KJOna9z7VFLQIwTApZhqVJfHjH8oe90GZe/YJRm9JwgAUDqZTDI1biRTx3Zyu/tOQlARIAgBcDmm4CC5D31Ebo8N0nsf/ktXrqaqrLubnqlVWe/HnFOyOUtlPdz1TK0qzi4VAABb3l4ylS17LQRVKO/salwaQQiAyzKZTLpizlZSplny9pN7315Kfv9zJaVdlXzKyL1vL2eXCAAAnIR7hAAAAAAYDkEIAAAAgOEQhAAAAAAYDkEIAAAAgOEQhAAAAAAYDkEIAAAAgOEQhAAAAAAYDkEIAAAAgOEQhAAAAAAYDkEIAAAAgOEQhAAAAAAYDkEIAAAAgOEQhAAAAAAYDkEIAAAAgOEQhEqxxYsXq2XLlipfvrzKlCmjsLAwvf3227JYLM4uDTewdu1atWjRQt7e3qpVq5befvttZ5dUrLZu3aq+ffuqZs2aMplMeuutt5xdEgAAKEYzZ85U+/btVb58eQUGBuqOO+7QunXrir0Oj2I/IhymSpUqev3119WwYUN5e3tr27Ztevrpp+Xu7q7nnnvO2eXBjr1796pv3756+eWX9eWXX+qHH37Qk08+KV9fXz355JPOLq9YJCcnq3Hjxnr44Yf1/PPPO7scAABQzKKiovT3v/9drVu3lq+vrz766CP17t1bW7ZsUceOHYutDoJQKXb33XfbvK5Tp45WrVqlzZs3E4RKqLffflutW7fW1KlTJUlhYWE6ePCgpk2bZpggdM899+iee+6RJI0dO9bJ1QAAgOL2zTff2LyeMWOG1q1bp5UrVxZrEGJonIuwWCzavXu3duzYocjISGeXgzzs2LFDPXr0sFnWo0cPnTp1SrGxsU6qCgAAwHmys7OVlJQkPz+/Yj0uPUKl3OXLl1WtWjVlZGQoOztbb7zxhkaNGuXsskqdtPQMnY47l2u5OSvL+mf0ydhcr68XVLmCAsr63vA48fHxCgoKst3vj9fx8fEKDQ0t9DncqlOxCUrPNNsss3e+ef0d+JbxVmhQ5WKqFgAAONrpuHNKS8+wWVaQ9wI+3l6qEVKlwMedMmWKLl26pBEjRhS29EIhCJVy/v7+OnDggFJSUvT9999r3LhxCgkJ0eOPP+7s0koVL08Pbdq5XyfPxNtdn5KapoXL1ub5ukKgv54ben+R11mUzl24pBXfbLW77q/na2/ZY/f3+OtuAACgFLl0+Yq+WL3R7rr8vBd4uG+3AgehDz74QFOmTNHq1auL/QNhhsaVcm5ubqpXr57Cw8P15JNPasyYMXrttdecXVap4+bmpgd6Rcjby7PA+5pMJj3YKzJf+wYHByshIcFm2W+//WZd50ytmjVU4/o1C7Vv2xZhalS3hoMrAgAAxSk8rK5aNK5XqH1va1JP4Y3qFGifWbNmafTo0Vq9erW6detWqOPeCoKQi8nOzlZaWpqzyyiVKpTzV59uHQq8X0S75qoZGnTzDSV17NhR3377rc2ydevWqWbNmk4dFiddC3T97+6ssr5lCrRfxfIBuieyXRFVBQAAitO93TuqnH/B7tUp5++ne7sVbJKDCRMmaNKkSVq7dq1TQpBEECrV3njjDW3YsEEnTpzQkSNHtGDBAk2fPl1DhgxxdmmlVsumDdS4fq18bx9StaLu7Ngy39u/8MIL2r17t1577TX9+uuvWrRokebMmaNXXnmlENU6Xlm/Murfo1O+ty9Ib1iO5ORkHThwQAcOHFBGRoYSEhJ04MABHTt2rDAlAwAAB/L18dYD90QUaJ8HekWojI93vrd//vnnNXPmTC1evFgNGzZUQkKCEhISdPny5QJWe2sIQg6SmpqqevXqyWQyyWQyafPmzUV+zKSkJD355JNq0qSJ2rVrp3nz5mnq1KmGe0CnI5lMJvXv0SlfvSIe7u56sFekPNzd891+69attWrVKq1Zs0bNmzfXhAkTNHny5BI1dXbj+rXUKrxhvraNbNdCNapVLVD7e/fu1W233abbbrtN8fHxev/993Xbbbdp2LBhhSkXAAA4WL1a1dSxZdN8bduxVVPVq1mtQO3/3//9n9LS0tSvXz8FBwdbv4r78S9MluAgkyZN0vHjx4v1mO+8847eeeedYj2mEZT1LaMBPTtr0Ypvb7jd3V1aq2rlCgVuv1evXurVq1dhyysWfbq214lTcbpw+Uqe21SrWqlAvWE5IiIiZLFYbqU8AABQxHp0aaOjMbE6d/5SnttUqVhePTq3KXDbJeV9AD1CDvDTTz/pn//8p/r27evsUvL0+4VLN3xTC1th9WqqTfNGea6vUyNEHVs1K8aKipe3t5cG9o6UKY/1Hh7uGtg7Uu7u/AgBAMAVeXp6aGDvSLm52X834OZm0oN9IuXpWXr7VXgXc4uysrI0bNgweXt7a86cOc4uJ09rNu7UrA//pb2/HHF2KaVGr67tVSHQP9dyby9PDewVITdTXjHBNdQKDVKXdi3sruvRpY2qVipfvAUVwokTJ7Ru1ZeaP3O8/jF6hIKDg7VwzjQd+d8+Zf3xDAQAAGBfaFDlPEd/dL+jlapVrVTMFTkWQeg6WVlZWrx4se666y5VrlxZ3t7eqlGjhnr06KGPPvrI7hun2bNna+/evZo0aZKqV6/uhKpv7kzcOR05cUayXHtzi/y5FngiZfpL4LnvrjsUGFDWSVUVr253tFRwlYo2y+rVrKYO+Rw37CwZGRkaPny46tWrp20bvtal878rLTVFCQkJOn7kf1q1ZL7+OfFF7d6929mlAgBQokW0a5Hr2UA1Qqqqc9vmTqrIcQhCf0hKSlL37t01ePBgfffdd/Ly8lLz5s2VnZ2t9evXa/jw4bpyxXZo2alTp/T6668rPDy82G/uKogNO36UJN3WpL4qlS/n5GpKl1qhQepy3X/0Zg1rF3p+/dLIw91dD143BM7H20v339OlRPeGmc1mPfDAA/roo49uOAb58sXzioiI0M6dO4uxOgAAShd3NzcN7P3nEDgvTw8N7B0hd7fSHyNK/xk4yOOPP65NmzYpNDRUUVFROnv2rHbv3q3Y2FjFx8dr8uTJ8vS0nSL4ySefVEpKiubNmycPj5I5PjKnN8jNZFJkh9ucXU6plNMr4l/WV/fd3SlXD5GrC6pcQXf/cSNkaegNmzlzplavXp2vbVNTU9W3b1+lpKQUcVUAAJRelcqXU++u154Z2Ktre5f5YN1kKSnTNjjRjz/+qFatWsnDw0P79+9X06Y3H/bzxRdfaNCgQXriiSc0b9486/KcN8mbNm1SRETELdU1Z9FKXUlOvaU2UlLTZM7KkqeHR4Hmd4etrKxsWSzZJTbwFjWLxaKMTLO8PD1KdBDMyjJr5oQXdOXyxQLt12/QcLVq36WIqgIAoPQrye8F/MuW0cgh/Qu8nzHf1f3FqlWrJF2b1jg/IejChQt6/vnnVaVKFU2bNq3I6rqSnKqk5KsOaSvTbFZmstkhbRlburMLcKr0jAxnl3BDR/63r8AhSJJ2bv5WDZq1KoKKAABwLSX9vUBBEIQkHTp0SJLUvn37fG3/0ksv6ffff9fixYsVGBhYZHX5l735Qz1vhN4gGM3Fc3GF2u+3uDMq61tGbi4w3hkAAKMp7HtmgpCuTZQgSeXK3Xy845YtW/Tpp5/qzjvv1COPPFKkdRWmiy/Hmbhzen/xKrmZTHru7wNcZiwncCO/Re/WlvUF389iseiFv/eXn5+f44sCAAAlEkFIUkBAgCTp8uXLN912//79kqQ9e/YoKCjvqaj79+8vLy8vjRgxQm+++Wah6rqVe4RSUtMkSe7u7vrwizWFagMobX45eqZQ+7m5uevdT/5T4sY8AwCAm+MeoVvQpEkTrVy5skDT6CYlJVl7kuy5ePGidbvCcsQ9QtwbBCMJrd2wUPvVadhUV64ycxwAAEbCrHG61stz++23y9PTUwcOHFDjxo0L3VZJmDWOe4NgVBaLRR/MeF1xZ2IKtN9jT49R/cbhRVMUAAAoUoXtESII/eHBBx/UsmXLVKNGDX322Wfq0uXPqXR/++03LVy4UKNGjbrpPQSODEKFcf29QS8OH8i9QTCc//znP+rfP/8/DNu0aaOdO3cyUQIAAAbDb/4/LFiwQBERETp9+rQiIiIUGhqqNm3aqHr16goODtarr76qzMxMZ5d5Uxt2/ChJuq1JfUIQDKlfv36aMWNGvrZt2LChVq9eTQgCAMCA+O3/h4CAAG3YsEEff/yxIiIilJKSop9++klubm66++679fHHH8vf39/ZZd7QmbhzOnLijNxMJkV2uM3Z5QBOM3r0aH3++eeqW7eu3fWenp56+OGH9f3336tq1arFXB0AACgJGBrnQmJiE7Rq/XZVq1pJD/SKcHY5gNNlZ2dr/fr1+s9//qPz58/Lx8dHTZs21dChQwlAAAAYHEHIxWRbLMrMyJS3t5ezSwEAAABKLIIQAAAAAMPhHiEAAAAAhkMQAgAAAGA4BCEAAAAAhkMQAuASjh49qg4dOqhBgwZq3bq1Dh48eMPtP/nkE7Vo0cL6ValSpQI9iBUAAJRuTJYAwCV07dpVgwcP1mOPPably5dr+vTp2rNnT773b9q0qSZNmqQBAwYUYZUAAKCkoEcIQKl37tw57d27V4888ogkacCAATpz5oyOHDmi0NBQnThxQpI0a9Ys9ejRQ9nZ2Tb7//DDDzp37pzuvffeYq8dAAA4B0EIQKl35swZBQcHy8PDQ5JkMplUo0YNnT17VjNnztTAgQO1efNmvf/++1q8eLHc3Gx/9H388cd69NFH5enp6YzyAQCAE3g4uwAAKEoPPfSQNm3apLvvvlsbN25U5cqVbdZfvXpV//rXv7Rr1y4nVQgAAJyBHiEApV716tUVHx8vs9ksSbJYLDp9+rRq1Kghs9ms//3vf6pQoYLOnj2ba99///vfatKkiRo3blzcZQMAACciCAEo9apUqaLbb79dS5YskSStWLFCoaGhqlevnl555RU1bNhQ27Zt08svv6xjx47Z7Pvxxx/r8ccfd0bZAADAiZg1DoBLOHLkiB577DGdP39eAQEB+uSTT3Tq1Cm98sor2r17t3x9ffXvf/9bU6dO1ffffy8fHx8dOXJErVq1UlxcnPz9/Z19CgAAoBgRhAAAAAAYDkPjAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABgOQQgAAACA4RCEAAAAABjO/wNa8nfBRao1WgAAAABJRU5ErkJggg==", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 5, @@ -333,9 +328,8 @@ "outputs": [ { "data": { - "image/png": "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", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 6, @@ -379,9 +373,8 @@ "outputs": [ { "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAkEAAADuCAYAAAA+0dO/AAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjksIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvJkbTWQAAAAlwSFlzAAAPYQAAD2EBqD+naQAANahJREFUeJzt3XlYU1fCBvA3C4QdZBMQ2VRUlMUFUXREXHFvQeliXdpa285ntcug1m7TT6tW/dqOtQudarW2Yx2VanE61n3fsCql7oqgIGhVEEEEktzvDyYZIgFJCCTkvr/n8ZG7nxuSw5tzzz1XIgiCACIiIiKRkZq7AERERETmwBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKIkN3cBiIiaglBaCuFIBtTHfgXuFEEofwBAMHexiOhRJBJIHByA1t6Q9ukFSY8oSBSKpjmUIAisFYjIaggPHkD1ty8gHM0AlCpzF4eIGstOAemQgZA+NwkSmWkvYDEEEZHVEB48gOp/P4Tw+xlzF4WITEwyMA6yV14yaRBinyAisgqCIEA1bzEDEJGVEnbthTp1hUn3yT5BRGQVhAuXIGSd1p1pY1PdnyAqHBJnZ0AiMU/hiKjhVGoIxcUQjp+o/kyr/3vBSr1tF6TPPAGJi4tJDsUQRERWQThwWHeGkyPk89+FJCTILOUhokYaOxLqjBNQLVz63/59ajWEwxmQDBtkkkPwchgRWQX14WM609IRwxiAiFo4aXR3SHr11JmnPnTUZPtnS5AVEQQBqKgwdzEMo1BAYsJLFIIgQKVqWXcEyWQyk74GYiRUKYGbf+jMk8T0rGNt6yb2eoB1gPWRxkRDVSP4CAWFJts3Q5A1qaiAMnmyuUthEPk/VwN2dibbn0qlwsaNG022v+aQlJQEuZwfxUa5f7/WLImnhxkKYgFEXg+wDrBCXg99lktLTbZrXg4jopZPra49TyZr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SJQYgoiIiEiUGIKIiIhIlBiCiIiISJREN2K0VVMoIP/nanOXwjAKhUl3J5PJkJSUZLL9LUldh3tlZXB2dETKi0/UmjYFmUxmkv0QARB9PcA6gAzBEGRFJBIJYGdn7mKYlUQigVxuure1AEAtVP8vl8trTRNZGrHXA6wDyBC8HEZERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREosQQRERERKLEEERERESixBBEREREoiQ3dwHIdARBACoqzF0MwygUkEgk5i6F1RAEASqVytzFMIhMJuN7wIRYDxDrgYZjCLImFRVQJk82dykMIv/nasDOztzFsBoqlQobN240dzEMkpSUBLmcVZHJsB4QPdYDDcfLYURERCRKDEFEREQkSgxBREREJEoMQURERCRKDEFEREQkSgxBREREJEoMQURERCRKDEFEREQkSgxBREREJEoMQURERCRKDEFE1KRu374NtVpt7mIQkZkIgoA//vjD3MXQiw/sqcemTZuwYsUKHD9+HHfu3IG7uzs6deqEESNGICUlxdzFI2oyRUVFuHTpErKzs3H16lXcv38fgiDA1tYWfn5+CAkJQUhICNq0aVPvQw/z8/Mxb948RERE4KWXXoJUyu9dRC2BSqVCTk4OsrOzceXKFdy8eRNVVVWQyWRwdnZGcHAwgoOD0b59ezg6Ota5H0EQsHbtWmzfvh1z585Fhw4dmvEsHo0hSI/KykpMmDABGzZsAACEhISgbdu2uHHjBvbv34+srCyGILI6arUamZmZ2LZtG06dOlX9NHI9fvvtN+3PAQEBGDJkCPr16wd7e3ud9TQBqLi4GPv27UPr1q2RlJTUpOdARI1TVFSEXbt2YefOnbhz506d6x09ehQAYGNjg9jYWAwdOhTt2rXTWUcTgH766ScAwMKFC/HJJ5/AxcWl6U7AQAxBekydOhUbNmxAQkICli9frvOL1VToRNbk8uXL+OKLL5CXl2fQdlevXsWKFSvwww8/YOLEiYiLi4NEItEJQAAQFBSEYcOGNUHJicgUlEol0tLSsHnzZqhUqgZvV1VVhb1792Lv3r2IiIjAtGnT4OnpWSsAAcDTTz9tUQEIYAiqZdu2bViz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", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 7, @@ -494,9 +487,8 @@ "outputs": [ { "data": { - "image/png": "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XOP+888/V3FxsQYNGtToet0hOjq61rYpU6YoIiJCy5Yt04YNGxQaGqqLL75YEydOrF7wo0pqaqr69OmjoKCTryILzzIMQxNGRGvOf9Ld3vcVI7rKavWOzxa6R7XSl7NH6tLbv1Hh0ZPfN6l3t9ZaNHuUAgNMfdkEAAAt0PbdhxU48J2THvPknM16cs5mN1XkPiMGd9K8xy7Q1EdWyWY7+XvBi8/tpHmPm2sUJICWo0W+k926dascDodiYmIaFWRdf/316t69u84+++zqRUCefvppxcfHa9KkSU1QsetER0fXCgEtFovGjh2rsWPHnrRtYWGhdu7c2ah7HML9br861iMBoLdNiUjq315r/j1Of39tvRYuzVTlCS/8WoX46oZxvfTo7Wc7NVoQAAAA3mHyuF7qHBmix9/YoJSfay+r0umMIN02MVYzpvaTr693fNANACdqkQHgli1bJNW+/19D9enTR++//75efPFFHTt2TFFRUfrjH/+omTNnumRl3uaq6v6G3P/PO5wdF67B/SL04+YDbutzQO92GtzvDLf15yq9u7XRB08PV15+iT78ercefDlVRSWVahPqp71LJynkJDeqBgAAgPcbOrCDhg7soLRdhfp8eZb+8eZGFZVUKqy1nzKXXC0fH4I/AN6tRV7FTjcA/Nvf/qYtW7boyJEjqqio0O7du/X888+rdWvvuO9ZYw0bNkzvvvuuwsLCPF0KGujlvyU5dU+T02EY0uwHkrzuPpi/FxkepLuu66PWIceD/OBAH8I/AACAFiS2exvdf1P/6teDgf4+hH8ATKFFXslONwBsqaxWq3x9CUO8SWKfCM24sZ9b+rp38lk6N769W/oCAACul5mZKavVqvj4eG3cuFGStGjRIiUkJMjf31/33HNPjeNfeOEF9ezZ85SLw23atEnt27dXXFyc9u/f77J6DcNQ37599dVXX1Vv+8c//qEePXqoR48eevDBB6u3JycnKy4uTm3atHFZ/wAAeJMWOQU4JSXF0yUAbjPztgFK+XmfftrS8KnAefklNf4+lbNj2+kfdyQ0qj4AANB8hIaGVod/ktSrVy/NnTtXH330kYqKimoce++992rAgAG1gsHf++WXXzRhwgQtWLBAO3bs0MiRI/Xtt98qIiLCJfWuWrWqOtRbuXKlFixYoM2bN8vHx0fnnXeezj33XI0ZM0ZXX321zjnnnFOGlQAAmFWLHAEItCT+flZ99erF6n9mw6duD7zmc3Ue+YEGXvP5KY/t06ONlrx2MavjAgDQTBmGoX/+858655xzFB0drU8//VSzZs1SYmKievXqpeXLl9fbNiYmRv3795ePj/O/59PS0nTDDTfok08+0fDhw3Xrrbfq8ccf17hx43Tw4ME620RHR+uhhx7Sueeeq86dO+v111/XvHnzlJSUpOjoaH3wwQf19pecnKzJkycrODhY/v7+uummm7RgwQKn6wYAwIwIAIEWIKy1v5bPuVRDB3Zw6XnPG9BeK+aNUURYoEvPCwAAXCskJEQ//fST5syZo+uvv14dOnRQamqqnnjiCd13331N0mdsbKzWr1+vfv3+dzuS8ePH68cff1S7du3qbVdcXKzVq1fru+++07333qucnBytWbNGH330ke6888562+3Zs0ddu3atfhwdHa09e/a45skAAODlCACBFqJNK38te2u0XpxxjgIDrKd1Ln8/q56+d6BWzL1U7doEuKhCAADQVK6++mpJUmJiooqLizVp0iRJ0qBBg7Rjxw5PllZLVa09e/ZUQECArrzySknHaz906JAKCws9WB0AAN6JABBoQSwWQ3dff5Y2fXS5bhjXU/5+zgWBfr4WXTemhzZ+dJnum9pPViuXEAAAvEFAwPEP7KxWa63HlZWVHqurLlW1Scfrq3psGIYMw6i33i5duigrK6v6cWZmprp06dK0xQIA4CV49w60QL26ttY7/xyi7KWT9PS9AzVicEe1beVX57FtQv00fFAHzbo7UXu/maR/zxqq3t3auLdgAACAU7jqqqs0f/58FRcXq6ysTHPnzq0e6QgAQEvHXfuBFiy8bYDum9pP903tJ4fDocycIu07UKKycpv8/ayKDA9U96hQGYbh6VIBAIAHLFu2TFOmTNGRI0fkcDj08ccf69VXX9X48eM9XVotQ4cO1dVXX62+fftKOj6VeOzYsR6uCgCA5oEAEICk49NqukWFqltUqKdLAQAALuRwOKr/HRISUuNxVFSUioqK6m170UUXKTs7u0nr+73MzMwaj/Pz82s8PtV05UceeUSPPPKIq8sCAMDrMQUYAAAAgKxWq4KCghQfH6+NGzee8vgXXnhBt99+u8LDw5u+uDq0b99eQ4YM0VdffXXKY5OTkzVu3Di1b9/eDZUBAND8MAIQAAAA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gQMHFBkZWepw4zNnzig3N1chISGF+8LCwvT777+X2lb37t31008/le/i4JL41g64CDc3Q688Gqkdn49QeJPqFTpX80aB2rpkhF5/ootMJt5GAAAAgKps3LhxkqTIyEhdunRJd955pySpS5cuZRpGeuDAAd17771asWJFYe+8ypCUlKQ6deoU2de9e3c1bNhQ0pX4O3fuXFimc+fOVWoYbLNmzdSpUydJV2Jt1qyZWrVqJansr3VZhYSEKCkpyWrng/PjmzvgYrq2r609K0bpH8/3UkSrmhbVbde8hhb9taf2/es29exY58YVAAAAANjd1V5sJpOp2HZeXt5168bHx2vEiBH69NNP1atXr0qN09fXV1lZWUX2XY1VuhLvtds3it+WyhtrrVq15O7urtTU1MJ9x48fL0x8liQrK0s+Pj5WiBquwt3eAQCwPW8vd025vaXuH91CO/ef1g//Ttbu+DTtjk/TydOZMpuvDPENCfJVp/Ba6tQ6SIO711ePiNrM9QcAAAC4iISEBA0bNkwfffSRBg8eXOnttW/fXr/++mult1MVjRkzRosWLdILL7yg6OhoJScnq2/fvqWWT0hIUIcOHWwYIRwdCUDAhRmGoW4daqtbh9qF+8xms/LyzHJ3N0j2AQAAAC5s2rRpOn/+vGbNmlW4Au68efM0ZMiQSmnvjjvu0H333adXXnnFKuf7f//v/2nt2rVKTU3VkCFDFBAQcN1ViO1p3rx5mjhxopo3by5PT0998cUX8vDwKLX8+vXrdccdd9gwQjg6EoAAijAMQx4eJP4AAAAAZ2A2mwv/7e/vX2Q7NDT0uqvobty4sVJju1a7du1Uu3ZtRUdHq3Pnzpo8ebImT55cePyRRx4pUv6555677vk+/PDDygizRP369VNsbGzh9ogRIzRixIjC7bvvvlt33313qfXr1KmjH374oUxtpaWlaffu3Ta9Pjg+5gAEAAAAAMDFmUwm+fr6KiIiokgiqzQrVqzQLbfcUmzRjopauHCh/vjjD4vr+fv767vvvtPIkSPLVL5///7asmVLpS5qUhofHx/FxsYqMjKyTOUnTJigL774QoGBgZKko0ePatGiRfL09KzMMOFk6AEIAAAAAICLa9CggU6ePFnm8uPGjStcXdiamjZtqqZNm1pc76mnntJTTz1V5vKbN2+2uA1rsfS1+/LLL4tsd+3a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", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 9, @@ -531,9 +523,8 @@ "outputs": [ { "data": { - "image/png": "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8vDwkMViUceOHZ1cLQB7HTlyRLNmzVJGRoZtXfv27TV48GBdddVVcnd3r/BYwzC0Z88effHFF9qyZYskae/evXrwwQdL9WYRogAAruyrr77S66+/LsMwJEmenp5KTExUUlKSmjdvXu4xXbt2lSTl5eVp48aNWrlypY4cOSLDMLRs2TKtWrXKFrBcNURJBKlqMXnyZKWlpWnSpEmaN29eqW3Tp0/XO++8o507dyoyMlJBQUFOqhLA5UhLS9OTTz6pzMxMSVJgYKDuuusu9ejRo0qhx2KxKC4uTnFxcfrxxx/18ssv69dffyVEAQBqjc8//1wLFy60Lbdu3Vq///3vFRYWVqXjfXx8dM0116hfv35atmyZPvjgA1mtVluI8vLyctkQJTFGyuH27t2rxYsXq1GjRnrqqafK3adz586SpE6dOtnWffjhhxo9erRatmwpPz8/tWnTRo888oiysrJqpO7qkFNcrFP5+eX+B9RmmZmZmjVrli1ERUVFae7cuerZs6ddoad9+/YaOnRoqXXu7u7q378/IQoA4JK2bdtWKkQNHz5cTzzxRJVD1IXc3d01bNgwxcTElFofGhqqtm3bXm6p1YYeKQd79913ZbVaddtttykgIKDcfXx9fSWVDlLz5s1TixYtNGvWLIWHhys5OVlPPPGE1q1bp2+++eaSU0O6oif37daT+3Y7uwzA4d544w3bOMeoqCg9+uijlzU1+apVq0o1RpJUXFysl156SU888USt/PcPAKi7zp07p1dffdW2fP311+vmm2+2+3wlE0v89FPpicp++eUXrVy5sswPG10FQcrBVq9eLUlKTEyscJ+0tDRJpYPUp59+qpCQENtyv379FBISottuu03ffvut+vbtW00VV5/ftYjS6LDyn429btO6Gq4GcIwtW7Zo48aNkiR/f389+OCDlx2iLpxY4rrrrtP333+vkydP6ueff9aKFSs0bNiwy64bAABHWbhwoc6ePSvp/JNWY8eOtftc5c3Od/PNN+vNN9+UYRh67733dNVVV9nV01XdCFIOdvjwYUlSy5Yty91eVFSkDRs2SCodpC4MUSW6dOkiSTp69KhdtXTp0qXM7CmX4uvmpj3xPey63sWiAwI0IKSJQ85VkZiYGOW66NuuJemGu6bIPyBIx9OPKzw8vMxyXVcb79/Ly6vCx3INw9DixYtty+PHj1dw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fFHh+KjY2FhJUrdu3TR48GBFRERozpw5evHFF03XYm83JRxn1j//o3NZ2Woa2lRpaWlllus67r/s/brqn0HR0/NlbNxsW37gzw9o2q03ObEiwDmycwoV0P3Nyz6PxSIt/GtfubtZNP7Rdbapzue8sUujBkToqfu7aPk3RxzyiN/P+/fL38+zwu2Ff/6LdDDFtvzcc8/phcS+l33dqqhNn4PVhbaw7t4/k004WHh4uNavX6+hQ4fKx8dHqampCg4O1ssvv6zly5dr//79ki490YQk1a9fX9HR0Tpw4EB1lw0AABxo6vgO6nVVE/3fv7brp5T/TXVutRq687Fv5OHuptef7FPJGQC4OnqkqkHbtm312WeflVmflZWl1NRUubm5qX379pc8z8mTJ7Vv3z5169atOsoEAADVoE1kPf31j1fru50n9Y9FZac633PwTLU84gegZhGkatDu3btlGIZiYmLk5+dXatvtt9+u6OhoxcfHq379+vr555/1zDPPyMPDQ3/+MzNnAQBQW/yUcla+XRdVus/TC37Q0wt+qKGKAFQHglQN2rVrl6TyH+vr3r273nzzTT333HPKy8tT8+bNlZiYqIcffrjCd1IBAAAAcA6CVA2qLEhNmjRJkyZNqumSAAAAANiBySZqUGVBCgBqi8cff1x5eXk1es2IiAjFxsbqtddes61bsGCBWrdurVatWunuu+9WYeH56Z/Xr1+v+Ph4WSwWnTlzpsJznjlzRl26dFFwcLA2btxY6fWXLl2qTZs2OeRequrxxx9XSEiIRowYYVs3efJkRUREyGKxKDk5udT+iYmJCg4O1rPPPlvpef/617/K09NTU6dOrXS/1NRUvfTSS/aWb5fU1FS5u7srPj7edn/PP/+82rdvrw4dOqhjx456++23bfsvXrxY7dq1U/369Wu0TgCQCFI1avXq1TIMQ0OHDnV2KQBgtyeeeKLGg5R0/kvz7373O0lSSkqKHnvsMa1fv14HDhzQiRMn9Morr0iS+vTpUyZkXOzcuXMaPHiwxowZoxUrVmjcuHHavHlzhfs7I0hJ0m233aZly5bZlm+88UZ9++235T7yvWbNmlKhqzxPP/20vvrqKx06dEh79uzRjBkzKtzXGUFKkgIDA5WcnGx732JcXJw2bNigXbt2afny5ZoyZYoOHjwoSRo7dqxWrHDci20BwAyCFACgyu677z5J58NKfHy8Tp48qczMTN19991KSEhQx44ddc8996igoECS1L9/f02dOlV9+/ZVixYt9Nhjj2nFihXq3bu3IiIiNH/+fNu5IyIiNG3aNHXu3FnR0dGaO3duhXV8+OGHGjFihEJDQ2WxWHTffffp3XffrdI9ZGVlaeTIkZo8ebKmT5+u7t27a+XKlfr973+vrVu3ltl/xYoVWrZsmebOnav4+Hhbr9hbb72lbt266eqrr1bfvn21c+dOSdLChQs1cOBA3XLLLWrXrp169uypPXv26IYbblDbtm01aNAgZWVlSTrf6zR69Ghdc801atOmjYYPH67ffvutwtr79u2r8PDwKt3nxebPn6/vv/9eX375pZo3b65PP/1UJ0+e1COPPFLu/vfdd5/27dun+Ph4W0D7+eefNXToUHXt2lUdO3Ys9Y5Di8Wiv//97+rWrZsiIiK0dOlSPfXUU+rSpYtat26ttWvXSjof0OrXr68HH3xQHTt2VFxcnFatWlVh3QMGDFC9evUkSc2bN1doaKiOHDli158BADgSY6QAAFX20ksv6eWXX9b69ettj1Pdc8896tOnj1599VUZhqG7775bzz33nKZNmyZJOnz4sNasWaNz584pIiJCGRkZWr9+vY4dO6bY2FhNmDDBdq4TJ05o27Zt+u2333T11VerV69e6tmzZ5k6fvnll1K9MhEREfrll1+qdA8BAQFas2ZNqXUxMTHavn17ufsPGTJEI0aMUHx8vKZMmSJJ2rBhg959911988038vb21vr163Xrrbdq9+7dkqStW7dq165datGihcaNG6fhw4dr48aNatKkiYYNG6ZFixbpj3/8o6TzjyL+8MMPCg0N1R/+8Ac99NBDtt41R3rggQdKLXt4eOiNN96ocP+XXnpJU6ZMsfXuFRcX65ZbbtHbb7+tNm3aKCcnR927d1e3bt3UtWtXSef/bDdv3qyvv/5aI0eO1Isvvqht27bpgw8+0LRp02xB9ezZs2rbtq3mzZunTZs2acSIEbZepsqsWrVKGRkZtusBgDMRpAAAl2Xp0qX67rvvbL1Lubm5cnd3t22/8cYb5e7urgYNGigqKkrDhg2TxWJRs2bNFBISotTUVNtjXBMnTpTFYlGjRo00atQorVq1qtwg5WyffPKJdu7cWeo9f6dPn1Zubq4kqUePHmrRooUkqUuXLiosLFSTJk0kSV27dtXPP/9sO27o0KEKDQ2VdD6Ujho1qqZuw5R9+/Zp9+7duvnmm23rMjMztWfPHluwGTt2rKTz95ydnW3bNyEhodQ9e3h46M4775R0ftbasLAw7dixw/ZnVp5du3bprrvu0uLFi+Xv7+/o2wMA0whSAIDLYhiGlixZopiYmHK3+/j42H7v7u5eZrmoqKjCc1sslnLXt2jRolQPRmpqaqVfwh3NMAyNHz9es2bNKnd7ddyzsxmGoeDg4ErHn5XcZ0mQvnC5snuWKr/vPXv2aNiwYXr99dfVu3dvk5UDQPVgjBQAwJTAwECdPXvWtnz99ddr9uzZti/KGRkZOnDggF3nXrhwoaTzvTsff/yxBgwYUO5+o0eP1rJly5Seni7DMPTSSy+V6ilxtKCgoFL3PGLECL399tu2xwmtVqu2bdtm17lXrFihEydOSJJee+01DRw48PILdoCL7zk2NlZBQUGlHgc8cOCATp8+bfrcRUVFeuuttyRJW7Zs0bFjx2y9khfbu3evhgwZoldeeUVJSUmmrwUA1YUgBQAwZerUqUpKSrJNNvHMM8/I19dX8fHx6tixowYMGKDU1FS7zh0SEqLOnTsrISFBkyZNqvCxvqioKD3xxBPq1auXoqOjFRISonvvvfcy7qpy48aN0/vvv6+rrrpKr732mvr06aM5c+bohhtuUKdOnRQXF6f33nvPrnP36dNHt956q9q0aaPDhw9X2MslSffee6/Cw8OVlpama6+9VtHR0fbe0iWVTATRvn17jRgxQh4eHvrss8/00Ucf2bZNnDjR9jijGfXq1dOPP/6oTp066a677tI777yjwMDAcvedPHmyzp49qxkzZig+Pl7x8fH64osvLvf2AOCy8WgfAMCUmTNnaubMmaXWXTh724VKZmorcXGvzcU9V7feeqvmzJlTpTruvvtu3X333VXa93J17drVNpFEiZtvvrncXrA777zTNv5HUpmXrT/66KOllsPDw/Xhhx9WqY6XX365ihVfvpLgdKFWrVrp008/LXd/wzBsvw8ICCi1HB4ebpupsMS8efOqVMdXX31V1ZIBoEbRIwUAcHkhISG6/fbbS72QtyIlL+Rt0qSJ3NxqbzMXEBCgTz/99JLvhiqRmJiodevW1eqJGNzd3eXn51fqhbyVWbx4sYYPH26byAMAahI9UgAAl1DZ44Dlvd+pIlV5Ia+rePzxxyvc9uCDD+rBBx+s8rkuntLdVUVEROjMmTPlbmvevLmOHTtW5XONHTvWNlMgANS02vujOgAAAABwEoIUAEC6eOppq9U5dQBwvDL/nl1zin2gtiFIAQAkP9/Sy5mZzqkDgEMZhiGdPVd65cX/3gHYhTFSAABZGgbLuGDZuuMHuRmGy74cFqgufr4eytp0h7PLMMXPt5Kvc78ckU5nlFplaRhczRUBVwaCFABAbt26yPrekv+tSD8h45uNsvTr5byiACewWCzy9/N0dhkOYVitKv5waemVjRpKURHOKAeocwhSAAApKlIKbSKln7CtKn7mRVl/2CW3nt1laRoqedWNL5dAnWYYUl6ejP0HZF29TsauPaU2u/XqLkstfi0A4EoIUgAAWSwWuSUlyvrWe/9babXK+GqNir+qHdNqA7gED3e59e/j7CqAOoMfSQAAJEluN14vtyGDnF0GgOrg4S73GQ/I0irS2ZUAdQZBCgAg6b+9UvdOkNuwwc4uBYAjeXnKfcYDcuvWxdmVAHUKj/YBAGwsFovc77lLbiOHyrpxs4xvv5ORclgqKnJ2aQDM8PWVpVP782OiunaWhSnPAYcjSAEAyrA0aSz3G4brhXOFyoyKU6CfjyaNvU4vLl6hzOw8Bfr7aNLYIc4uE0B5vLxk8eArHlDd+FcGAKhQZlauzmVlS5Isfn7KzMnXuewcyWKRxc/PydUBAOA8jJECAAAAAJMIUgAAAABgEkEKAAAAAEwiSAEAAACASQQpAAAAADCJIAUAAAAAJhGkAAAAAMAkghQAAAAAmESQAgAAAACTCFIAAAAAYBJBCgAAAABMIkgBAAAAgEkEKQAAAAAwiSAFAAAAACYRpK5gb731ljp37qwGDRrI19dXbdu21fz582UYhrNLQyVWrFih+Ph4eXt7KyIiQvPnz3d2STXqm2++0ciRI9WyZUtZLBb97W9/c3ZJNWru3Lnq0aOHGjRooPr166t37976/PPPnV0WANQo2sIrty10pXaQIHUFa9y4sR577DFt3LhRu3fv1l/+8hc99thjev75551dGiqwbds2jRw5Utddd52Sk5P1+OOP6+GHH9ZLL73k7NJqTFZWltq1a6c5c+YoNDTU2eXUuNWrV2vChAlas2aNtmzZop49e2rYsGHasGGDs0sDgBpBW3hlt4Wu1A561PgV4TKuvfbaUstRUVFaunSp1q5dq/vvv99JVaEy8+fPV9euXfXUU09Jktq2bavdu3fr6aef1n333efk6mrGkCFDNGTIEEnSjBkznFxNzVu5cmWp5Tlz5ujzzz/XRx99pF69ejmpKgCoObSFV3Zb6ErtID1SkCQZhqEtW7Zow4YNSkxMdHY5qMCGDRs0ePDgUusGDx6sw4cPKy0tzUlVwZmsVqvOnTsnf39/Z5cCADWCthAXcmY7SI/UFe7s2bNq1qyZCgoKZLVaNXPmTE2ePNnZZdU6h4+e0IZtu8qsz83Ls/36zieryiyX8PH20oikXvJwd6/0OsePHy/ThV+yfPz4cYWHh1/WfdirqKhYn3y1QfkFBaXWV/X+Jal3lw5q0axJzRRcDbb9sE/7U46UWlfe/Vb0ZxDWpJH6d483fd1Zs2bpzJkzuueee+ysHAAcY/3WH3Tk2MlS68x8DrZqGaZu8e0ueR1XbQuPpp/Sus3JZdZXtS309PTQyKTe8vKsnV/Pi61Wfbpqo3Jy80qtN/NdoPtV7RTVIszUdZ3ZDtbO/1NwmMDAQCUnJysnJ0cbN27UQw89pLCwME2cONHZpdUqzZuGKDM7VylHjpe7vbCoWD/8dKjC5RuH9LtkiHJlHh7uatGssZas/Kbc7Ze6/6gWTRUe1rja66xOsa2aa+W6zcrOySuz7eL7vXidh7u7BvS82vQ1//Wvf2nWrFlatmyZ0744AECJtq1a6sv121RYWFRm26U+B328vTT0mh41Umd1CWvSUHn5BdqfUn6v2KXawpFJvWptiJIkdzc3RTZvqneXfV3u9kvdf/OmIWoZbm68l7PbQR7tu8K5ubkpOjpaHTt21H333afp06frkUcecXZZtY6bm5tuGtpf3l6epo+Ni4lQ5/YxVdq3adOmSk9PL7XuxIkTtm3O1KVDrNpGtzR9nLeXp24a0l9uFks1VFVzAv39NOravnYde22/rmoSEmzqmHnz5mnatGlatmyZBg4caNd1AcCRGgXX09DE7nYde8Og3qoXWLVHs1y1LbRYLLrxun7y8/E2fWzriHB1v+rSvXGurlPbVopvF236OE8Pd40Zlih3t6pHE1doBwlSKMVqtSovr+xP1HFpwfUCNXxgT1PHBPj76oZr+8hSxRDRq1cvffHFF6XWff7552rZsqXTeyQsFotGD+4rfz8fU8eNSOqlBvUCq6mqmhUXE6HOHaoWiktEtQhTry4dTB3zf//3f3riiSe0YsUKQhQAl9Itvq1io5qbOqZT21bqZOLLtyu3hUGB/rr+2j6mjvH18daNQ/pV+buAqxuR1EtBAebGKw29podCgutXeX9XaQcJUlewmTNnatWqVTp06JD27dunV199VbNnz9b48eOdXVqt1bl9jNq1jqjy/qMH91WAn2+V9//zn/+sLVu26JFHHtFPP/2kRYsW6YUXXtBf/vIXO6p1vAB/X40eXPVembiYCF0d19rUNbKyspScnKzk5GQVFBQoPT1dycnJOnDggNlyq8XwAT2rHAy9vTw1Zqi53rgpU6Zo7ty5euuttxQbG6v09HSlp6fr7Nmz9pYMAA5jsVg0+rp+8vOtWq9MUIC/RiaZm2nN1dvCjm2iTPXKXG+iN66EK7eFfj7eumlovyrvHxPZXN3i21Z5f1dqBy0Gb1+9Yv35z3/Wp59+qqNHj8rHx0dRUVGaMGGC7rvvPrnX4vE6zpaVk6tnF3yorJzcSvdL6NRGo0yEjhLLly/Xww8/rJ9++kmhoaG6//779cADD9hbbrX4cOU6bfthX6X7BPj76s8TbjLdg7V27dpyZ5bs16+f1q5da+pc1SXlyHG98s6nutSH69hhibrKZJCs6CeW48eP18KFC02dqypm/fM/OpeVraAAfz38x9vKLANAeXbtO6T/LF11yf0mjhmi1pHme5FcvS3MzcvXs69/qLOZ2ZXuF98uWjcPv8b0+WtDW7hs1UZt/P7HSvfx8/HWlAk3KshEkKzpdrDSWghSgOPtPXBYi5Z8UeH24PqBuv+uG+0aU1Ub5OcX6Lk3luj02cwK97nzxsFq06pFDVZVs1au3ax1m3dWuL1DbKRuHTnQ5R/lIEgBsNfiz9Zox+6fK9zes3OcRgysu++/O5B6VK8tXl7h9qAAf02ZeKNdY6pqg8LCIj2/8CP9evpMhfvcOnKgOraJqrmiHIxH+1AlK9duVvKeA7Jarc4upVZoG91SCZ3alLvNYrFo7NDEOhuiJMnb20tjhiWqoojQLb5tnQ5RkpTUu4tCK5hAIjDAT9ebGBsHALXRyKReqh8UUO62kOB6GtyvWw1XVLOiI5qpV5f2FW6/aah9E1PUFp6eHho7PFFubuW3dVfFRdfqECURpFAF6b+e1rrNO/Xep6v162nGYVTV0Gt6KLh+2bEy/bt3Mj29Z20UER6qvt06lVnfsH6Qhtg5q1Nt4uHhrrHDEuXuXvZj9sbBfeXva+6RRgCobXy8vXTTkP5l1ru5WTR22DW1eqrvqhrcN0GNG9Yvs75n5/ZqHVH3X1sRHhqiAb06l1lfL9C/TvRGEqRcRHFxsd566y0NGjRIISEh8vb2VosWLTR48GC99tprKi4udlptX2/YLknqEBulJo0aOK2O2ub8RAKJpXodwpo0LPcDpa5K6t1FTRs3tC1bLBaNGVa3e+Mu1LRxQw3q07XUuu5XtVNsHe+NA4ASrVqGqXfX0jOTXtPzaoU3DXFSRTXL09NDY4ddU6pXJiS4vq7rl+DEqmpW/+7xanHRuyJvGtpfvnWgN44g5QLOnTunpKQk3XHHHfrqq6/k5eWlTp06yWq16ssvv9Tdd9+tzMyKx5pUp/RfT2vXvvMvSxvQy/wLQ690EeGh6vffXhkPd3eNHZpYq1+8a9bFvTL9u8erZbMmTq6qZvXp2kGRzc+/16RRg3oa0r9uP8oCABe7tm9X2w9imzcNUWKPq5xcUc1qFtpIA//7Q1Q3N4vGDk+U5xXQG1fC3c1NY4b+7557dWmv6JbNnFyVYxCkXMDEiRO1Zs0ahYeHa/Xq1Tp69Ki2bNmitLQ0HT9+XH//+9/l6emcn+Bf2BtV0XgPVG5g785q2rihXS9drQtCQ4J1bd8ENWvS6IoM4yUva/b18daYYYnyukJ64wCghKeHh8YMS5TPf8fPmnnpal3Rr3u8WoQ10YBenRUeemX0xl2o5GXNjRs20OC+dac3jln7nOz7779Xly5d5OHhoR07dqh9+4oHJZr1wqKPlJlV+RTclbFarbYpvAP8fOV2BX7wOYrVapXFYrliJxcwDEOGYVzRf4esVmutvP/M7BwZhiGLxaJAf78yywBQVbX1c9BR+C7gmt8FAgN89afxo+w69srpV3RRS5culSQNHTrUoSFKkjKzcnUuq/L3F1TVpd6JBKBuMwyj1OfJxcsAAFxpCFJOtmfPHklSjx49HH7uwABfu4+lNwqARI8UAKBuu5zvywQpJzt37pwkqV69eg4/t73dlJL0n6WrtGvfIXWIjdJt1w90YFUAapOSF/AG+vuVeiFvyTIAAFcqgpSTBQUFSZLOnnX8+5nsHSN1YW9UypHjmvXP/zi6NAC1RGZ2ju3XWf/8T5llAABqM8ZI1WJxcXH66KOP9N133zn83I4YI8XYKAASY6QAALgYQcrJbrjhBv31r3/VihUrtGfPHrVr185h57bnmU/GRgG4EGOkAAB12eWMkWL6cxcwduxYvf/++2rRooXefPNN9evXz7btxIkTev311zV58mT5+/tXey2MjQJwoZIxUUEB/qXGSJUsAwBwpaJHygW8+uqrOnnypNauXav+/furWbNmCgsL0/Hjx3X06FEZhqHf//731V5H+q+ntWvfIUm6Il+cCgAAAFQVz225gKCgIK1atUoLFixQ//79lZOTo507d8rNzU3XXnutFixYoMDAwGqvY813OyRJHWKjFBoSXO3XAwAAAGoreqRchLu7uyZMmKAJEyY4rYYh/bvJz9dH3eLbOq0GAAAAoDYgSMGmXlCARib1cnYZAAAAgMvj0T4AAAAAMIkgBQAAAAAmEaQAAAAAwCSCFAAAAACYRJACAAAAAJMIUgAAAABgEkEKAAAAAEwiSAEAAACASQQpAAAAADCJIAUAAAAAJhGkAAAAAMAkghQAAAAAmESQAgAAAACTCFIAAAAAYBJBCgAAAABMIkgBAAAAgEkEKQAAAAAwiSAFAAAAACYRpAAAAADAJIIUAAAAAJhEkAIAAAAAkwhSAAAAAGASQQoAAAAATCJIAQAAAIBJBCkAAAAAMIkgBQAAAAAmEaQAAAAAwCSCFAAAAACYRJACAAAAAJMIUgAAAABgEkEKAAAAAEwiSAEAAACASQQpAAAAADCJIAUAAAAAJhGkAAAAAMAkghQAAAAAmESQuoK99dZb6ty5sxo0aCBfX1+1bdtW8+fPl2EYzi4NAAAAcGkezi4AztO4cWM99thjio2Nlbe3t9avX68//OEPcnd31/333+/s8gAAAACXRZC6gl177bWllqOiorR06VKtXbuWIAUAAABUgkf7IEkyDENbtmzRhg0blJiY6OxyAAAAAJdGj9QV7uzZs2rWrJkKCgpktVo1c+ZMTZ482dllAQAAAC6NIHWFCwwMVHJysnJycrRx40Y99NBDCgsL08SJE51dGgAAAOCyCFJXODc3N0VHR0uSOnbsqIyMDD3yyCMEKQAAAKASjJFCKVarVXl5ec4uAwAAAHBp9EhdwWbOnKk+ffooKipKhYWF+uabbzR79mzdddddzi4NAAAAcGl1Jkg9++yzOnPmjKZMmaL69es7u5xa4dy5c7rvvvt09OhR+fj4KCoqSk899ZTuu+8+Z5cGAAAAuLQ6FaQOHz6sO++8kyBVRc8884yeeeYZZ5cBAAAA1DqMkUKVHE5LV35+gbPLAAAAAFxCnemRQvXJyy/QoiVfSBbp3ltHqEmjBs4uCUANOH78uFav/Fg7tmxQbnaWnnvyAfkG1Ff7zj3VtWdfZ5cHAIBT1foeqYULF8pisejw4cOSpMjISFksFtt/CxcutO2bn5+v5557Tj179lT9+vXl4+Oj2NhYTZs2TadOnSpz7tTUVFksFkVERNiu1aVLF/n7+ys0NFQTJkzQyZMnbfu/+eab6tq1qwICAtSwYUONGzdO6enpZc67du1aWSwW9e/fX8XFxZozZ47i4uLk6+urxo0b65ZbbtGBAwcc+wd1Gb7bvls5efny8/VRSHA9Z5cDoJpZrVY98sgjatGihb5evkSnf01Xbk6WTp48qcOH9mv5Bws159HJWrlypbNLBQDAaWp9kGrSpIl69eolb29vSVKXLl3Uq1cv239NmjSRJJ04cUI9evTQlClTtHnzZtWvX18xMTE6fPiw5s2bp86dO+vQoUMVXmf69Om66667dPr0aUVHRysjI0NvvPGGBg4cqPz8fP35z3/W+PHjderUKbVq1UpZWVl6++23NWDAAOXn55d7TsMwdOONN2rGjBnKzc1VXFycsrKy9N577+nqq6/W1q1bHf8HZlJefoHWb/lBkjSg59Vyc6v1f2UAVMIwDP3xj3/UrFmzVFRUVOF+OdlZGj58uD755JMarA4AABdi1BEtW7Y0JBkpKSlltlmtVqNfv36GJGPo0KGl9snMzDQmTJhgSDJ69OhR6riUlBRDkuHh4WEEBQUZK1eutG1LTU01oqKiDEnGDTfcYAQGBpbanpKSYkRERBiSjH//+9+lzrtmzRpDkuHp6WkEBAQYK1assG3LyMgwhg8fbkgyoqKijNzc3Mv8k7k8qzduN2Y8/bIx95X3jOLiYqfWAqD6vfXWW4akKv/n6+trpKWlObtsAABqnMUwDKOGs1u1iIiI0OHDh5WSkmJ7FK/EihUrNHToULVv315bt26Vj49Pqe3FxcVKSEjQ9u3b9e2336pXr16Szj/aFxkZKUn6xz/+oQceeKDUcS+99JJ+//vfV7j93//+t/7whz9oxIgRpX5qu3btWiUmJkqS5s6dqwcffLDUcZmZmWrRooXOnDmjRYsW6Y477rDrz+SFRR8pMyvXrmMlyZChrKwcGZJ8fbzl6cGQOqCu+9ecx3T0lxRTx1wzZJQGDBlVTRUBAFB9AgN89afx9rVhV8Q34yVLlkiSxo8fXyZESZK7u7tGjBih7du3a+3atbYgdaGJEyeWWXf11VdXaXtFjwx6enrqnnvuKbM+MDBQEyZM0Pz587Vy5Uq7g1RmVq7OZWXbdezFcvPylavyH1EEUDccP5JqOkRJ0pZvV6tzr4Fyc3evhqoAAHBNV0SQ+uGH82N83njjDS1durTcfU6cOCFJOnr0aJltjRo1Ur16ZSdZCAkJqXR748aNJUlZWVnlXrN58+YKCgoqd1u7du0kSfv27St3e1UEBvjafaxkKJPeKOCKsvfUcbuOyzp3RrIWKqhe+Z9nAAC4qsv5vnxFfDs+c+aMJGnPnj2X3DcnJ6fMOn9//3L3tVgsVdpe0dOTJUGrPCWTZGRmZlZc7CXY200pSWu+26EvvtmqRsH19MDEm5hkArgCzMs9rmWL7Tt2wo2D1KZNG8cWBACAC7siglRAQIAkadmyZRo+fLiTq/mfC6dOv1hJD1lgYKDd57d/jNT53ihJys7J09P/ftfuGgDUHlt3/GT3sYs+/lqBQd87sBoAAKofY6T0v96f8sTFxSk5OVk//vijSwWptLQ0ZWZmlhuWSnrPYmNj7T6/I8ZIMTYKuHI0bREti8VSYS96RZqENZfV4uGwMZkAANQGdSZI+fqef74xN7dsD8yNN96o//znP3rllVf0pz/9ydZD5WwFBQV69dVXy8z2l5WVpTfeeEOSNHjwYLvPb98zn4yNAq5UQQH+atPhau39wVzPUo/+g1Qv0DU+VwEAMIMxUpJatWqlvXv3avXq1Wrbtm2pbSNHjlS/fv20bt06DRo0SK+88orat29v2261WrV582YtWrRI06dPV1RUVI3U7Onpqccff1zt27fXoEGDJElnz57VnXfeqYyMDEVGRmrs2LF2n9+ebkrGRgFXtsSro9S3b99KX8Z7oaioKL39ynMVjhUFAKCuqjPfkm+55RZJ0qRJkxQXF6f+/furf//++vzzz2WxWPThhx+qZ8+e+u6779ShQwdFRESoe/fu6tSpk4KCgtSzZ0+9/PLLKigoqLGae/TooQEDBujaa69Vq1at1LVrVzVt2lRLly5VQECA3nnnnXKna68u+fkFWr/l/AyHA3peTYgCrkA9evTQwoUL5V6FqcybNm2qlStXEqIAAFekOvNN+dZbb9U///lPXXXVVUpNTdW6deu0bt06paenSzo/Rfm6deu0cOFCJSUlKTs7W9u2bVNKSoqio6N1//33a926dYqJiamxmksC3tNPPy1vb2/9+OOP8vPz09ixY/X999+re/fuNVaLJG3cvls5eflqFFxPndq2qtFrA3Adt912m5YvX64OHTqUu91isWjYsGHatGlTjX5mAgDgSiyG2VHFuGxr165VYmKi+vXrp7Vr1zq7HJtNO/boq/XbNGxAD10V19rZ5QBwMsMwtGHDBr333ns6ceKEPD09FR0drQkTJigiIsLZ5QEA4FR1ZowULl/3q9rp6rjW8vC49CM9AOo+i8Wi3r17q3fv3s4uBQAAl0OQQileXp7OLgEAAABweXVmjBQAAAAA1BSCFAAAAACYxGQTAAAAAGASPVIAcIWwWCzq0KGDVqxYUWPXfOaZZxQdHa34+PgauyYAADWBHikAuEJYLBZlZGSofv36NXK9oqIieXh4aO3atZoyZYqSk5Nr5LoAANQEeqQA4ApVWFiov/zlL0pISFB8fLzGjBmjjIwM/frrr4qIiNCmTZskSR9++KE6deqk3NxcrV27Vu3bt9cdd9yh9u3bq3PnzraAtHbtWsXFxWnixImKj4/Xxx9/7MS7AwCgehGkAOAKNXfuXPn7+2vLli1KTk5Whw4d9OijjyokJERvvfWWbrvtNm3ZskVTpkzRBx98IF9fX0nS7t27NX78eP3444+aMWOGbr75ZpU83LB3717dcccdSk5O1k033eTM2wMAoFrxHikAuEItXbpUZ8+e1ZIlSyRJBQUFioiIkCT16dNHEydOVM+ePfXmm28qJibGdlxERIQGDBggSRozZozuueceHTlyRJIUFRWlfv361eyNAADgBAQpALhCGYahF154QYMGDSp3+44dOxQSEmILSRWxWCyyWCySpICAAIfXCQCAK+LRPgC4Ql1//fV65plnlJOTI0nKycnR7t27JUkvvviiMjIytHPnTr388svasGGD7bjU1FStWbNG0vnxU02aNFF4eHjN3wAAAE5EjxQAXKFmzJih/Px8devWzdajVLJu3rx52rx5sxo3bqy3335bt99+u7Zu3SpJiouL08KFCzV58mR5eXnp3XfftR0PAMCVgunPAeAK4Yjpz+2ZypzpzwEAdRGP9gHAFaJJkybq169fjb+Q9w9/+IMaNWpUY9cEAKAm0CMFAAAAACbRIwUAAAAAJhGkAAAAAMAkghQAAAAAmESQAgAAAACTCFIAAAAAYBJBCgAAAABMIkgBAAAAgEkEKQAAAAAwiSAFAAAAACYRpAAAAADAJIIUAAAAAJhEkAIAAAAAkwhSAAAAAGASQQoAAAAATCJIAQAAAIBJBCkAAAAAMIkgBQAAAAAmEaQAAAAAwCSCFAAAAACYRJACAAAAAJMIUgAAAABgEkEKAAAAAEwiSAEAAACASQQpAAAAADCJIAUAAAAAJv0/bZ7DyKr7wwYAAAAASUVORK5CYII=", "text/plain": [ - "
" + "\"Output" ] }, "execution_count": 10, diff --git a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/101aaa8f-7061-4924-9b50-806d7e1ab728-0.avif b/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/101aaa8f-7061-4924-9b50-806d7e1ab728-0.avif new file mode 100644 index 0000000000000000000000000000000000000000..52d18bc29e64b18f2c9a5a73d107d86cc5f51fc5 GIT binary patch literal 2536 zcmZutc|6p67oNqIB^ujQ*1RY!7{s-dkX=y*5$-T!OlFvk#xh|<4bx1A zRzj9!zm!yxB{8HdG2EfI&->4NzMtPY&w0){zw>+!005BlBZuM+U<*Mq@g5X4YJ1QzeVd#3+x5#1U6e_JGeZvhJl z?d(y&;Bmk23jzT7fN_FC01zJy%ooe69>5S$zs|wa$J>VGodvjaFdb%tmG2Usk8sQnM1b;x=LqNL_QpenKM9otGI74 zj=i5nG8$vZzN>cp0abtgSdAyyjE{8d$~;Z(C^jgBn}eU%Rf7E9j;s|fAM;sz^#$;@ z6tx**r!m9c4yr7$`wa2nB$^1&wjK$dhvJSNbUABaV$v}GT_h_DpKI1U-%CrpAP*Rg zKQVn{`;}#ktLK^nJTfEj5>QubDO)#JeeF?k-P;m2pcB<2D>0GIrMAmldr^*mADTKY zWr==u&YAskB}>>$+FcC#4X$;M8f`u7n{<5L%PTduIFs6>mG*PH)K=6Y^Lvi@tsJo# zMSB~!pbmGS&SJgvEOQ|h{`zIPl+~wk?HHG8V%?L~ zCL$FS5gx40H?F3nY%-Zv(W_==Rr_edv&u4vNL;m{4Uzxlu1$wCck&2wkT*^ zakjHzdF2*?8;{!ZTk1F!Zk*+~7>%YEkjB)R*TY>$;?m6v?KW_Gr(0I#&_+35Gq;X_ zfF9@~5)9X`t)gP;q>{msO!A!tOe6>^#*n@1MvQUy-8+MZQiEwprw>EBPts0J`So-K zn&YgZ`Mk&<9aJR`U)Fa5b+wqw(E{_A_NU}ZXrhyved@t5D6lXThfKXR{5X?v<_Bxp z|CvVKOdAS3rjSH!%5!*w#ym!w(_en7={{;(SOhy}wRWD=s%({8o3L4ys=pM5tkI}d zJ~A+8)*0tfeuiZGEiqHzQ1z>fJ9IOdM#ukTH_4hMHXA{md>N_&Lrp}_eA!P#Cu%-ibpx0Y&UW&o%<9TS*^>a1g1O>Lx#OG z?6`N3mOSpt0z0=910U#y^lfhs@n;KrPy?`SRFii8B>FowZ}B6-eG4^A;nQ8Y{&W+e z0i}fU2$gz;gN?&$lc=7=@yU5Q$0Fxs_7!~}ygTF9ygzJuT+{GNV@yzwbj(*R)(JJ(Z4k9>A%O3QFy_fD{jkAP{YQx?ESWSSEtY6 zd3bxD^%wcSC(fP8jNq!xZsV%z6d(c@P97D`*>@ca?wtC=)r~roSaBI{C)<=Uiv!K) zv0LF&mm3@2ep(c*s=cx2wccEa{O}&*;kk#48%z-)&bdKJmph{h@B4jYJWd0;z2@rm z93e&dj-OlPz)jqV0}On=gv^^FeA-QLMJ}mSTR!2}SPn_tJ9UkCn4!S_37-2hcFuI?-c=bJll;`SL^GnXT=ldO2e5~ zyXmkYU3nOWGoVyaSS)Hzky3{kRx;IwpT8eF%*QnN@ z(ml7lm@`F<2v3Owk%(RbWBtR8;RQMSGSEPLU{(F3rFAVrNrZAx@>yxjM5ZZdvVhYuasDrD1I& zlFtL6MC_Qwq^erTJH@sQrKK_w`;o zbV{bpXD)?bM$_9 literal 0 HcmV?d00001 diff --git a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/174a9675-3c8b-4b5e-808e-f7e0f8b9c805-0.avif b/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/174a9675-3c8b-4b5e-808e-f7e0f8b9c805-0.avif new file mode 100644 index 0000000000000000000000000000000000000000..b922f2fde46468846b23198175475ebe08fe2af0 GIT binary patch literal 3382 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 gmg_&JIrAP3?FnVmIE2>Kv{ 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 literal 0 HcmV?d00001 diff --git a/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/f76db731-afa1-4777-9482-25376aa86175-0.avif b/public/docs/images/guides/classical-feedforward-and-control-flow/extracted-outputs/f76db731-afa1-4777-9482-25376aa86175-0.avif new file mode 100644 index 0000000000000000000000000000000000000000..e55c137ebcba3b3d39c51e31f6730fd04c5dd515 GIT binary patch literal 4576 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 literal 0 HcmV?d00001 From 259c06d276b35614d0cd10e02bc0cfeaa8d1fd8f Mon Sep 17 00:00:00 2001 From: Becky Dimock Date: Thu, 4 Jun 2026 10:27:55 -0500 Subject: [PATCH 8/9] rerun --- ...assical-feedforward-and-control-flow.ipynb | 27 ++----------------- 1 file changed, 2 insertions(+), 25 deletions(-) diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 0d16ca5c0b6..43a59e89210 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -2,7 +2,6 @@ "cells": [ { "cell_type": "markdown", - "id": "167f5294-9267-4452-bb64-8f2c7cf8c197", "metadata": {}, "source": [ "---\n", @@ -16,7 +15,6 @@ }, { "cell_type": "markdown", - "id": "ee6e62c6-db46-4fb4-b429-efa2df579bb8", "metadata": { "tags": [ "version-info" @@ -45,7 +43,6 @@ }, { "cell_type": "markdown", - "id": "bec2cbd3-d243-4a55-a586-af7480c0c58c", "metadata": {}, "source": [ "Dynamic circuits are powerful tools with which you can measure qubits in the middle of a quantum circuit execution and then perform classical logic operations within the circuit, based on the outcome of those mid-circuit measurements. This process is also known as _classical feedforward_. While these are early days of understanding how best to take advantage of dynamic circuits, the quantum research community has already identified a number of use cases, such as the following:\n", @@ -57,7 +54,6 @@ }, { "cell_type": "markdown", - "id": "558350d9-4d25-478f-876d-0fd5ad4d6aab", "metadata": {}, "source": [ "This guide demonstrates the functionality available in the Qiskit SDK for performing classical feedforward and control flow. These features are sometimes referred to collectively as \"dynamic circuits.\" Classical feedforward refers to the ability to measure qubits in the middle of a circuit and perform additional quantum operations that depend on the measurement outcome. Qiskit supports four control flow constructs for classical feedforward, each implemented as a method on [`QuantumCircuit`](../api/qiskit/qiskit.circuit.QuantumCircuit). The constructs and their corresponding methods are:\n", @@ -83,7 +79,6 @@ { "cell_type": "code", "execution_count": 1, - "id": "101aaa8f-7061-4924-9b50-806d7e1ab728", "metadata": {}, "outputs": [ { @@ -118,7 +113,6 @@ }, { "cell_type": "markdown", - "id": "4daeddea-bf3a-4420-9dd2-f6e5f824e8a3", "metadata": {}, "source": [ "The `with` statement can be given an assignment target which is itself a context manager that can be stored and subsequently used to create an else block, which is executed whenever the contents of the `if` block are *not* executed.\n", @@ -129,7 +123,6 @@ { "cell_type": "code", "execution_count": 2, - "id": "1f6737fe-bc45-4d0c-b7b4-1096e2d7e14a", "metadata": {}, "outputs": [ { @@ -165,7 +158,6 @@ }, { "cell_type": "markdown", - "id": "2d13f95d-fe97-421e-96b2-87654fa6eed3", "metadata": {}, "source": [ "In addition to conditioning on a single classical bit, it's also possible to condition on the value of a classical register composed of multiple bits.\n", @@ -176,7 +168,6 @@ { "cell_type": "code", "execution_count": 3, - "id": "37ec3fa6-04b5-4165-b8d2-bae5fd238331", "metadata": {}, "outputs": [ { @@ -211,7 +202,6 @@ }, { "cell_type": "markdown", - "id": "56d5fa19-ec32-4488-a941-10c2a778351d", "metadata": {}, "source": [ "## Switch statement\n", @@ -222,7 +212,6 @@ { "cell_type": "code", "execution_count": 4, - "id": "fc2bc3c3-eab1-41f0-b696-5e8b30155d55", "metadata": {}, "outputs": [ { @@ -259,7 +248,6 @@ }, { "cell_type": "markdown", - "id": "eb51c4e3-f56c-48ae-9ce7-5376f660c627", "metadata": {}, "source": [ "Because the example above used a single classical bit, there were only two possible cases, so we could have achieved the same result using an if-else statement. The switch case is mainly useful when branching on the value of a classical register composed of multiple bits, as demonstrated in the following example. Here, we also show how to construct a default case, which is executed if none of the preceding cases are. Note that in a switch statement, only one of the blocks are ever executed. There is no fallthrough.\n", @@ -270,7 +258,6 @@ { "cell_type": "code", "execution_count": 5, - "id": "a5d43b4c-c538-4f34-8cf3-92c2c0d26fdd", "metadata": {}, "outputs": [ { @@ -310,7 +297,6 @@ }, { "cell_type": "markdown", - "id": "9851ed6c-6060-4892-9082-782f5205f718", "metadata": {}, "source": [ "## For loop\n", @@ -323,7 +309,6 @@ { "cell_type": "code", "execution_count": 6, - "id": "53a26ce5-3564-47a0-8803-c9c46db86923", "metadata": {}, "outputs": [ { @@ -355,7 +340,6 @@ }, { "cell_type": "markdown", - "id": "59256f23-82f8-403e-9ab0-20b44b2eab3a", "metadata": {}, "source": [ "## While loop\n", @@ -368,7 +352,6 @@ { "cell_type": "code", "execution_count": 7, - "id": "174a9675-3c8b-4b5e-808e-f7e0f8b9c805", "metadata": {}, "outputs": [ { @@ -405,7 +388,6 @@ }, { "cell_type": "markdown", - "id": "03f8666a-1af9-46eb-96ed-f49189a7e6e5", "metadata": {}, "source": [ "## Classical expressions\n", @@ -421,7 +403,6 @@ { "cell_type": "code", "execution_count": 8, - "id": "5d168ba7-9765-4b13-9056-59b523a73915", "metadata": {}, "outputs": [], "source": [ @@ -482,7 +463,6 @@ { "cell_type": "code", "execution_count": 9, - "id": "d2fdf38a-e874-4de1-9a79-08aab97f9ecc", "metadata": {}, "outputs": [ { @@ -502,7 +482,6 @@ }, { "cell_type": "markdown", - "id": "da7af15b-678b-4d0b-a8e7-f377bf0b81c4", "metadata": {}, "source": [ "\n", @@ -518,7 +497,6 @@ { "cell_type": "code", "execution_count": 10, - "id": "f76db731-afa1-4777-9482-25376aa86175", "metadata": {}, "outputs": [ { @@ -565,7 +543,6 @@ }, { "cell_type": "markdown", - "id": "df4b77c8-3680-4ea2-8ad8-c74125dd5709", "metadata": {}, "source": [ "## Next steps\n", @@ -580,7 +557,7 @@ ], "metadata": { "kernelspec": { - "display_name": "Python 3", + "display_name": "Python 3 (ipykernel)", "language": "python", "name": "python3" }, @@ -594,7 +571,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3" + "version": "3.12.3" } }, "nbformat": 4, From 4efa8a8299c71da29214e9e9fad2fa9e6776bd0f Mon Sep 17 00:00:00 2001 From: Becky Dimock Date: Thu, 4 Jun 2026 11:02:37 -0500 Subject: [PATCH 9/9] tox again --- ...assical-feedforward-and-control-flow.ipynb | 27 +++++++++++++++++-- 1 file changed, 25 insertions(+), 2 deletions(-) diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 43a59e89210..6d052d5387c 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -2,6 +2,7 @@ "cells": [ { "cell_type": "markdown", + "id": "72a56be1-db57-4364-acf3-57814453b64e", "metadata": {}, "source": [ "---\n", @@ -15,6 +16,7 @@ }, { "cell_type": "markdown", + "id": "7f636096-9a03-4f72-823b-4b9219d496f0", "metadata": { "tags": [ "version-info" @@ -43,6 +45,7 @@ }, { "cell_type": "markdown", + "id": "ea7e102f-6e41-4bdd-95be-5dd13225952b", "metadata": {}, "source": [ "Dynamic circuits are powerful tools with which you can measure qubits in the middle of a quantum circuit execution and then perform classical logic operations within the circuit, based on the outcome of those mid-circuit measurements. This process is also known as _classical feedforward_. While these are early days of understanding how best to take advantage of dynamic circuits, the quantum research community has already identified a number of use cases, such as the following:\n", @@ -54,6 +57,7 @@ }, { "cell_type": "markdown", + "id": "b2953dd4-218e-4daa-a753-0d2aa5e0a0bb", "metadata": {}, "source": [ "This guide demonstrates the functionality available in the Qiskit SDK for performing classical feedforward and control flow. These features are sometimes referred to collectively as \"dynamic circuits.\" Classical feedforward refers to the ability to measure qubits in the middle of a circuit and perform additional quantum operations that depend on the measurement outcome. Qiskit supports four control flow constructs for classical feedforward, each implemented as a method on [`QuantumCircuit`](../api/qiskit/qiskit.circuit.QuantumCircuit). The constructs and their corresponding methods are:\n", @@ -79,6 +83,7 @@ { "cell_type": "code", "execution_count": 1, + "id": "f0f191a7-d59d-415f-a11b-9f39e431269b", "metadata": {}, "outputs": [ { @@ -113,6 +118,7 @@ }, { "cell_type": "markdown", + "id": "867d8f76-9cba-47fd-a341-ac40db6ee073", "metadata": {}, "source": [ "The `with` statement can be given an assignment target which is itself a context manager that can be stored and subsequently used to create an else block, which is executed whenever the contents of the `if` block are *not* executed.\n", @@ -123,6 +129,7 @@ { "cell_type": "code", "execution_count": 2, + "id": "d40249f1-d951-49e4-9ee9-662d3568f32f", "metadata": {}, "outputs": [ { @@ -158,6 +165,7 @@ }, { "cell_type": "markdown", + "id": "ba7b688a-e961-4361-9edf-47b387704f9d", "metadata": {}, "source": [ "In addition to conditioning on a single classical bit, it's also possible to condition on the value of a classical register composed of multiple bits.\n", @@ -168,6 +176,7 @@ { "cell_type": "code", "execution_count": 3, + "id": "6ccfd81b-0bda-409e-bd9a-116848df631b", "metadata": {}, "outputs": [ { @@ -202,6 +211,7 @@ }, { "cell_type": "markdown", + "id": "f85c34ed-bca6-40b9-9db2-e534f8c79010", "metadata": {}, "source": [ "## Switch statement\n", @@ -212,6 +222,7 @@ { "cell_type": "code", "execution_count": 4, + "id": "04b82e33-7c95-4042-a5e9-d00ff075ca02", "metadata": {}, "outputs": [ { @@ -248,6 +259,7 @@ }, { "cell_type": "markdown", + "id": "e0da6aa3-736e-4eb5-ad36-8626236f7604", "metadata": {}, "source": [ "Because the example above used a single classical bit, there were only two possible cases, so we could have achieved the same result using an if-else statement. The switch case is mainly useful when branching on the value of a classical register composed of multiple bits, as demonstrated in the following example. Here, we also show how to construct a default case, which is executed if none of the preceding cases are. Note that in a switch statement, only one of the blocks are ever executed. There is no fallthrough.\n", @@ -258,6 +270,7 @@ { "cell_type": "code", "execution_count": 5, + "id": "6aaba57e-7841-47d3-8f31-f922cb2b81f7", "metadata": {}, "outputs": [ { @@ -297,6 +310,7 @@ }, { "cell_type": "markdown", + "id": "e5f1da75-abcc-42de-8aa6-6f2a6d450ddd", "metadata": {}, "source": [ "## For loop\n", @@ -309,6 +323,7 @@ { "cell_type": "code", "execution_count": 6, + "id": "c6c91715-7a98-46a8-885e-92d3d1f99557", "metadata": {}, "outputs": [ { @@ -340,6 +355,7 @@ }, { "cell_type": "markdown", + "id": "98e7b4f3-e73e-4caf-9326-11b45bd6cfcf", "metadata": {}, "source": [ "## While loop\n", @@ -352,6 +368,7 @@ { "cell_type": "code", "execution_count": 7, + "id": "c26465ff-5d3e-4799-8c68-c327abff5694", "metadata": {}, "outputs": [ { @@ -388,6 +405,7 @@ }, { "cell_type": "markdown", + "id": "672080db-913d-4511-ab63-48ca48b60fa5", "metadata": {}, "source": [ "## Classical expressions\n", @@ -403,6 +421,7 @@ { "cell_type": "code", "execution_count": 8, + "id": "8c8ad702-1097-411f-983d-b5654f75059f", "metadata": {}, "outputs": [], "source": [ @@ -463,6 +482,7 @@ { "cell_type": "code", "execution_count": 9, + "id": "a5d808f5-d424-4133-a557-89d2f2a2c853", "metadata": {}, "outputs": [ { @@ -482,6 +502,7 @@ }, { "cell_type": "markdown", + "id": "62134a85-608f-4ad2-a76e-b0736bec9362", "metadata": {}, "source": [ "\n", @@ -497,6 +518,7 @@ { "cell_type": "code", "execution_count": 10, + "id": "953fa3ca-f542-47ea-9cf2-36a616ecb7f7", "metadata": {}, "outputs": [ { @@ -543,6 +565,7 @@ }, { "cell_type": "markdown", + "id": "f1b55508-04e8-4f53-9b13-33302102711d", "metadata": {}, "source": [ "## Next steps\n", @@ -557,7 +580,7 @@ ], "metadata": { "kernelspec": { - "display_name": "Python 3 (ipykernel)", + "display_name": "Python 3", "language": "python", "name": "python3" }, @@ -571,7 +594,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.12.3" + "version": "3" } }, "nbformat": 4,