WrapAngles

class qiskit.transpiler.passes.WrapAngles(*args, **kwargs)

Bases: TransformationPass

Envuelve ángulos fuera del límite especificado en el objetivo.

Esta pasada comprobará todas las puertas del circuito y verificará si hay alguna puerta fuera del límite especificado en el objetivo. Si se identifica alguna puerta fuera del límite, se llamará a la llamada de retorno en el objetivo para sustituir la puerta fuera del límite por un subcircuito equivalente. Este paso no se ejecuta en puertas parametrizadas, incluso si la puerta tiene parámetros no parametrizados fuera de un límite especificado. Si hay puertas parametrizadas en el circuito serán ignoradas por este paso ya que los ángulos ligados son necesarios para transformar la puerta. Por ejemplo el siguiente ejemplo demuestra como funciona el mecanismo de callback y registro, pero no muestra una transformación útil, pero es simple de seguir:

from qiskit.circuit import Gate, Parameter, Qubit, QuantumCircuit
from qiskit.circuit.library import RZGate
from qiskit.dagcircuit import DAGCircuit
from qiskit.transpiler.passes import WrapAngles
from qiskit.transpiler import Target, WrapAngleRegistry

param = Parameter("a")
circuit = QuantumCircuit(1)
circuit.rz(6.8, 0)
target = Target(num_qubits=1)
target.add_instruction(RZGate(param), angle_bounds=[(0, 0.5)])

def callback(angles, _qubits):
    angle = angles[0]
    if angle > 0:
        number_of_gates = angle / 0.5
    else:
        number_of_gates = (6.28 - angle) / 0.5
    dag = DAGCircuit()
    dag.add_qubits([Qubit()])
    for _ in range(int(number_of_gates)):
        dag.apply_operation_back(RZGate(0.5), [dag.qubits[0]])
    return dag

registry = WrapAngleRegistry()
registry.add_wrapper("rz", callback)
wrap_pass = WrapAngles(target, registry)
res = wrap_pass(circuit)
res.draw("mpl")

Esquema del circuito de la salida tras ejecutar la pasada « WrapAngles »

Parámetros

target (Target) – La dirección Target que representa la QPU de destino.
registry (WrapAngleRegistry) –

El registro de funciones de envoltura utilizadas por el paso para envolver los ángulos de una puerta. Si no se especifica, se utilizará el objeto DEFAULT_REGISTRY global.

A menos que planees ejecutar este paso de forma independiente o estés creando una personalización PassManager que incluya este paso, te recomendamos que utilices DEFAULT_REGISTRY.

Atributos

REGISTRO_POR_DEFAULT

Valor predeterminado: <qiskit._accelerate.angle_bound_registry.WrapAngleRegistry object>

Una instancia global de WrapAngleRegistry que se utiliza de forma predeterminada en esta pasada cuando no se especifica ningún registro explícito.

Nota

Esto también es accesible públicamente en la ubicación qiskit.transpiler.passes.utils.wrap_angles.WRAP_ANGLE_REGISTRY debido a un descuido en Qiskit 2.2 (en el que la ruta extendida es la única ubicación válida). Se recomienda encarecidamente acceder a este objeto a través de WrapAngles, sin embargo, si no necesita compatibilidad con Qiskit 2.2.

Nota

Los intentos de escribir un objeto de registro completamente nuevo en la qiskit.transpiler.passes.utils.wrap_angles ruta no se reflejarán en los valores predeterminados en Qiskit 2.3 en adelante. Aunque no recomendamos intentar sobrescribir el objeto por completo, si necesita hacerlo y es compatible con Qiskit 2.2 en adelante, debe escribir referencias al mismo objeto en ambos:

WrapAngles.DEFAULT_REGISTRY
qiskit.transpiler.passes.utils.wrap_angles.WRAP_ANGLE_REGISTRY

is_analysis_pass

Comprueba si el pase es un pase de análisis.

Si el pase es un AnalysisPass, significa que el pase puede analizar el DAG y escribir los resultados de ese análisis en el conjunto de propiedades. Este tipo de paso no permite realizar modificaciones en el DAG.

is_transformation_pass

Comprueba si el pase es un pase de transformación.

Si el pase es un TransformationPass, significa que el pase puede manipular el DAG, pero no puede modificar el conjunto de propiedades (pero se puede leer).

Métodos

execute

execute(passmanager_ir, state, callback=None)

GitHub

Ejecutar la tarea de optimización para la entrada Qiskit IR.

Parámetros

passmanager_ir (Any) – Qiskit IR para optimizar.
state (PassManagerState) – Estado asociado a la ejecución del flujo de trabajo por el propio gestor de pases.
callback (Callable | None) – Una función de devolución de llamada que se invoca cada vez que se ejecuta una tarea de optimización.