WrapAngles

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

Bases : TransformationPass

Enveloppe les angles en dehors de la limite spécifiée dans la cible.

Cette passe vérifie toutes les portes du circuit et vérifie s'il y a des portes en dehors de la limite spécifiée dans la cible. Si des portes en dehors de la limite sont identifiées, le rappel dans la cible sera appelé pour remplacer la porte en dehors de la limite par un sous-circuit équivalent. Cette passe ne s'exécute pas sur les portes paramétrées, même si la porte a des paramètres non paramétrés en dehors d'une limite spécifiée. Si le circuit comporte des portes paramétrées, celles-ci seront ignorées par cette passe car des angles liés sont nécessaires pour transformer la porte. Par exemple, l'exemple ci-dessous montre le fonctionnement du mécanisme de rappel et de l'enregistrement, mais ne montre pas de transformation utile, tout en étant simple à suivre :

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")

Schéma de circuit de la sortie obtenue après l'exécution de la passe « WrapAngles »

Paramètres

target (Target) – La Target représentant la QPU cible.
registry (WrapAngleRegistry) –

Le registre des fonctions d'enveloppement utilisées par le passage pour envelopper les angles d'une porte. Si rien n'est spécifié, l'objet DEFAULT_REGISTRY global sera utilisé.

À moins que vous ne prévoyiez d'exécuter ce passage de manière autonome ou que vous ne construisiez un personnalisé PassManager incluant ce passage, vous devrez vous fier à DEFAULT_REGISTRY.

Attributs

REGISTRE_PAR_DÉFAUT

Valeur par défaut : <qiskit._accelerate.angle_bound_registry.WrapAngleRegistry object>

Une instance globale de WrapAngleRegistry qui est utilisée par défaut par ce passage lorsqu'aucun registre explicite n'est spécifié.

Remarque

Ceci est également accessible au public à l'emplacement qiskit.transpiler.passes.utils.wrap_angles.WRAP_ANGLE_REGISTRY en raison d'une omission dans Qiskit 2.2 (dans lequel le chemin étendu est le seul emplacement valide). Il est fortement recommandé d'accéder à cet objet via WrapAngles, toutefois, si vous n'avez pas besoin de prendre en charge Qiskit 2.2.

Remarque

Les tentatives d'écriture d'un objet de registre entièrement nouveau dans le qiskit.transpiler.passes.utils.wrap_angles chemin ne seront pas reflétées dans les valeurs par défaut dans Qiskit 2.3 et versions ultérieures. Bien que nous ne recommandions pas de tenter de remplacer complètement l'objet, si vous devez le faire et que vous souhaitez prendre en charge Qiskit 2.2 et les versions ultérieures, vous devez écrire des références au même objet dans les deux cas :

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

is_analysis_pass

Vérifier si la passe est une passe d'analyse.

Si le passe est un AnalysisPass,, cela signifie qu'il peut analyser le DAG et écrire les résultats de cette analyse dans l'ensemble de propriétés. Les modifications sur le DAG ne sont pas autorisées par ce type de passe.

is_transformation_pass

Vérifier si le laissez-passer est un laissez-passer de transformation.

Si la passe est une TransformationPass,, cela signifie qu'elle peut manipuler le DAG, mais qu'elle ne peut pas modifier l'ensemble des propriétés (mais qu'elle peut les lire).

Méthodes

execute

execute(passmanager_ir, state, callback=None)

GitHub

Exécuter la tâche d'optimisation pour l'entrée Qiskit IR.

Paramètres

passmanager_ir (DAGCircuit) – IR Qiskit à optimiser.
state (DAGCircuit) – État lié à l'exécution du flux de travail par le gestionnaire de passes lui-même.
callback (Callable[[Task, DAGCircuit, PropertySet, float, int], None] | None) – Une fonction de rappel qui est appelée à chaque exécution d'une tâche d'optimisation.

Retours

Qiskit IR optimisé et état du flux de travail.

Type de retour

tuple [ DAGCircuit, PassManagerState ]

name

name()

GitHub

Nom du laissez-passer.

Type de retour

str

run

run(dag)

GitHub

Effectuer une passe sur le circuit DAG. C'est le développeur du laissez-passer qui s'en charge.

Paramètres

dag - le dag sur lequel la passe est exécutée.

Augmentations

NotImplementedError - lorsqu'il n'est pas mis en œuvre pour un passage.

update_status

update_status(state, run_state)

GitHub

Mettre à jour le statut du flux de travail.

Paramètres

state (PassManagerState) – Transmettre l'état du gestionnaire à mettre à jour.
run_state (RunState) – Statut d'achèvement de la tâche en cours.

Retours

Mise à jour de l'état du gestionnaire de passe.

Type de retour

PassManagerState

Cette page a-t-elle été utile ?

Signaler un bogue, une coquille ou proposer du contenu sur GitHub.