Skip to main content
IBM Quantum Platform

IfElseOp

class qiskit.circuit.IfElseOp(condition, true_body, false_body=None, label=None)

GitHub

Basi: ControlFlowOp

Un'operazione di circuito che esegue un programma (true_body) se una condizione fornita (condition) è vera e, facoltativamente, valuta un altro programma (false_body) altrimenti.

Se fornito, false_body deve essere dello stesso num_qubits e num_clbits di true_body.

I bit classici utilizzati in condition devono essere un sottoinsieme di quelli collegati al circuito a cui verrà aggiunto questo IfElseOp .

Parametri

  • condition (tuple[ClassicalRegister, int] | tuple[Clbit, int] | expr.Expr) – Una condizione da valutare in tempo reale durante l'esecuzione del circuito che, se vera, determinerà la valutazione di true_body. Può essere specificato come una tupla di un ClassicalRegister da verificare se è uguale a un dato int, oppure come una tupla di un Clbit da confrontare con un bool o con un int.
  • true_body (QuantumCircuit) – Un programma da eseguire se condition il risultato è vero.
  • false_body (QuantumCircuit | None) – Un programma opzionale da eseguire se condition il risultato è falso.
  • label (str | None) – Un'etichetta opzionale per identificare l'istruzione.

Attributi

base_class

Ottiene la classe base di questa istruzione. È garantita la presenza nell'albero ereditario di self.

La "classe base" di un'istruzione è la classe più bassa dell'albero di ereditarietà con cui l'oggetto deve essere considerato completamente compatibile per le applicazioni dei circuiti. Questo in genere significa che la sottoclasse è definita solo per offrire una sorta di comodità al programmatore rispetto alla classe base, mentre la classe base è la "vera" classe dal punto di vista comportamentale. In particolare, non si dovrebbe sovrascrivere base_class se si sta definendo una versione personalizzata di un'istruzione che sarà implementata in modo diverso dall'hardware, come ad esempio una strategia di misura alternativa, o una versione di un gate parametrizzato con un particolare insieme di parametri per distinguerlo in un file Target dalla porta parametrizzata completa.

Spesso è esattamente equivalente a type(obj), tranne nel caso di istanze singleton di istruzioni della libreria standard. Queste istanze singleton sono sottoclassi speciali della loro classe base e questa proprietà restituirà la classe base. Ad esempio:

>>> isinstance(XGate(), XGate)
True
>>> type(XGate()) is XGate
False
>>> XGate().base_class is XGate
True

In generale, non si dovrebbe fare affidamento sulla classe precisa di un'istruzione; all'interno di un determinato circuito, si prevede che Instruction.name dovrebbe essere un discriminante più adatto nella maggior parte delle situazioni.

blocks

condition

La condizione per l'operazione if else.

decompositions

Ottenere le scomposizioni dell'istruzione da SessionEquivalenceLibrary.

definition

Definizione di ritorno in termini di altri cancelli di base.

label

Etichetta di istruzioni per la restituzione

mutable

Questa istanza è un'istanza unica mutabile o meno.

Se questo attributo è False , l'istanza del gate è un singleton condiviso e non è mutabile.

name

Restituisce il nome.

num_clbits

Restituisce il numero di clbit.

num_qubits

Restituisce il numero di qubit.

params


Metodi

add_decomposition

add_decomposition(decomposition)

GitHub

Aggiungere una decomposizione dell'istruzione a SessionEquivalenceLibrary.

broadcast_arguments

broadcast_arguments(qargs, cargs)

GitHub

Convalida degli argomenti.

Parametri

  • qargs (List) – Elenco degli argomenti dei bit quantici.
  • cargs (List) – Elenco degli argomenti classici dei bit.

Attese

Tuple(List, List) - Una tupla con singoli argomenti.

Aumenti

CircuitError – Se l'input non è valido. Ad esempio, il numero di argomenti non corrisponde a quanto previsto dal gate.

copy

copy(name=None)

GitHub

Copia dell'istruzione.

Parametri

name (str) – nome da assegnare al circuito copiato, se None il nome rimane invariato.

Risultati

una copia dell'istruzione corrente, con il nome aggiornato se è stato fornito

Tipo di restituzione

qiskit.circuit.Instruction

inverse

inverse(annotated=False)

GitHub

Invertire questa istruzione.

Se annotated è False, l'istruzione inversa viene implementata come una nuova istruzione con la definizione ricorsivamente invertita.

Se annotated è True, l'istruzione inversa è implementata come AnnotatedOperatione corrisponde all'istruzione data annotata con il "modificatore inverso".

Le istruzioni speciali che ereditano da Instruction possono implementare il proprio inverso (ad esempio T e Tdg, Barrier, ecc.) In particolare, possono scegliere come gestire l'argomento annotated , tra cui ignorarlo e restituire sempre una classe gate concreta se l'inverso è definito come gate standard.

Parametri

annotated (bool) – se impostato su True, l'uscita del gate inverso sarà restituita come AnnotatedOperation.

Risultati

L'operazione inversa.

Aumenti

CircuitError – se l'istruzione non è composta e non è stata implementata la sua inversa.

is_parameterized

is_parameterized()

GitHub

Restituisce se il Instruction contiene parametri di compilazione.

iter_captured_stretches

iter_captured_stretches()

GitHub

Ottiene un iteratore sulle variabili di tratto uniche catturate in tutti i blocchi di questo costrutto.

Tipo di restituzione

Iterable [ expr.Stretch ]

iter_captured_vars

iter_captured_vars()

GitHub

Ottiene un iteratore sulle variabili uniche catturate in tutti i blocchi di questo costrutto.

Tipo di restituzione

Iterable [ expr.Var ]

repeat

repeat(n)

GitHub

Crea un'istruzione con self la ripetizione di « nn » volte.

Parametri

n (int) – Numero di volte in cui ripetere l'istruzione

Risultati

Contiene la definizione.

Tipo di restituzione

qiskit.circuit.Instruction

Aumenti

CircuitError – Se n < 1.

replace_blocks

replace_blocks(blocks)

GitHub

Sostituire i blocchi e restituire una nuova istruzione.

Parametri

blocks (Iterable[QuantumCircuit]) – Sequenza di circuiti per le condizioni “if” e “else”. Se non è presente un circuito “else”, può essere impostato su None oppure omesso.

Risultati

Nuovo IfElseOp con blocchi sostituiti.

Tipo di restituzione

IfElseOp

reverse_ops

reverse_ops()

GitHub

Per un'istruzione composta, invertire l'ordine delle sottoistruzioni.

Ciò avviene invertendo ricorsivamente tutte le sottoistruzioni. Non inverte alcun cancello.

Risultati

una nuova istruzione con

le sottoistruzioni invertite.

Tipo di restituzione

qiskit.circuit.Instruction

soft_compare

soft_compare(other)

GitHub

Confronto soft tra i gate. I loro nomi, il numero di qubit e i numeri di bit classici devono corrispondere. Il numero di parametri deve corrispondere. Ogni parametro viene confrontato. Se uno è un ParameterExpression non viene preso in considerazione.

Parametri

other (instruction) – altre istruzioni.

Risultati

sono auto e altri uguali fino alle espressioni dei parametri.

Tipo di restituzione

bool

to_mutable

to_mutable()

GitHub

Restituisce una copia mutabile di questo gate.

Questo metodo restituisce una nuova copia mutabile di questa istanza di gate. Se si utilizza un'istanza singleton, questa sarà una nuova istanza unica che può essere mutata. Se l'istanza è già mutabile, sarà una copia profonda di quell'istanza.

validate_parameter

validate_parameter(parameter)

GitHub

Il parametro Istruzione non ha alcuna convalida o normalizzazione.

Questa pagina è stata utile?
Segnala un bug, un errore di battitura o richiedi contenuti su GitHub.