z iQSrSSKJr SSKrSSKJr SSKrSSKJr SSK r SSK J r SSK J r SSKJr SS KJrJr S r"S S \5rg) a A generic quantum instruction. Instructions can be implementable on hardware (u, cx, etc.) or in simulation (snapshot, noise, etc.). Instructions can be unitary (a.k.a Gate) or non-unitary. Instructions are identified by the following: name: A string to identify the type of instruction. Used to request a specific instruction on the backend, or in visualizing circuits. num_qubits, num_clbits: dimensions of the instruction. params: List of parameters to specialize a specific instruction instance. Instructions do not have any context about where they are in a circuit (which qubits/clbits). The circuit itself keeps this context. ) annotationsN) zip_longest)Type) CircuitError)ParameterExpression) Operation)AnnotatedOperationInverseModifier绽|=c>\rSrSrSrSrSrS'Sjr\S(Sj5r \S)Sj5r Sr S r S*S jr S+S jrS r\S 5r\R"S5rSrSr\S5r\R"S5r\S5r\R"S5rSr\S*Sj5r\R"S,Sj5rSrS-S.SjjrS'SjrS'SjrSrSrSr\S5r\R"S 5r\S!5r \ R"S"5r \S#5r!\!R"S$5r!S%r"S&r#g)/ Instruction4zGeneric quantum instruction.FNcj[U[5(a[U[5(d [S5eUS:dUS:a[SUSUS35eXlX lX0l/Ul[US5(d)Ub [U[5(d [S5eXPl SUl X@l g) a .. deprecated:: 1.3 The parameters ``duration`` and ``unit`` are deprecated since Qiskit 1.3, and they will be removed in 2.0 or later. An instruction's duration is defined in a backend's Target object. Args: name (str): instruction name num_qubits (int): instruction's qubit width num_clbits (int): instruction's clbit width params (list[int|float|complex|str|ndarray|list|ParameterExpression]): list of parameters label (str or None): An optional label for identifying the instruction. Raises: CircuitError: when the register is not in the correct format. TypeError: when the optional label is provided, but it is not a string. z*num_qubits and num_clbits must be integer.rzbad instruction dimensions: z qubits, z clbits._labelNlabel expects a string or None) isinstanceintr_name _num_qubits _num_clbits_paramshasattrstr TypeErrorr _definitionparams)selfname num_qubits num_clbitsrlabels T/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/instruction.py__init__Instruction.__init__<s&*c***Z2M2MKL L >Z!^.zl)J>> isinstance(XGate(), XGate) True >>> type(XGate()) is XGate False >>> XGate().base_class is XGate True In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that :attr:`Instruction.name` should be a more suitable discriminator in most situations. )typers r" base_classInstruction.base_classhs<Dzr%cg)zIs this instance is a mutable unique instance or not. If this attribute is ``False`` the gate instance is a shared singleton and is not mutable. Tr(s r"mutableInstruction.mutablesr%c"UR5$)aReturn a mutable copy of this gate. This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance. )copyr(s r" to_mutableInstruction.to_mutablesyy{r%c[U[5(aURURLdhURUR:wdNURUR:wd4UR UR :wdUR UR :wag[URUR5Hup#[U[R5(a[R"X#5(aMAOX#:XaMI[R"U5n[R"U5n[R"U5[R"U5:Xa![R"X#[SS9(aM[R$"['U5['U5[SS9(aM g g![ ["4a NMf=f!["a  gf=f)zTwo instructions are the same if they have the same name, same dimensions, and same params. Args: other (instruction): other instruction Returns: bool: are self and other equal. Fr)atolrtolT)rr r)rrr definitionrrnumpyndarray array_equalasarrayshapeallclose_CUTOFF_PRECISION ValueErrorrisclosefloat)rother self_param other_param self_asarray other_asarrays r"__eq__Instruction.__eq__s{5+..e&6&66yyEJJ&%"2"22%"2"22%"2"22'24;; 'M #J*emm44$$Z==>, $}}Z8 % k : ;;|, M0JJu~~2C!P ==*%u['9@QXY5(N8 *    s%A9F8>2G8G  G  GGc pSURSURSURSURS3 $)zGenerates a representation of the Instruction object instance Returns: str: A representation of the Instruction instance with the name, number of qubits, classical bits and params( if any ) zInstruction(name='z', num_qubits=z , num_clbits=z , params=)rrr rr(s r"__repr__Instruction.__repr__sA! >$//9JK//*)DKK= C r%c&URUR:wd`URUR:wdFURUR:wd,[UR5[UR5:wag[ URUR5Hup#[ U[5(d[ U[5(aM1[ U[R5(ao[ U[R5(aP[R"U5[R"U5:Xa [R"X#[S9(aM g[R"X#[S9(aM g g![a  gf=f)af Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account. Args: other (instruction): other instruction. Returns: bool: are self and other equal up to parameter expressions. F)r4T)rrr lenrrrrr7r8r;r<r=r?r)rrArBrCs r" soft_compareInstruction.soft_compares/ II #%"2"22%"2"224;;3u||#44'24;; 'M #J*&9::j0??*emm44KQVQ^Q^9_9_;;z*ekk+.FF5>>2CL }}ZCTU V #(N& !sF FFcg)agPopulate the cached :attr:`_definition` field of this :class:`Instruction`. Subclasses should implement this method to provide lazy construction of their public :attr:`definition` attribute. A subclass can use its :attr:`params` at the time of the call. The method should populate :attr:`_definition` with a :class:`.QuantumCircuit` and not return a value.Nr,r(s r"_defineInstruction._defines r%cUR$)zPThe parameters of this :class:`Instruction`. Ideally these will be gate angles.)rr(s r"rInstruction.params s||r%c/UlUH_n[U[5(aURRU5 M5URRUR U55 Ma gN)rrrappendvalidate_parameter)r parameters single_params r"rrUsP &L,(;<< ##L1 ##D$;$;L$IJ 'r%cU$)z9Instruction parameter has no validation or normalization.r,)r parameters r"rYInstruction.validate_parametersr%c:[SUR55$)zrReturn whether the :class:`Instruction` contains :ref:`compile-time parameters `.c3h# UH(n[U[5=(a URv M* g7frW)rrrZ).0params r" /Instruction.is_parameterized.. s* UaEJu1 2 Gu7G7G GUas02)anyrr(s r"is_parameterizedInstruction.is_parameterizeds$ UYUaUa   r%cTURcUR5 UR$)z0Return definition in terms of other basic gates.)rrRr(s r"r6Instruction.definition$s%    # LLNr%cXlg)zSet gate representationN)r)rarrays r"r6ri+s !r%c0SSKJn URU5$)zMGet the decompositions of the instruction from the SessionEquivalenceLibrary.rSessionEquivalenceLibrary)"qiskit.circuit.equivalence_libraryrn get_entry)rsels r"decompositionsInstruction.decompositions0s X}}T""r%c2SSKJn URX5 g)zMSet the decompositions of the instruction from the SessionEquivalenceLibrary.rrmN)rorn set_entry)rrrrqs r"rrrs8s X d+r%c2SSKJn URX5 g)zHAdd a decomposition of the instruction to the SessionEquivalenceLibrary.rrmN)rornadd_equivalence)r decompositionrqs r"add_decompositionInstruction.add_decomposition@s X D0r%cUR$)zReturn instruction label)rr(s r"r!Instruction.labelGs{{r%cf[U[[S545(aXlg[ S5e)zSet instruction label to name Args: name (str or None): label to assign instruction Raises: TypeError: name is not string or None. Nr)rrr'rrrrs r"r!r|Ls+ dS$t*- . .K<= =r%cUR(aUR(dUR5$URURS-S9nURR 5n[ UR5HBnUR URR5URUR5 MD X!l U$)aFor a composite instruction, reverse the order of sub-instructions. This is done by recursively reversing all sub-instructions. It does not invert any gate. Returns: qiskit.circuit.Instruction: a new instruction with sub-instructions reversed. _reverse)r) rr-r0rcopy_empty_likereversedrX operation reverse_opsqubitsclbitsr6)r reverse_instreversed_definitioninsts r"rInstruction.reverse_ops[s t||99; yydii*&>@T--.D  & &t~~'A'A'CT[[RVR]R] ^/"5r%cU(a[U[55$URc[SURS35eSSKJn URRS5(aURSSnOURS-nUR(a9[UURURURR5S9nO)U"X0RURR5S 9nURR5nUR*Ul[!UR5HBnUR#UR$R'5UR(UR*5 MD XTlU$) aInvert this instruction. If `annotated` is `False`, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. If `annotated` is `True`, the inverse instruction is implemented as :class:`.AnnotatedOperation`, and corresponds to the given instruction annotated with the "inverse modifier". Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.) In particular, they can choose how to handle the argument ``annotated`` which may include ignoring it and always returning a concrete gate class if the inverse is defined as a standard gate. Args: annotated: if set to `True` the output inverse gate will be returned as :class:`.AnnotatedOperation`. Returns: The inverse operation. Raises: CircuitError: if the instruction is not composite and an inverse has not been implemented for it. Nzinverse() not implemented for .r)Gate_dgrJ)rrr)r r r6rrqiskit.circuitrendswithr r rrr0rr global_phaser_appendrinverserr)r annotatedrr inverse_gateinverse_definitionrs r"rInstruction.inverseus/6 %dO,=> > ?? "!? {!LM M' 99  e $ $99Sb>D99u$D ??&????{{'') L ToodkkN^N^N`aL!--==?+=+J+J*J'T--.D  & &t~~'='='?dkk Z/"4r%c@UR5nU(aXlU$)z Copy of the instruction. Args: name (str): name to be given to the copied circuit, if ``None`` then the name stays the same. Returns: qiskit.circuit.Instruction: a copy of the current instruction, with the name updated if it was provided ) __deepcopy__r)rrcpys r"r0Instruction.copys! H r%c[R"U5n[R"URU5UlUR(a&[R"URU5UlU$rW)r0deepcopyrr)rmemors r"rInstruction.__deepcopy__sKiiommDLL$7   "mmD,<,0d  (T  ]]KK   !!##,,1 \\ > >47r"%> @ [[  &&  &&r%r )r __future__rr0 itertoolsrrtypingrr7qiskit.circuit.exceptionsr"qiskit.circuit.parameterexpressionrqiskit.circuit.operationr"qiskit.circuit.annotated_operationr r r=r r,r%r"rs>*# !  2B.R)r%