01-qiskit-installation-and-verification.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "8a834b5b",
   "metadata": {},
   "source": [
    "# Qiskit Installation and Verification"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "c199f7cb",
   "metadata": {},
   "source": [
    "This Jupiter Notebook is designed to check whether Qiskit is installed on the system. If Qiskit is not found, this notebook provides step-by-step instructions on how to install and verify the installation of Qiskit."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "a47c2756",
   "metadata": {},
   "source": [
    "## Checking if Qiskit is Installed"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "9fbe0b4b",
   "metadata": {},
   "source": [
    "The following code tells you about the version number of any *Qiskit* library that is already installed in your system."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "b7fcafd0",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The version of Qiskit is 0.43.1\n",
      "\n",
      "The version of each component:\n",
      "qiskit-terra -> 0.24.1\n",
      "qiskit-aer -> 0.12.0\n",
      "qiskit-ignis -> None\n",
      "qiskit-ibmq-provider -> 0.20.2\n",
      "qiskit -> 0.43.1\n",
      "qiskit-nature -> None\n",
      "qiskit-finance -> None\n",
      "qiskit-optimization -> None\n",
      "qiskit-machine-learning -> None\n"
     ]
    }
   ],
   "source": [
    "import qiskit\n",
    "versions = qiskit.__qiskit_version__\n",
    "print(\"The version of Qiskit is\",versions['qiskit'])\n",
    "print()\n",
    "print(\"The version of each component:\")\n",
    "for key in versions:\n",
    "    print(key,\"->\",versions[key])"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "71ecea8e",
   "metadata": {},
   "source": [
    "## Qiskit Installation"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "91727adb",
   "metadata": {},
   "source": [
    "#### Make sure to restart the kernel after executing the following command to apply the changes to the current norebook."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "cc89f4e9",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Requirement already satisfied: qiskit[visualization] in /home/mirza/.local/lib/python3.10/site-packages (0.43.1)\n",
      "Collecting qiskit[visualization]\n",
      "  Downloading qiskit-0.43.2.tar.gz (9.1 kB)\n",
      "  Installing build dependencies ... \u001b[?25ldone\n",
      "\u001b[?25h  Getting requirements to build wheel ... \u001b[?25ldone\n",
      "\u001b[?25h  Installing backend dependencies ... \u001b[?25ldone\n",
      "\u001b[?25h  Preparing metadata (pyproject.toml) ... \u001b[?25ldone\n",
      "\u001b[?25hRequirement already satisfied: qiskit-terra==0.24.1 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit[visualization]) (0.24.1)\n",
      "Collecting qiskit-aer==0.12.1 (from qiskit[visualization])\n",
      "  Downloading qiskit_aer-0.12.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (12.8 MB)\n",
      "\u001b[2K     \u001b[38;2;114;156;31m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m12.8/12.8 MB\u001b[0m \u001b[31m3.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0mm eta \u001b[36m0:00:01\u001b[0m[36m0:00:01\u001b[0m\n",
      "\u001b[?25hRequirement already satisfied: qiskit-ibmq-provider==0.20.2 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit[visualization]) (0.20.2)\n",
      "Requirement already satisfied: matplotlib>=2.1 in /usr/lib/python3/dist-packages (from qiskit[visualization]) (3.5.1)\n",
      "Requirement already satisfied: ipywidgets>=7.3.0 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit[visualization]) (8.0.6)\n",
      "Requirement already satisfied: pydot in /home/mirza/.local/lib/python3.10/site-packages (from qiskit[visualization]) (1.4.2)\n",
      "Requirement already satisfied: pillow>=4.2.1 in /usr/lib/python3/dist-packages (from qiskit[visualization]) (9.0.1)\n",
      "Requirement already satisfied: pylatexenc>=1.4 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit[visualization]) (2.10)\n",
      "Requirement already satisfied: seaborn>=0.9.0 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit[visualization]) (0.12.2)\n",
      "Requirement already satisfied: pygments>=2.4 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit[visualization]) (2.15.1)\n",
      "Requirement already satisfied: numpy>=1.16.3 in /usr/lib/python3/dist-packages (from qiskit-aer==0.12.1->qiskit[visualization]) (1.21.5)\n",
      "Requirement already satisfied: scipy>=1.0 in /usr/lib/python3/dist-packages (from qiskit-aer==0.12.1->qiskit[visualization]) (1.8.0)\n",
      "Requirement already satisfied: requests>=2.19 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (2.31.0)\n",
      "Requirement already satisfied: requests-ntlm<=1.1.0 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (1.1.0)\n",
      "Requirement already satisfied: urllib3>=1.21.1 in /usr/lib/python3/dist-packages (from qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (1.26.5)\n",
      "Requirement already satisfied: python-dateutil>=2.8.0 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (2.8.2)\n",
      "Requirement already satisfied: websocket-client>=1.5.1 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (1.6.0)\n",
      "Requirement already satisfied: websockets>=10.0 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (11.0.3)\n",
      "Requirement already satisfied: rustworkx>=0.12.0 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-terra==0.24.1->qiskit[visualization]) (0.13.0)\n",
      "Requirement already satisfied: ply>=3.10 in /usr/lib/python3/dist-packages (from qiskit-terra==0.24.1->qiskit[visualization]) (3.11)\n",
      "Requirement already satisfied: psutil>=5 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-terra==0.24.1->qiskit[visualization]) (5.9.5)\n",
      "Requirement already satisfied: sympy>=1.3 in /usr/lib/python3/dist-packages (from qiskit-terra==0.24.1->qiskit[visualization]) (1.9)\n",
      "Requirement already satisfied: dill>=0.3 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-terra==0.24.1->qiskit[visualization]) (0.3.6)\n",
      "Requirement already satisfied: stevedore>=3.0.0 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-terra==0.24.1->qiskit[visualization]) (5.1.0)\n",
      "Requirement already satisfied: symengine<0.10,>=0.9 in /home/mirza/.local/lib/python3.10/site-packages (from qiskit-terra==0.24.1->qiskit[visualization]) (0.9.2)\n",
      "Requirement already satisfied: ipykernel>=4.5.1 in /home/mirza/.local/lib/python3.10/site-packages (from ipywidgets>=7.3.0->qiskit[visualization]) (6.23.2)\n",
      "Requirement already satisfied: ipython>=6.1.0 in /home/mirza/.local/lib/python3.10/site-packages (from ipywidgets>=7.3.0->qiskit[visualization]) (8.14.0)\n",
      "Requirement already satisfied: traitlets>=4.3.1 in /home/mirza/.local/lib/python3.10/site-packages (from ipywidgets>=7.3.0->qiskit[visualization]) (5.9.0)\n",
      "Requirement already satisfied: widgetsnbextension~=4.0.7 in /home/mirza/.local/lib/python3.10/site-packages (from ipywidgets>=7.3.0->qiskit[visualization]) (4.0.7)\n",
      "Requirement already satisfied: jupyterlab-widgets~=3.0.7 in /home/mirza/.local/lib/python3.10/site-packages (from ipywidgets>=7.3.0->qiskit[visualization]) (3.0.7)\n",
      "Requirement already satisfied: pandas>=0.25 in /home/mirza/.local/lib/python3.10/site-packages (from seaborn>=0.9.0->qiskit[visualization]) (2.0.2)\n",
      "Requirement already satisfied: pyparsing>=2.1.4 in /usr/lib/python3/dist-packages (from pydot->qiskit[visualization]) (2.4.7)\n",
      "Requirement already satisfied: comm>=0.1.1 in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (0.1.3)\n",
      "Requirement already satisfied: debugpy>=1.6.5 in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (1.6.7)\n",
      "Requirement already satisfied: jupyter-client>=6.1.12 in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (8.2.0)\n",
      "Requirement already satisfied: jupyter-core!=5.0.*,>=4.12 in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (5.3.1)\n",
      "Requirement already satisfied: matplotlib-inline>=0.1 in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (0.1.6)\n",
      "Requirement already satisfied: nest-asyncio in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (1.5.6)\n",
      "Requirement already satisfied: packaging in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (23.1)\n",
      "Requirement already satisfied: pyzmq>=20 in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (25.1.0)\n",
      "Requirement already satisfied: tornado>=6.1 in /home/mirza/.local/lib/python3.10/site-packages (from ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (6.3.2)\n",
      "Requirement already satisfied: backcall in /home/mirza/.local/lib/python3.10/site-packages (from ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (0.2.0)\n",
      "Requirement already satisfied: decorator in /home/mirza/.local/lib/python3.10/site-packages (from ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (5.1.1)\n",
      "Requirement already satisfied: jedi>=0.16 in /home/mirza/.local/lib/python3.10/site-packages (from ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (0.18.2)\n",
      "Requirement already satisfied: pickleshare in /home/mirza/.local/lib/python3.10/site-packages (from ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (0.7.5)\n",
      "Requirement already satisfied: prompt-toolkit!=3.0.37,<3.1.0,>=3.0.30 in /home/mirza/.local/lib/python3.10/site-packages (from ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (3.0.38)\n",
      "Requirement already satisfied: stack-data in /home/mirza/.local/lib/python3.10/site-packages (from ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (0.6.2)\n",
      "Requirement already satisfied: pexpect>4.3 in /home/mirza/.local/lib/python3.10/site-packages (from ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (4.8.0)\n",
      "Requirement already satisfied: pytz>=2020.1 in /usr/lib/python3/dist-packages (from pandas>=0.25->seaborn>=0.9.0->qiskit[visualization]) (2022.1)\n",
      "Requirement already satisfied: tzdata>=2022.1 in /home/mirza/.local/lib/python3.10/site-packages (from pandas>=0.25->seaborn>=0.9.0->qiskit[visualization]) (2023.3)\n",
      "Requirement already satisfied: six>=1.5 in /home/mirza/.local/lib/python3.10/site-packages (from python-dateutil>=2.8.0->qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (1.16.0)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Requirement already satisfied: charset-normalizer<4,>=2 in /home/mirza/.local/lib/python3.10/site-packages (from requests>=2.19->qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (3.1.0)\n",
      "Requirement already satisfied: idna<4,>=2.5 in /home/mirza/.local/lib/python3.10/site-packages (from requests>=2.19->qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (3.4)\n",
      "Requirement already satisfied: certifi>=2017.4.17 in /usr/lib/python3/dist-packages (from requests>=2.19->qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (2020.6.20)\n",
      "Requirement already satisfied: ntlm-auth>=1.0.2 in /home/mirza/.local/lib/python3.10/site-packages (from requests-ntlm<=1.1.0->qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (1.5.0)\n",
      "Requirement already satisfied: cryptography>=1.3 in /usr/lib/python3/dist-packages (from requests-ntlm<=1.1.0->qiskit-ibmq-provider==0.20.2->qiskit[visualization]) (3.4.8)\n",
      "Requirement already satisfied: pbr!=2.1.0,>=2.0.0 in /home/mirza/.local/lib/python3.10/site-packages (from stevedore>=3.0.0->qiskit-terra==0.24.1->qiskit[visualization]) (5.11.1)\n",
      "Requirement already satisfied: parso<0.9.0,>=0.8.0 in /home/mirza/.local/lib/python3.10/site-packages (from jedi>=0.16->ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (0.8.3)\n",
      "Requirement already satisfied: platformdirs>=2.5 in /home/mirza/.local/lib/python3.10/site-packages (from jupyter-core!=5.0.*,>=4.12->ipykernel>=4.5.1->ipywidgets>=7.3.0->qiskit[visualization]) (3.5.3)\n",
      "Requirement already satisfied: ptyprocess>=0.5 in /home/mirza/.local/lib/python3.10/site-packages (from pexpect>4.3->ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (0.7.0)\n",
      "Requirement already satisfied: wcwidth in /home/mirza/.local/lib/python3.10/site-packages (from prompt-toolkit!=3.0.37,<3.1.0,>=3.0.30->ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (0.2.6)\n",
      "Requirement already satisfied: executing>=1.2.0 in /home/mirza/.local/lib/python3.10/site-packages (from stack-data->ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (1.2.0)\n",
      "Requirement already satisfied: asttokens>=2.1.0 in /home/mirza/.local/lib/python3.10/site-packages (from stack-data->ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (2.2.1)\n",
      "Requirement already satisfied: pure-eval in /home/mirza/.local/lib/python3.10/site-packages (from stack-data->ipython>=6.1.0->ipywidgets>=7.3.0->qiskit[visualization]) (0.2.2)\n",
      "Building wheels for collected packages: qiskit\n",
      "  Building wheel for qiskit (pyproject.toml) ... \u001b[?25ldone\n",
      "\u001b[?25h  Created wheel for qiskit: filename=qiskit-0.43.2-py3-none-any.whl size=7640 sha256=a75377c96cd02eb8556566b2b8b4964b816c28470c19fd562ad49657257e2291\n",
      "  Stored in directory: /home/mirza/.cache/pip/wheels/d4/ad/4f/f54eb8743e54c5bab69837b842cf56a8a87ac7c57a2abf85ad\n",
      "Successfully built qiskit\n",
      "Installing collected packages: qiskit-aer, qiskit\n",
      "  Attempting uninstall: qiskit-aer\n",
      "    Found existing installation: qiskit-aer 0.12.0\n",
      "    Uninstalling qiskit-aer-0.12.0:\n",
      "      Successfully uninstalled qiskit-aer-0.12.0\n",
      "  Attempting uninstall: qiskit\n",
      "    Found existing installation: qiskit 0.43.1\n",
      "    Uninstalling qiskit-0.43.1:\n",
      "      Successfully uninstalled qiskit-0.43.1\n",
      "Successfully installed qiskit-0.43.2 qiskit-aer-0.12.1\n"
     ]
    }
   ],
   "source": [
    "!pip install \"qiskit[visualization]\" --user --upgrade"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e5a26fcc",
   "metadata": {},
   "source": [
    "<hr id=\"tips\">\n",
    "\n",
    "### Tips\n",
    "\n",
    "_Any terminal/shell command can be executed in the notebook cells by putting an exclamation mark (!) at the beginning of the command._\n",
    "\n",
    "_$\\rightarrow$ To update Qiskit to the latest version, execute the following command in a code cell_\n",
    "\n",
    "    !pip install -U qiskit --user\n",
    "    \n",
    "_$\\rightarrow$ To uninstall Qiskit, execute the following command in a code cell_\n",
    "\n",
    "    !pip uninstall qiskit"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e12f635a",
   "metadata": {},
   "source": [
    "## Executing an Example"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "194eb5a9",
   "metadata": {},
   "source": [
    "At this point, you do not need to scratch your head over what's going on in the following code. It is just testing whether qiskit is perfectly installed on not. \n",
    "### 1) Creating a Quantum Circuit\n",
    "\n",
    "If you see *\"The execution of the cell was completed, and the circuit was created :)\"* after execution of the following code then proceed forward. If not then there is something wrong with either qiskit installation or the following code has been damadged. In principle, if you followed the above stpes, the following code should work."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "db92d361",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The execution of the cell was completed, and the circuit was created :)\n"
     ]
    }
   ],
   "source": [
    "# import the objects from qiskit\n",
    "from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit, execute, Aer\n",
    "from random import randrange\n",
    "\n",
    "# create a quantum circuit and its register objects\n",
    "qreg = QuantumRegister(2) # quantum register with two quantum bits\n",
    "creg = ClassicalRegister(2) # classical register with two classical bit\n",
    "circuit = QuantumCircuit(qreg,creg) # quantum circuit composed by a quantum register and a classical register\n",
    "\n",
    "# apply a Hadamard gate to the first qubit\n",
    "circuit.h(qreg[0])\n",
    "\n",
    "# set the second qubit to state |1>\n",
    "circuit.x(qreg[1])\n",
    "\n",
    "# apply CNOT(first_qubit,second_qubit)\n",
    "circuit.cx(qreg[0],qreg[1])\n",
    "\n",
    "# measure the both qubits\n",
    "circuit.measure(qreg,creg)\n",
    "\n",
    "print(\"The execution of the cell was completed, and the circuit was created :)\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "7b0e2427",
   "metadata": {},
   "source": [
    "### 2) Drawing the Circuit\n",
    "Run the cell once more if you do not see the following figure after execution. <img src=\"files/Graphics/InstallationExample.png\" width=\"300\" height=\"500\">"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "6cb87e19",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 472.545x284.278 with 1 Axes>"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# draw circuit \n",
    "circuit.draw(output='mpl')\n",
    "\n",
    "# the output will be a \"matplotlib.Figure\" object"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "1794066e",
   "metadata": {},
   "source": [
    "### 3) Executing Circuit in Local Simulator\n",
    "Execute the circuit 1024 times in the local simulator and print the observed the outcomes\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "ee18cb0c",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'10': 510, '01': 514}\n"
     ]
    }
   ],
   "source": [
    "## execute the circuit 1024 times\n",
    "job = execute(circuit,Aer.get_backend('qasm_simulator'),shots=1024)\n",
    "# get the result\n",
    "counts = job.result().get_counts(circuit)\n",
    "print(counts)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "id": "3cdfcfb0",
   "metadata": {},
   "outputs": [
    {
     "ename": "TypeError",
     "evalue": "bad input to run() function;`validation` argument is only effective for input qobj",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mTypeError\u001b[0m                                 Traceback (most recent call last)",
      "Cell \u001b[0;32mIn[30], line 13\u001b[0m\n\u001b[1;32m     10\u001b[0m qc\u001b[38;5;241m.\u001b[39mu(\u001b[38;5;241m2\u001b[39m\u001b[38;5;241m*\u001b[39mpi\u001b[38;5;241m/\u001b[39m\u001b[38;5;241m3\u001b[39m,\u001b[38;5;241m0\u001b[39m,\u001b[38;5;241m0\u001b[39m,q)\n\u001b[1;32m     12\u001b[0m backend \u001b[38;5;241m=\u001b[39m Aer\u001b[38;5;241m.\u001b[39mget_backend(\u001b[38;5;124m'\u001b[39m\u001b[38;5;124mstatevector_simulator\u001b[39m\u001b[38;5;124m'\u001b[39m) \u001b[38;5;66;03m# the device to run on\u001b[39;00m\n\u001b[0;32m---> 13\u001b[0m result \u001b[38;5;241m=\u001b[39m \u001b[43mbackend\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mrun\u001b[49m\u001b[43m(\u001b[49m\u001b[43mqc\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mbackend\u001b[49m\u001b[43m)\u001b[49m\u001b[38;5;241m.\u001b[39mresult()\n\u001b[1;32m     14\u001b[0m psi  \u001b[38;5;241m=\u001b[39m result\u001b[38;5;241m.\u001b[39mget_statevector(qc)\n",
      "File \u001b[0;32m~/.local/lib/python3.10/site-packages/qiskit_aer/backends/aerbackend.py:206\u001b[0m, in \u001b[0;36mrun\u001b[0;34m(self, circuits, validate, parameter_binds, **run_options)\u001b[0m\n\u001b[1;32m    204\u001b[0m \u001b[38;5;28;01mfor\u001b[39;00m circ \u001b[38;5;129;01min\u001b[39;00m circuits:\n\u001b[1;32m    205\u001b[0m     only_circuits \u001b[38;5;241m&\u001b[39m\u001b[38;5;241m=\u001b[39m \u001b[38;5;28misinstance\u001b[39m(circ, QuantumCircuit)\n\u001b[0;32m--> 206\u001b[0m     only_pulse \u001b[38;5;241m&\u001b[39m\u001b[38;5;241m=\u001b[39m \u001b[38;5;28misinstance\u001b[39m(circ, (ScheduleBlock, Schedule))\n\u001b[1;32m    208\u001b[0m \u001b[38;5;28;01mif\u001b[39;00m only_circuits \u001b[38;5;129;01mand\u001b[39;00m \u001b[38;5;129;01mnot\u001b[39;00m only_pulse:\n\u001b[1;32m    209\u001b[0m     \u001b[38;5;28;01mif\u001b[39;00m validate:\n",
      "\u001b[0;31mTypeError\u001b[0m: bad input to run() function;`validation` argument is only effective for input qobj"
     ]
    }
   ],
   "source": [
    "from qiskit.visualization import plot_state_city, plot_bloch_multivector\n",
    "from qiskit.visualization import plot_state_paulivec, plot_state_hinton\n",
    "from qiskit.visualization import plot_state_qsphere\n",
    "from math import pi\n",
    "\n",
    "q =  QuantumRegister(1) # quantum register with a single qubit\n",
    "c = ClassicalRegister(1) # classical register with a single bit\n",
    "qc = QuantumCircuit(q,c) # quantum circuit with quantum and classical registers\n",
    "\n",
    "qc.u(2*pi/3,0,0,q)\n",
    "\n",
    "backend = Aer.get_backend('statevector_simulator') # the device to run on\n",
    "result = backend.run(qc, backend).result()\n",
    "psi  = result.get_statevector(qc)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "id": "9e2e621c",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<pre style=\"word-wrap: normal;white-space: pre;background: #fff0;line-height: 1.1;font-family: &quot;Courier New&quot;,Courier,monospace\">       ┌─────────────┐┌─┐\n",
       "  q17: ┤ U(2π/3,0,0) ├┤M├\n",
       "       └─────────────┘└╥┘\n",
       "c13: 1/════════════════╩═\n",
       "                       0 </pre>"
      ],
      "text/plain": [
       "       ┌─────────────┐┌─┐\n",
       "  q17: ┤ U(2π/3,0,0) ├┤M├\n",
       "       └─────────────┘└╥┘\n",
       "c13: 1/════════════════╩═\n",
       "                       0 "
      ]
     },
     "execution_count": 25,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "qc.draw()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "id": "e55b6f43",
   "metadata": {},
   "outputs": [
    {
     "ename": "NameError",
     "evalue": "name 'psi' is not defined",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mNameError\u001b[0m                                 Traceback (most recent call last)",
      "Cell \u001b[0;32mIn[26], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m plot_bloch_multivector(\u001b[43mpsi\u001b[49m)\n",
      "\u001b[0;31mNameError\u001b[0m: name 'psi' is not defined"
     ]
    }
   ],
   "source": [
    "plot_bloch_multivector()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "9cc76ac6",
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "176e66d1",
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.10.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}