CircuitInstruction

É possível que haja alguma confusão nos nomes dessa classe, Instruction, e Operatione o atributo desta classe operation. Nossa terminologia preferida é por analogia às linguagens de montagem, em que uma "instrução" é composta por uma "operação" e seus "operandos".

Historicamente, Instruction ela surgiu primeiro e, originalmente, continha os qubits sobre os quais atuava e quaisquer parâmetros; portanto, era uma verdadeira “instrução”. Com o passar do tempo, QuantumCircuit passou a ser responsável pelo rastreamento de qubits e clbits, e a classe passou a ser mais adequadamente descrita como uma “operação”. Mudar o nome de um objeto tão fundamental representaria uma quebra de API muito desagradável para os usuários; por isso, decidimos mantê-lo como está.

Essa classe foi criada para fornecer um objeto de contexto de “instrução” formal em QuantumCircuit.data, que há muito tempo era composto por tuplas criadas ad hoc. Com isso, e com o lançamento da Operation interface para adicionar objetos mais complexos aos circuitos, aproveitamos a oportunidade para corrigir a nomenclatura histórica. Por enquanto, isso leva a uma situação um tanto confusa em CircuitInstruction.operation que costuma ser uma Instruction instância de (Instruction implementa a Operation interface ), mas, à medida que a Operation interface for ganhando mais uso, espera-se que essa confusão diminua.

Essa é uma classe interna leve e a verificação de erros é mínima; você deve respeitar as dicas de tipo ao usá-la. É responsabilidade do usuário garantir que as mutações diretas do objeto não invalidem os tipos nem as restrições impostas a ele pelo seu contexto. Normalmente, isso significa, por exemplo, que qubits deve ser uma sequência de itens distintos, sem duplicatas.