CircuitInstruction

I nomi di questa classe possono creare confusione, Instructione Operatione l'attributo di questa classe operation. La terminologia che preferiamo è in analogia con i linguaggi assembly, dove una "istruzione" è costituita da una "operazione" e dai suoi "operandi".

Storicamente, Instruction era la prima a comparire e originariamente conteneva i qubit su cui agiva e tutti i parametri, quindi era una vera e propria “istruzione”. Con il passare del tempo, QuantumCircuit assunse il compito di tenere traccia dei qubit e dei clbit, e la classe venne definita più appropriatamente come “operazione”. Cambiare il nome di un oggetto fondamentale come questo comporterebbe una rottura dell'API molto sgradevole per gli utenti, e per questo abbiamo deciso di mantenerlo.

Questa classe è stata creata per fornire un oggetto contestuale formale di “istruzione” in QuantumCircuit.data, che per molto tempo era stato costituito da tuple ad hoc. Grazie a questo, e all’introduzione dell’interfaccia Operation che consente di aggiungere oggetti più complessi ai circuiti, abbiamo colto l’occasione per correggere la denominazione storica. Per il momento, ciò porta a una situazione un po’ complicata in cui CircuitInstruction.operation è spesso un’istanza Instruction di (cheInstruction implementa l’interfaccia Operation ), ma man mano che Operation l’interfaccia verrà utilizzata sempre più spesso, si spera che questa confusione si attenui.

Si tratta di una classe interna leggera e il controllo degli errori è minimo; è necessario rispettare i suggerimenti sul tipo quando la si usa. È responsabilità dell'utente assicurarsi che le mutazioni dirette dell'oggetto non invalidino i tipi e le restrizioni imposte dal contesto. In genere questo significa, ad esempio, che qubits deve essere una sequenza di elementi distinti, senza duplicati.