z iSrSSKrSSKJrJr SSKJr SSKJr \RS:aSSK J r OSSK J r "SS \5r g) z$ Mixin for gate operator interface. N)ABCabstractmethod)Integral) QiskitError) )Selfc\rSrSrSrS\4SjrS\4SjrS\4SjrS\4Sjr \ S\4Sj5r \ S\4S j5r \ SS\4S jj5r SS\4S jjrS\4S jrSrg ) GroupMixina_Abstract Mixin for operator group operations. This class defines the following methods - :meth:`compose` - :meth:`dot` - :meth:`tensor` - :meth:`expand` - :meth:`power` And the following operator overloads: - ``&``, ``__and__`` -> :meth:`compose` - ``@``, ``__matmul__`` -> :meth:`dot` - ``^``, ``__xor__`` -> `:meth:`tensor` - ``**``, ``__pow__`` -> :meth:`power` The following abstract methods must be implemented by subclasses using this mixin - ``compose(self, other, qargs=None, inplace=False)`` - ``tensor(self, other)`` - ``expand(self, other)`` returnc$URU5$Ncomposeselfothers d/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/quantum_info/operators/mixins/group.py__and__GroupMixin.__and__7s||E""c$URU5$r)power)rns r__pow__GroupMixin.__pow__:szz!}rc$URU5$r)tensorrs r__xor__GroupMixin.__xor__=s{{5!!rc$URU5$r)dotrs r __matmul__GroupMixin.__matmul__@sxxrcg)aReturn the tensor product with another CLASS. Args: other (CLASS): a CLASS object. Returns: CLASS: the tensor product :math:`a \otimes b`, where :math:`a` is the current CLASS, and :math:`b` is the other CLASS. .. note:: The tensor product can be obtained using the ``^`` binary operator. Hence ``a.tensor(b)`` is equivalent to ``a ^ b``. .. note: Tensor uses reversed operator ordering to :meth:`expand`. For two operators of the same type ``a.tensor(b) = b.expand(a)``. Nrs rrGroupMixin.tensorCrcg)aReturn the reverse-order tensor product with another CLASS. Args: other (CLASS): a CLASS object. Returns: CLASS: the tensor product :math:`b \otimes a`, where :math:`a` is the current CLASS, and :math:`b` is the other CLASS. .. note: Expand is the opposite operator ordering to :meth:`tensor`. For two operators of the same type ``a.expand(b) = b.tensor(a)``. Nr'rs rexpandGroupMixin.expandWr)rNcg)aWReturn the operator composition with another CLASS. Args: other (CLASS): a CLASS object. qargs (list or None): Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None). front (bool): If True compose using right operator multiplication, instead of left multiplication [default: False]. Returns: CLASS: The composed CLASS. Raises: QiskitError: if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems. .. note:: Composition (``&``) by default is defined as `left` matrix multiplication for matrix operators, while ``@`` (equivalent to :meth:`dot`) is defined as `right` matrix multiplication. That is that ``A & B == A.compose(B)`` is equivalent to ``B @ A == B.dot(A)`` when ``A`` and ``B`` are of the same type. Setting the ``front=True`` kwarg changes this to `right` matrix multiplication and is equivalent to the :meth:`dot` method ``A.dot(B) == A.compose(B, front=True)``. Nr')rrqargsfronts rrGroupMixin.composegr)rc"URXSS9$)aReturn the right multiplied operator self * other. Args: other (CLASS): an operator object. qargs (list or None): Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None). Returns: CLASS: The right matrix multiplied CLASS. .. note:: The dot product can be obtained using the ``@`` binary operator. Hence ``a.dot(b)`` is equivalent to ``a @ b``. T)r.r/r)rrr.s rr#GroupMixin.dots ||Ed|;;rc[U[5(aUS:a [S5eUn[SU5HnUR U5nM U$)aCReturn the compose of a operator with itself n times. Args: n (int): the number of times to compose with self (n>0). Returns: CLASS: the n-times composed operator. Raises: QiskitError: if the input and output dimensions of the operator are not equal, or the power is not a positive integer. z,Can only power with positive integer powers.) isinstancerrranger#)rrret_s rrGroupMixin.powersJ!X&&!a%LM Mq!A''$-C rr')NFr)__name__ __module__ __qualname____firstlineno____doc__r rrr r$rrr+rr#r__static_attributes__r'rrr r s2##D""4 t  &  t       :<<$$rr )r>sysabcrrnumbersrqiskit.exceptionsr version_infotypingr typing_extensionsr r'rrrGs: #)w&NNr