IfElseOp
class qiskit.circuit.IfElseOp(condition, true_body, false_body=None, label=None)
Bases : ControlFlowOp
Opération de circuit qui exécute un programme (true_body) si une condition fournie (condition) est évaluée comme vraie, et évalue éventuellement un autre programme (false_body) dans le cas contraire.
S'il est fourni, false_body doit être du même num_qubits et num_clbits que true_body.
Les bits classiques utilisés dans condition doivent être un sous-ensemble de ceux attachés au circuit sur lequel IfElseOp sera annexé.
Paramètres
- condition (tuple[ClassicalRegister, int] | tuple[Clbit, int] | expr.Expr) – Condition devant être évaluée en temps réel pendant l'exécution du circuit et qui, si elle est vraie, déclenchera l'évaluation de
true_body.intPeut être spécifié soit sous la forme d'un tuple d'unClassicalRegisterà tester pour l'égalité avec un donné, soit sous la forme d'un tuple d'unClbità comparer soit à unbool, soit à unint. - true_body (QuantumCircuit) – Un programme à exécuter si
conditionl'expression est évaluée à vrai. - false_body (QuantumCircuit | None) – Programme facultatif à exécuter si
conditionla valeur de l'expression est fausse. - label (str | None) – Une étiquette facultative pour identifier l'instruction.
Attributs
base_class
Obtenir la classe de base de cette instruction. Il est assuré de figurer dans l'arbre généalogique de self.
La "classe de base" d'une instruction est la classe la plus basse de son arbre d'héritage avec laquelle l'objet doit être considéré comme entièrement compatible pour les applications de circuit. Cela signifie généralement que la sous-classe est définie uniquement pour offrir une certaine commodité au programmeur par rapport à la classe de base, et que la classe de base est la "vraie" classe d'un point de vue comportemental. En particulier, vous ne devez pas outrepasser base_class si vous définissez une version personnalisée d'une instruction qui sera implémentée différemment par le matériel, comme une stratégie de mesure alternative, ou une version d'une porte paramétrée avec un ensemble particulier de paramètres dans le but de la distinguer dans un Target à partir de la porte entièrement paramétrée.
Ceci est souvent exactement équivalent à type(obj), sauf dans le cas d'instances uniques d'instructions de la bibliothèque standard. Ces instances singleton sont des sous-classes spéciales de leur classe de base, et cette propriété renverra cette base. Par exemple :
>>> isinstance(XGate(), XGate)
True
>>> type(XGate()) is XGate
False
>>> XGate().base_class is XGate
TrueEn général, il ne faut pas se fier à la classe précise d'une instruction; dans un circuit donné, on s'attend à ce que l'instruction Instruction.name devrait être un discriminant plus approprié dans la plupart des situations.
blocks
condition
La condition de l'opération if else.
decompositions
Obtenir les décompositions de l'instruction à partir de SessionEquivalenceLibrary.
definition
Définition du retour en termes d'autres portes de base.
label
Étiquette d'instruction de retour
mutable
Cette instance est-elle une instance unique mutable ou non?
Si cet attribut est False , l'instance du portail est un singleton partagé et n'est pas mutable.
name
Renvoyer le nom.
num_clbits
Retourne le nombre de clbits.
num_qubits
Renvoie le nombre de qubits.
params
Méthodes
add_decomposition
add_decomposition(decomposition)
Ajouter une décomposition de l'instruction à l'adresse SessionEquivalenceLibrary.
broadcast_arguments
broadcast_arguments(qargs, cargs)
Validation des arguments.
Paramètres
- qargs (List) – Liste des arguments des bits quantiques.
- cargs (List) – Liste des arguments classiques en matière de bits.
Rendements
Tuple (List, List) - Un tuple avec des arguments simples.
Augmentations
CircuitError – Si la saisie n'est pas valide. Par exemple, le nombre d'arguments ne correspond pas à ce qu'on attend de la porte logique.
copy
copy(name=None)
Copie de l'instruction.
Paramètres
name (str) – nom à donner au circuit copié, si None le nom reste le même.
Retours
une copie de l'instruction en cours, avec le nom mis à jour s'il a été fourni
Type de retour
inverse
inverse(annotated=False)
Inverser cette instruction.
Si l'annotation est False, l'instruction inverse est implémentée comme une nouvelle instruction avec la définition inversée récursivement.
Si annoté est Vrai, l'instruction inverse est implémentée comme AnnotatedOperationet correspond à l'instruction donnée annotée avec le "modificateur inverse".
Les instructions spéciales héritant de l'instruction peuvent implémenter leur propre inverse (par exemple T et Tdg, Barrière, etc.) En particulier, ils peuvent choisir comment gérer l'argument annotated , ce qui peut inclure de l'ignorer et de toujours renvoyer une classe de porte concrète si l'inverse est défini comme une porte standard.
Paramètres
annotated (bool) – si la valeur est True, la sortie de la porte inverse sera renvoyée sous forme de AnnotatedOperation.
Retours
L'opération inverse.
Augmentations
CircuitError – si l'instruction n'est pas composite et qu'aucune inverse n'a été implémentée pour celle-ci.
is_parameterized
is_parameterized()
Indique si la fonction Instruction contient des paramètres définis à la compilation.
iter_captured_stretches
iter_captured_stretches()
Obtenir un itérateur sur les variables d'étirement capturées uniques dans tous les blocs de cette construction.
Type de retour
Iterable [ expr.Stretch ]
iter_captured_vars
iter_captured_vars()
Obtenir un itérateur sur les variables uniques capturées dans tous les blocs de cette construction.
Type de retour
repeat
repeat(n)
Crée une instruction self répétée fois.
Paramètres
n (int) – Nombre de répétitions de l'instruction
Retours
Contenant la définition.
Type de retour
Augmentations
CircuitError – Si n < 1.
replace_blocks
replace_blocks(blocks)
Remplacer les blocs et renvoyer la nouvelle instruction.
Paramètres
blocks (Iterable[QuantumCircuit]) – Séquence de circuits pour les conditions « if » et « else ». S'il n'y a pas de circuit « else », il peut être défini sur « None » ou omis.
Retours
Nouveau IfElseOp avec blocs remplacés.
Type de retour
reverse_ops
reverse_ops()
Pour une instruction composite, inverser l'ordre des sous-instructions.
Pour ce faire, toutes les sous-instructions sont inversées de manière récursive. Il n'inverse aucune porte.
Retours
une nouvelle instruction avec
les sous-instructions sont inversées.
Type de retour
soft_compare
soft_compare(other)
Comparaison en douceur entre les portes. Leurs noms, le nombre de qubits et les numéros de bits classiques doivent correspondre. Le nombre de paramètres doit correspondre. Chaque paramètre est comparé. Si l'on est sur ParameterExpression, cela n'est pas pris en compte.
Paramètres
other (instruction) – d'autres instructions.
Retours
sont égaux à soi et à l'autre jusqu'à l'expression des paramètres.
Type de retour
to_mutable
to_mutable()
Renvoie une copie mutable de cette porte.
Cette méthode renvoie une nouvelle copie mutable de cette instance de porte. Si une instance singleton est utilisée, il s'agit d'une nouvelle instance unique qui peut être modifiée. Si l'instance est déjà mutable, il s'agira d'une copie profonde de cette instance.
validate_parameter
validate_parameter(parameter)
Le paramètre d'instruction ne fait l'objet d'aucune validation ou normalisation.