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 veio primeiro e originalmente continha os qubits em que operava e quaisquer parâmetros, portanto, era uma verdadeira "instrução". Com o passar do tempo, QuantumCircuit tornou-se responsável pelo rastreamento de qubits e clbits, e a classe passou a ser melhor descrita como uma "operação". Alterar o nome desse objeto central seria uma quebra de API muito desagradável para os usuários e, por isso, continuamos com ele.

Essa classe foi criada para fornecer um objeto de contexto de “instrução” formal no 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 anterior. Por enquanto, isso leva a uma situação um tanto confusa em que CircuitInstruction.operation é frequentemente uma Instruction instância de (Instruction implementa a Operation interface ), mas, à medida que a Operation interface ganhar 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.