Istruzione
class qiskit.circuit.Instruction(name, num_qubits, num_clbits, params, label=None)
Basi: Operation
Istruzione quantistica generica.
I parametri duration e unit sono deprecati da Qiskit 1.3, e saranno rimossi in 2.0 o in un secondo momento. La durata di un'istruzione è definita nell'oggetto Target di un backend.
Parametri
- name (str) – nome dell'istruzione
- num_qubits (int) – larghezza del qubit dell'istruzione
- num_clbits (int) – larghezza del clbit dell'istruzione
- params (list[int|float|complex|str|ndarray|list|ParameterExpression]) – elenco dei parametri
- label (str or None) – Un'etichetta opzionale per identificare l'istruzione.
Aumenti
- CircuitError – quando il registro non è nel formato corretto.
- TypeError - quando viene fornita l'etichetta opzionale, ma non è una stringa.
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
TrueIn 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.
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
I parametri di questo Instruction. Idealmente si tratta di angoli di passaggio.
Metodi
add_decomposition
add_decomposition(decomposition)
Aggiungere una decomposizione dell'istruzione a SessionEquivalenceLibrary.
broadcast_arguments
broadcast_arguments(qargs, cargs)
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)
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
inverse
inverse(annotated=False)
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
repeat
repeat(n)
Crea un'istruzione con self la ripetizione di « » volte.
Parametri
n (int) – Numero di volte in cui ripetere l'istruzione
Risultati
Contiene la definizione.
Tipo di restituzione
Aumenti
CircuitError – Se n < 1.
reverse_ops
reverse_ops()
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
soft_compare
soft_compare(other)
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
to_mutable
to_mutable()
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)
Il parametro Istruzione non ha alcuna convalida o normalizzazione.