CircuitInstruction

Die Namen dieser Klasse sind möglicherweise etwas verwirrend, Instruction, und Operationund das Attribut dieser Klasse operation. Wir bevorzugen eine Terminologie in Analogie zu Assembler-Sprachen, wo eine "Anweisung" aus einer "Operation" und ihren "Operanden" besteht.

Historisch gesehen Instruction kam zuerst und enthielt ursprünglich die Qubits, auf die es einwirkte, sowie alle Parameter; es handelte sich also um eine echte „Anweisung“. Im QuantumCircuit Laufe der Zeit übernahm sie die Aufgabe, Qubits und Clbits zu verfolgen, und die Klasse ließ sich besser als „Operation“ beschreiben. Eine Namensänderung bei einem solchen Kernobjekt würde für die Nutzer einen sehr unangenehmen API-Bruch bedeuten, weshalb wir daran festgehalten haben.

QuantumCircuit.dataDiese Klasse wurde geschaffen, um in ein formales Kontext-Objekt vom Typ „instruction“ bereitzustellen, das lange Zeit aus Ad-hoc-Tupeln bestand. Vor diesem Hintergrund und mit der Einführung der Operation Schnittstelle zum Hinzufügen komplexerer Objekte zu Schaltkreisen haben wir die Gelegenheit genutzt, die bisherige Namensgebung zu korrigieren. Dies führt vorerst zu einer etwas heiklen Situation, in CircuitInstruction.operation der oft eine Instruction Instanz ist (Instruction implementiert die Operation Schnittstelle), doch da die Operation Schnittstelle zunehmend Verbreitung findet, wird sich diese Verwirrung hoffentlich legen.

Dies ist eine leichtgewichtige interne Klasse und es gibt nur eine minimale Fehlerprüfung; Sie müssen die Typ-Hinweise beachten, wenn Sie sie verwenden. Es liegt in der Verantwortung des Benutzers, dafür zu sorgen, dass direkte Mutationen des Objekts weder die Typen noch die durch den Kontext auferlegten Einschränkungen ungültig machen. Normalerweise bedeutet dies zum Beispiel, dass qubits eine Folge von eindeutigen Elementen ohne Duplikate sein muss.