{
"cells": [
{
"cell_type": "markdown",
"id": "7ed4867f",
"metadata": {},
"source": [
"---\n",
"title: \"Corte de circuitos para reducir la profundidad\"\n",
"description: \"Cree un patrón Qiskit para cortar puertas en un circuito cuántico con el fin de reducir la profundidad del circuito.\"\n",
"---\n",
"\n",
"\n",
"\n",
"# Corte de circuitos para reducir la profundidad\n",
"\n",
"*Estimación de uso: Ocho minutos en un procesador Eagle (NOTA: Esto es sólo una estimación. Su tiempo de ejecución puede variar)*\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "387c5e80",
"metadata": {},
"source": [
"\n",
"\n",
"## En segundo plano\n",
"\n",
"Este tutorial muestra cómo construir un `Qiskit pattern` para cortar puertas en un circuito cuántico para reducir la profundidad del circuito. Para obtener una discusión más detallada sobre el corte de circuitos, visita la [documentación del complemento Qiskit de corte de circuitos](https://qiskit.github.io/qiskit-addon-cutting/).\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "a62460d9",
"metadata": {},
"source": [
"\n",
"\n",
"## Requisitos\n",
"\n",
"Antes de empezar este tutorial, asegúrate de tener instalado lo siguiente:\n",
"\n",
"* Qiskit SDK v2.0 o posterior, con soporte [de visualización](/docs/api/qiskit/visualization)\n",
"* Qiskit Runtime v0.22 o posterior (`pip install qiskit-ibm-runtime`)\n",
"* Complemento Qiskit para corte de circuitos v0.9.0 o posterior (`pip install qiskit-addon-cutting`)\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "a89fe306",
"metadata": {},
"source": [
"\n",
"\n",
"## Configuración\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "c795c670",
"metadata": {},
"outputs": [],
"source": [
"import numpy as np\n",
"\n",
"from qiskit.circuit.library import EfficientSU2\n",
"from qiskit.quantum_info import PauliList, Statevector, SparsePauliOp\n",
"from qiskit.transpiler.preset_passmanagers import generate_preset_pass_manager\n",
"\n",
"from qiskit_addon_cutting import (\n",
" cut_gates,\n",
" generate_cutting_experiments,\n",
" reconstruct_expectation_values,\n",
")\n",
"\n",
"from qiskit_ibm_runtime import QiskitRuntimeService, SamplerV2"
]
},
{
"cell_type": "markdown",
"id": "07f7f75d",
"metadata": {},
"source": [
"\n",
"\n",
"## Paso 1: Asignar entradas clásicas a un problema cuántico\n",
"\n",
"Implementaremos nuestro patrón Qiskit siguiendo los cuatro pasos descritos en la [documentación](/docs/guides/intro-to-patterns). En este caso, simularemos valores de expectativa en un circuito de cierta profundidad cortando puertas que den lugar a puertas de intercambio y ejecutando subexperimentos en circuitos menos profundos. El corte de puertas es relevante para los pasos 2 (optimizar el circuito para la ejecución cuántica descomponiendo las puertas distantes) y 4 (post-procesamiento para reconstruir los valores de expectativa en el circuito original).\n",
"En el primer paso, generaremos un circuito a partir de la librería de circuitos Qiskit y definiremos algunos observables.\n",
"\n",
"* Entrada: Parámetros clásicos para definir un circuito\n",
"* Salida: Circuito abstracto y observables\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "54ed0f13",
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
""
]
},
"execution_count": 2,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"circuit = EfficientSU2(num_qubits=4, entanglement=\"circular\").decompose()\n",
"circuit.assign_parameters([0.4] * len(circuit.parameters), inplace=True)\n",
"observables = PauliList([\"ZZII\", \"IZZI\", \"IIZZ\", \"XIXI\", \"ZIZZ\", \"IXIX\"])\n",
"circuit.draw(\"mpl\", scale=0.8, style=\"iqp\")"
]
},
{
"cell_type": "markdown",
"id": "080a2a8b",
"metadata": {},
"source": [
"\n",
"\n",
"## Paso 2: Optimizar el problema para la ejecución en hardware cuántico\n",
"\n",
"* Entrada: Circuito abstracto y observables\n",
"* Resultado: Circuito objetivo y observables producidos cortando puertas distantes para reducir la profundidad del circuito transpilado\n",
"\n",
"Elegimos una disposición inicial que requiere dos intercambios para ejecutar las puertas entre los qubits 3 y 0 y otros dos intercambios para devolver los qubits a sus posiciones iniciales. Elegimos `optimization_level=3`, que es el nivel más alto de optimización disponible con un gestor de pases preestablecido.\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "b394da7a",
"metadata": {},
"outputs": [],
"source": [
"service = QiskitRuntimeService()\n",
"backend = service.least_busy(\n",
" operational=True, min_num_qubits=circuit.num_qubits, simulator=False\n",
")\n",
"\n",
"pm = generate_preset_pass_manager(\n",
" optimization_level=3, initial_layout=[0, 1, 2, 3], backend=backend\n",
")\n",
"transpiled_qc = pm.run(circuit)"
]
},
{
"cell_type": "markdown",
"id": "68c00476",
"metadata": {},
"source": [
"\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 4,
"id": "4fe4af43",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Transpiled circuit depth: 103\n"
]
},
{
"data": {
"text/plain": [
""
]
},
"execution_count": 4,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"print(f\"Transpiled circuit depth: {transpiled_qc.depth()}\")\n",
"transpiled_qc.draw(\"mpl\", scale=0.4, idle_wires=False, style=\"iqp\", fold=-1)"
]
},
{
"cell_type": "markdown",
"id": "babfbd0f",
"metadata": {},
"source": [
"*Buscar y cortar las puertas distantes:* Reemplazaremos las puertas distantes (puertas que conectan qubits no locales, 0 y 3) con `TwoQubitQPDGate` objetos especificando sus índices. `cut_gates` Reemplazará las puertas en los índices especificados con `TwoQubitQPDGate` objetos y también devolverá una lista de `QPDBasis` instancias, una por cada descomposición de puerta. El `QPDBasis` objeto contiene información sobre cómo descomponer las puertas cortadas en operaciones de un solo qubit.\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 5,
"id": "23e3d25e",
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
""
]
},
"execution_count": 5,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# Find the indices of the distant gates\n",
"cut_indices = [\n",
" i\n",
" for i, instruction in enumerate(circuit.data)\n",
" if {circuit.find_bit(q)[0] for q in instruction.qubits} == {0, 3}\n",
"]\n",
"\n",
"# Decompose distant CNOTs into TwoQubitQPDGate instances\n",
"qpd_circuit, bases = cut_gates(circuit, cut_indices)\n",
"\n",
"qpd_circuit.draw(\"mpl\", scale=0.8)"
]
},
{
"cell_type": "markdown",
"id": "069eb942-e947-4eff-a250-9a99c5ec47f0",
"metadata": {},
"source": [
"*Generar los subexperimentos que se ejecutarán en el backend* : `generate_cutting_experiments` acepta un circuito que contiene instancias y observables de `TwoQubitQPDGate` como `PauliList`.\n",
"\n",
"Para simular el valor esperado del circuito de tamaño completo, se generan muchos subexperimentos a partir de la distribución de cuasiprobabilidad conjunta de las puertas descompuestas y, a continuación, se ejecutan en uno o más backends. El número de muestras tomadas de la distribución se controla mediante `num_samples`, y se da un coeficiente combinado para cada muestra única. Para más información sobre cómo se calculan los coeficientes, consulte el [material explicativo](https://qiskit.github.io/qiskit-addon-cutting/explanation/index.html).\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 6,
"id": "83b1efed-bafa-48c4-bbf0-cf7eb9027ac5",
"metadata": {},
"outputs": [],
"source": [
"# Generate the subexperiments and sampling coefficients\n",
"subexperiments, coefficients = generate_cutting_experiments(\n",
" circuits=qpd_circuit, observables=observables, num_samples=np.inf\n",
")"
]
},
{
"cell_type": "markdown",
"id": "6929264d",
"metadata": {},
"source": [
"*Para comparar, vemos que los subexperimentos QPD serán menos profundos después de cortar puertas distantes* : He aquí un ejemplo de subexperimento elegido arbitrariamente y generado a partir del circuito QPD. Su profundidad se ha reducido a más de la mitad. Hay que generar y evaluar muchos de estos subexperimentos probabilísticos para reconstruir un valor de expectativa del circuito más profundo.\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 7,
"id": "70e2f1b6",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Original circuit depth after transpile: 103\n",
"QPD subexperiment depth after transpile: 46\n"
]
},
{
"data": {
"text/plain": [
""
]
},
"execution_count": 7,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# Transpile the decomposed circuit to the same layout\n",
"transpiled_qpd_circuit = pm.run(subexperiments[100])\n",
"\n",
"print(f\"Original circuit depth after transpile: {transpiled_qc.depth()}\")\n",
"print(\n",
" f\"QPD subexperiment depth after transpile: {transpiled_qpd_circuit.depth()}\"\n",
")\n",
"transpiled_qpd_circuit.draw(\n",
" \"mpl\", scale=0.6, style=\"iqp\", idle_wires=False, fold=-1\n",
")"
]
},
{
"cell_type": "markdown",
"id": "87368cb9",
"metadata": {},
"source": [
"Por *otro lado, el corte hace necesario un muestreo* adicional. Aquí cortamos tres puertas CNOT, lo que resulta en una sobrecarga de muestreo de $9^3$. Para más información sobre la sobrecarga de muestreo incurrida por el corte de circuitos, consulte [la documentación de Circuit Knitting Toolbox](https://qiskit-extensions.github.io/circuit-knitting-toolbox/circuit_cutting/explanation/index.html).\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 8,
"id": "2ab65bd4",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Sampling overhead: 729.0\n"
]
}
],
"source": [
"print(f\"Sampling overhead: {np.prod([basis.overhead for basis in bases])}\")"
]
},
{
"cell_type": "markdown",
"id": "fd9a126c",
"metadata": {},
"source": [
"\n",
"\n",
"## Paso 3: Ejecutar utilizando Qiskit primitives\n",
"\n",
"Ejecuta los circuitos de destino («subexperimentos») con la primitiva Sampler.\n",
"\n",
"* Entrada: Circuitos objetivo\n",
"* Resultados: Distribuciones de cuasiprobabilidad\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 9,
"id": "a437de20-2042-4e62-87a7-804058cff5db",
"metadata": {},
"outputs": [],
"source": [
"# Transpile the subexperiments to the backend's instruction set architecture (ISA)\n",
"isa_subexperiments = pm.run(subexperiments)\n",
"\n",
"# Set up the Qiskit Runtime Sampler primitive. For a fake backend, this will use a local simulator.\n",
"sampler = SamplerV2(backend)\n",
"\n",
"# Submit the subexperiments\n",
"job = sampler.run(isa_subexperiments)"
]
},
{
"cell_type": "code",
"execution_count": 11,
"id": "ca53d638",
"metadata": {},
"outputs": [],
"source": [
"# Retrieve the results\n",
"results = job.result()"
]
},
{
"cell_type": "code",
"execution_count": 10,
"id": "32d35001",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"czypg1r6rr3g008mgp6g\n"
]
}
],
"source": [
"print(job.job_id())"
]
},
{
"cell_type": "markdown",
"id": "f04d9134-651b-446e-93f4-aa0281786200",
"metadata": {},
"source": [
"\n",
"\n",
"## Paso 4: Procesamiento posterior y devolución del resultado en el formato clásico deseado\n",
"\n",
"Utiliza los resultados del subexperimento, las subobservables y los coeficientes de muestreo para reconstruir el valor esperado del circuito original.\n",
"\n",
"Entrada: Distribuciones de cuasiprobabilidad Salida: Valores de expectativa reconstruidos\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 12,
"id": "ace12f7f",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Final reconstructed expectation value\n",
"1.0751342773437473\n"
]
}
],
"source": [
"reconstructed_expvals = reconstruct_expectation_values(\n",
" results,\n",
" coefficients,\n",
" observables,\n",
")\n",
"# Reconstruct final expectation value\n",
"final_expval = np.dot(reconstructed_expvals, [1] * len(observables))\n",
"print(\"Final reconstructed expectation value\")\n",
"print(final_expval)"
]
},
{
"cell_type": "code",
"execution_count": 13,
"id": "e6237a6f",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Ideal expectation value\n",
"1.2283177520039992\n"
]
}
],
"source": [
"ideal_expvals = [\n",
" Statevector(circuit).expectation_value(SparsePauliOp(observable))\n",
" for observable in observables\n",
"]\n",
"print(\"Ideal expectation value\")\n",
"print(np.dot(ideal_expvals, [1] * len(observables)).real)"
]
},
{
"cell_type": "markdown",
"id": "e366d14e",
"metadata": {},
"source": [
"\n",
"\n",
"## Encuesta tutorial\n",
"\n",
"Responda a esta breve encuesta para darnos su opinión sobre este tutorial. Su opinión nos ayudará a mejorar nuestra oferta de contenidos y la experiencia de los usuarios.\n",
"\n",
"[Enlace a la encuesta](https://your.feedback.ibm.com/jfe/form/SV_2ftYFf9t72yFNIO)\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"
},
"hours": 1.5,
"qpuSeconds": 480
},
"nbformat": 4,
"nbformat_minor": 5
}