{ "cells": [ { "cell_type": "markdown", "id": "0af88701-d9bc-47f2-8ceb-2ae51f567934", "metadata": {}, "source": [ "---\n", "title: \"Visualizar circuitos\"\n", "description: \"Cree visualizaciones de circuitos y represente gráficamente datos de trabajos utilizando el módulo de visualización Qiskit\"\n", "---\n", "\n", "{/* cspell:ignore qcircuit mactex, backgroundcolor, lightgreen */}\n", "\n" ] }, { "cell_type": "markdown", "id": "8d75dc24-b8d2-45f8-830b-48e45f794a31", "metadata": {}, "source": [ "\n", "\n", "# Visualizar circuitos\n", "\n" ] }, { "cell_type": "markdown", "id": "7ea76afb-aecf-4ea2-b173-5d5e7e7d68ec", "metadata": { "tags": [ "version-info" ] }, "source": [ "{/*\n", " DO NOT EDIT THIS CELL!!!\n", " This cell's content is generated automatically by a script. Anything you add\n", " here will be removed next time the notebook is run. To add new content, create\n", " a new cell before or after this one.\n", " */}\n", "\n", "\n", " \n", " El código de esta página se ha desarrollado teniendo en cuenta los siguientes requisitos.\n", " Recomendamos utilizar estas versiones o versiones más recientes.\n", "\n", " ```\n", " qiskit[all]~=2.5.0\n", " ```\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "bd5865b3-adfa-4c87-be55-51f693335184", "metadata": {}, "source": [ "A menudo es útil ver los circuitos que estás creando. Utilice las siguientes opciones para visualizar los circuitos Qiskit.\n", "\n" ] }, { "cell_type": "code", "execution_count": 1, "id": "488c8d7d-5615-40ec-bf84-f1fa94832fce", "metadata": {}, "outputs": [], "source": [ "from qiskit import QuantumCircuit" ] }, { "cell_type": "markdown", "id": "8bbddcca-300c-4f20-98dd-a0723cdef026", "metadata": {}, "source": [ "\n", "\n", "## Dibuja un circuito cuántico\n", "\n", "La clase `QuantumCircuit` permite dibujar circuitos a través del método `draw()` , o imprimiendo el objeto circuito. Por defecto, ambos renderizan una versión artística ASCII del circuito.\n", "\n", "Observe que `print` devuelve `None` pero tiene el efecto secundario de imprimir el diagrama, mientras que `QuantumCircuit.draw` devuelve el diagrama sin efectos secundarios. Dado que los cuadernos Jupyter muestran la salida de la última línea de cada celda, parecen tener el mismo efecto.\n", "\n" ] }, { "cell_type": "code", "execution_count": 2, "id": "547f07e8-7891-433c-ac53-3186196b3aa7", "metadata": {}, "outputs": [], "source": [ "# Build a quantum circuit\n", "circuit = QuantumCircuit(3, 3)\n", "circuit.x(1)\n", "circuit.h(range(3))\n", "circuit.cx(0, 1)\n", "circuit.measure(range(3), range(3));" ] }, { "cell_type": "code", "execution_count": 3, "id": "d69ae2df-c31c-414f-bba2-4c4a1012de41", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ " ┌───┐ ┌─┐ \n", "q_0: ┤ H ├───────■──┤M├───\n", " ├───┤┌───┐┌─┴─┐└╥┘┌─┐\n", "q_1: ┤ X ├┤ H ├┤ X ├─╫─┤M├\n", " ├───┤└┬─┬┘└───┘ ║ └╥┘\n", "q_2: ┤ H ├─┤M├───────╫──╫─\n", " └───┘ └╥┘ ║ ║ \n", "c: 3/═══════╩════════╩══╩═\n", " 2 0 1 \n" ] } ], "source": [ "print(circuit)" ] }, { "cell_type": "code", "execution_count": 4, "id": "04c91fd9-50a1-4ff3-84e4-0b51a6b1541a", "metadata": {}, "outputs": [ { "data": { "text/plain": [ " ┌───┐ ┌─┐ \n", "q_0: ┤ H ├───────■──┤M├───\n", " ├───┤┌───┐┌─┴─┐└╥┘┌─┐\n", "q_1: ┤ X ├┤ H ├┤ X ├─╫─┤M├\n", " ├───┤└┬─┬┘└───┘ ║ └╥┘\n", "q_2: ┤ H ├─┤M├───────╫──╫─\n", " └───┘ └╥┘ ║ ║ \n", "c: 3/═══════╩════════╩══╩═\n", " 2 0 1 " ] }, "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ "circuit.draw()" ] }, { "cell_type": "markdown", "id": "2159af06-93b8-441d-b8aa-c29324d26c6e", "metadata": {}, "source": [ "\n", "\n", "### Renderizadores alternativos\n", "\n", "Una salida de texto es útil para ver rápidamente la salida mientras se desarrolla un circuito, pero no proporciona la mayor flexibilidad. Existen dos renderizadores de salida alternativos para el circuito cuántico. Uno utiliza [Matplotlib](https://matplotlib.org/) y el otro utiliza [LaTeX](https://www.latex-project.org/). El renderizador LaTeX requiere el [paquete qcircuit](https://github.com/CQuIC/qcircuit). Seleccione estos renderizadores ajustando el argumento \"output\" a las cadenas `mpl` y `latex`.\n", "\n", "\n", " Los usuarios de OSX pueden obtener los paquetes LaTeX necesarios a través del [paquete mactex](https://www.tug.org/mactex/).\n", "\n", "\n" ] }, { "cell_type": "code", "execution_count": 5, "id": "3f9c61c9-58f9-4315-a639-455fa2e58450", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 5, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Matplotlib drawing\n", "circuit.draw(output=\"mpl\")" ] }, { "cell_type": "code", "execution_count": 6, "id": "94948dab-57de-45f0-8dd7-5901ae69b70a", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Latex drawing\n", "circuit.draw(output=\"latex\")" ] }, { "cell_type": "markdown", "id": "51fc6f51-6345-435d-abed-857f29a3f451", "metadata": {}, "source": [ "\n", "\n", "### Guardar salida\n", "\n", "Dibujar un circuito a gran escala en línea en un cuaderno Jupyter puede resultar lento o ilegible.\n", "Puedes guardar el diagrama directamente en un archivo y, a continuación, abrirlo en un visor de imágenes y ampliarlo según necesites.\n", "\n" ] }, { "cell_type": "code", "execution_count": 7, "id": "17889caf-d953-4661-9188-00505c17064e", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Save as an image using the Matplotlib drawer\n", "circuit.draw(output=\"mpl\", filename=\"circuit-mpl.jpeg\")" ] }, { "cell_type": "code", "execution_count": 8, "id": "a36d1aa9-fa0d-4e27-ac83-5deee43a20dd", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 8, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Or save a LaTeX rendering\n", "circuit.draw(output=\"latex\", filename=\"circuit-latex.pdf\")" ] }, { "cell_type": "markdown", "id": "78688e6c-3ed2-4ef2-b3db-80fdae35e585", "metadata": { "jp-MarkdownHeadingCollapsed": true }, "source": [ "\n", "\n", "### Esquemas de circuitos de control\n", "\n", "Por defecto, el método `draw()` devuelve la imagen renderizada como un objeto y no muestra nada. La clase exacta devuelta depende de la salida especificada: `'text'` (por defecto) devuelve un objeto `TextDrawer` , `'mpl'` devuelve un objeto `matplotlib.Figure` , y `latex` devuelve un objeto `PIL.Image` . Los cuadernos Jupyter entienden estos tipos de retorno y los muestran correctamente, pero cuando se ejecutan fuera de Jupyter, las imágenes no se mostrarán automáticamente.\n", "\n", "El método `draw()` tiene argumentos opcionales para mostrar o guardar la salida. Cuando se especifica, el kwarg `filename` toma una ruta en la que guarda la salida renderizada. Alternativamente, si está utilizando las salidas `mpl` o `latex` , puede utilizar el kwarg `interactive` para abrir la imagen en una nueva ventana (esto no siempre funcionará desde dentro de un cuaderno).\n", "\n" ] }, { "cell_type": "markdown", "id": "fc41270b-3518-40af-8921-dfa9666fc8e0", "metadata": {}, "source": [ "\n", "\n", "### Personalizar la salida\n", "\n", "Dependiendo de la salida, también hay opciones para personalizar el esquema del circuito.\n", "\n", "\n", "\n", "#### Desactivar barreras de trama e invertir el orden de bits\n", "\n", "Las dos primeras opciones se comparten entre los tres backends. Permiten configurar tanto los órdenes de bits como si se dibujan o no barreras. Se pueden configurar mediante `reverse_bits` kwarg y `plot_barriers` kwarg, respectivamente. Los siguientes ejemplos funcionan con cualquier renderizador de salida; `mpl` se utiliza aquí por brevedad.\n", "\n" ] }, { "cell_type": "code", "execution_count": 9, "id": "db61dc71-4cdc-4bb7-8139-8820e7785e55", "metadata": {}, "outputs": [], "source": [ "from qiskit import QuantumRegister, ClassicalRegister\n", "\n", "# Draw a new circuit with barriers and more registers\n", "q_a = QuantumRegister(3, name=\"a\")\n", "q_b = QuantumRegister(5, name=\"b\")\n", "c_a = ClassicalRegister(3)\n", "c_b = ClassicalRegister(5)\n", "\n", "circuit = QuantumCircuit(q_a, q_b, c_a, c_b)\n", "circuit.x(q_a[1])\n", "circuit.x(q_b[1])\n", "circuit.x(q_b[2])\n", "circuit.x(q_b[4])\n", "circuit.barrier()\n", "circuit.h(q_a)\n", "circuit.barrier(q_a)\n", "circuit.h(q_b)\n", "circuit.cswap(q_b[0], q_b[1], q_b[2])\n", "circuit.cswap(q_b[2], q_b[3], q_b[4])\n", "circuit.cswap(q_b[3], q_b[4], q_b[0])\n", "circuit.barrier(q_b)\n", "circuit.measure(q_a, c_a)\n", "circuit.measure(q_b, c_b);" ] }, { "cell_type": "code", "execution_count": 10, "id": "8e57cd43-8a48-469d-8f69-8e7c936d4a1e", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 10, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Draw the circuit\n", "circuit.draw(output=\"mpl\")" ] }, { "cell_type": "code", "execution_count": 11, "id": "8e7a251a-0a4f-43e0-8cf5-48493df7bad9", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Draw the circuit with reversed bit order\n", "circuit.draw(output=\"mpl\", reverse_bits=True)" ] }, { "cell_type": "code", "execution_count": 12, "id": "b4a601ad-1c04-4b16-afbd-ac5a0ad42653", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 12, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Draw the circuit without barriers\n", "circuit.draw(output=\"mpl\", plot_barriers=False)" ] }, { "cell_type": "markdown", "id": "18b0bfbe-b586-4182-9a0d-b858655a9240", "metadata": {}, "source": [ "\n", "\n", "### Personalizaciones específicas del renderizador\n", "\n", "Algunas opciones de personalización disponibles son específicas de un renderizador.\n", "\n", "El argumento `fold` establece una anchura máxima para la salida. En el renderizador `text` , esto establece la longitud de las líneas del diagrama antes de que se envuelva a la siguiente línea. Cuando se utiliza el renderizador 'mpl', este es el número de capas (visuales) antes de doblar a la siguiente línea.\n", "\n", "El renderizador `mpl` tiene el kwarg `style` , que cambia los colores y los contornos. Consulte la [documentación de la API](/docs/api/qiskit/qiskit.circuit.QuantumCircuit#draw) para obtener más detalles.\n", "\n", "La opción `scale` escala la salida de los renderizadores `mpl` y `latex` .\n", "\n" ] }, { "cell_type": "code", "execution_count": 13, "id": "1e08bf74-378f-45e6-b195-a9539061013d", "metadata": {}, "outputs": [ { "data": { "text/plain": [ " ┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐»\n", "q: ┤ H ├┤ H ├┤ H ├┤ H ├┤ H ├┤ H ├┤ H ├»\n", " └───┘└───┘└───┘└───┘└───┘└───┘└───┘»\n", "« ┌───┐┌───┐┌───┐\n", "«q: ┤ H ├┤ H ├┤ H ├\n", "« └───┘└───┘└───┘" ] }, "execution_count": 13, "metadata": {}, "output_type": "execute_result" } ], "source": [ "circuit = QuantumCircuit(1)\n", "for _ in range(10):\n", " circuit.h(0)\n", "# limit line length to 40 characters\n", "circuit.draw(output=\"text\", fold=40)" ] }, { "cell_type": "code", "execution_count": 14, "id": "decadf88-4866-45a0-9e2f-836c51491f9e", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 14, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Change the background color in mpl\n", "\n", "style = {\"backgroundcolor\": \"lightgreen\"}\n", "circuit.draw(output=\"mpl\", style=style)" ] }, { "cell_type": "code", "execution_count": 15, "id": "ade9a653-3243-4ac9-bb0e-c8fb82f7a034", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 15, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Scale the mpl output to 1/2 the normal size\n", "circuit.draw(output=\"mpl\", scale=0.5)" ] }, { "cell_type": "markdown", "id": "495b560a-d835-448b-aa01-5025a7a0689e", "metadata": {}, "source": [ "\n", "\n", "### Función independiente de dibujo de circuitos\n", "\n", "Si tiene una aplicación en la que prefiere dibujar un circuito con una función autónoma en lugar de como método de un objeto circuito, puede utilizar directamente la función `circuit_drawer()` , que forma parte de la interfaz pública estable de `qiskit.visualization`. La función se comporta de forma idéntica al método `circuit.draw()` , con la salvedad de que toma un objeto circuito como argumento obligatorio.\n", "\n" ] }, { "cell_type": "code", "execution_count": 16, "id": "256dd092-b2eb-47af-a025-0ecdf85c2d5a", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 16, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from qiskit.visualization import circuit_drawer\n", "\n", "circuit_drawer(circuit, output=\"mpl\", plot_barriers=False)" ] }, { "cell_type": "markdown", "id": "0761df2f-183f-48e3-9070-766a9920c2b9", "metadata": {}, "source": [ "\n", "\n", "## Próximos pasos\n", "\n", "\n", " * Vea un ejemplo de visualización de circuitos en el tutorial [del Algoritmo de Grover](/docs/tutorials/grovers-algorithm).\n", " * Visualiza circuitos sencillos utilizando [IBM Quantum Composer](/docs/guides/composer).\n", " * [Visualizar la sincronización del circuito](/docs/guides/visualize-circuit-timing).\n", " * Revisa la [documentación de la API de visualizaciones de Qiskit](/docs/api/qiskit/visualization).\n", "\n", "\n" ] }, { "cell_type": "markdown", "metadata": {}, "id": "a1b8767d", "source": "© IBM Corp., 2017-2026" } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3" } }, "nbformat": 4, "nbformat_minor": 4 }