z i"SrSSKJr SSKrSSKJr SSKrSSK J r SSK J r SSK Jr SSKJr SS KJr "S S \5r\"\5 g) z ScalarOp class ) annotationsN)Number) QiskitError) BaseOperator)LinearOp)Operator)generate_apidocsc^\rSrSrSrSSU4SjjjrSSjrSr\S5r Sr Sr SS jr S r SS jrSSS jjrSS jrSSjrSSjrSSjrSr\SSj5rSrU=r$)ScalarOpaaScalar identity operator class. This is a symbolic representation of an scalar identity operator on multiple subsystems. It may be used to initialize a symbolic scalar multiplication of an identity and then be implicitly converted to other kinds of operator subclasses by using the :meth:`compose`, :meth:`dot`, :meth:`tensor`, :meth:`expand` methods. ct>[U[5(d[SUS35eX l[TU]XS9 g)zInitialize an operator object. Args: dims (int or tuple): subsystem dimensions. coeff (Number): scalar coefficient for the identity operator (Default: 1). Raises: QiskitError: If the optional coefficient is invalid. zcoeff z must be a number. input_dims output_dimsN) isinstancerr_coeffsuper__init__)selfdimscoeff __class__s a/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/quantum_info/operators/scalar_op.pyrScalarOp.__init__'s<%((ug-?@A A  D;clUSLa [S5eUR5nUcU$URUSS9$)NFz,could not produce matrix without calculationcopy) ValueError to_matrixastype)rdtyperarrs r __array__ScalarOp.__array__7s= 5=KL LnnmsFE)FFrcDSUR5SURS3$)Nz ScalarOp(z, coeff=))rrrs r__repr__ScalarOp.__repr__=s#4??,-Xdjj\CCrcUR$)zReturn the coefficientrr(s rrScalarOp.coeff@s{{rcpUR5n[R"UR5UlU$N)rnp conjugaterr)rrets rr1ScalarOp.conjugateEs&iik\\$**-  rc"UR5$r/rr(s r transposeScalarOp.transposeJsyy{rcUc URnUc URn[R"[R"UR 5SXS9$)z,Return True if operator is a unitary matrix.)atolrtol)r9r:r0iscloseabsr)rr9r:s r is_unitaryScalarOp.is_unitaryMs> <99D <99Dzz"&&,adFFrcnURup[R"U[S9nURU-$)zConvert to a Numpy matrix.)r")dimr0eyecomplexr)rr@_idens rr ScalarOp.to_matrixUs,vvc)zzD  rcl[UR5UR5UR5S9$)zConvert to an Operator object.r)rr rrr(s r to_operatorScalarOp.to_operator[s- NN ):HXHXHZ  rcUc [USS5n[U[5(d [U5nURR URX#5n[U[ 5(a<[R"U5nURUR-Ul XElU$Uc=[R"U5nXElURS:XaU$URU-$URU5R XUS9$)Nqargsr8)rJfront) getattrrrr _op_shapecomposer _copyrrrr)rotherrJrK new_shaper2s rrNScalarOp.composeas =E7D1E%..UOENN**5??EI  eX & &**T"Cekk1CJ%MJ =**U#C%MzzQ ::# #t$,,Uu,MMrcNUR5nURU-UlU$)zReturn the power of the ScalarOp. Args: n (float): the exponent for the scalar op. Returns: ScalarOp: the ``coeff ** n`` ScalarOp. )rrr)rnr2s rpowerScalarOp.powers#iikZZ]  rcN[U[5(d [U5n[U[5(a`[R "U5nUR UR -UlURRUR5UlU$URU5$r/) rrrr rOrrrrMtensorexpandrrPr2s rrXScalarOp.tensoru%..UOE eX & &**T"Cekk1CJ NN11%//BCMJ||D!!rcN[U[5(d [U5n[U[5(a`[R "U5nUR UR -UlURRUR5UlU$URU5$r/) rrrr rOrrrrMrYrXrZs rrYScalarOp.expandr\rcXUc [USS5n[U[5(d [U5nURR URU5 [U[ 5(a/[ UR5URUR-S9$[ RXU5nURS:Xa.URUR5UR55$URUR5UR55RU5$)aReturn the operator self + other. If ``qargs`` are specified the other operator will be added assuming it is identity on all other subsystems. Args: other (BaseOperator): an operator object. qargs (None or list): optional subsystems to subtract on (Default: None) Returns: ScalarOp: if other is an ScalarOp. BaseOperator: if other is not an ScalarOp. Raises: QiskitError: if other has incompatible dimensions. NrJ)rr) rLrrrrM _validate_addr rr_pad_with_identityreshaper_add)rrPrJs rrc ScalarOp._adds$ =E7D1E%..UOE $$U__e< eX & &DOO-TZZ%++5MN N ++D? ::?==!2D4D4D4FG G }}T__.0@0@0BCHHNNrc[U[5(d[SUS35eUR5nXR-UlU$)zReturn the ScalarOp other * self. Args: other (Number): a complex number. Returns: ScalarOp: the scaled identity operator other * self. Raises: QiskitError: if other is not a valid complex number. zother (z) is not a number)rrrrrrrZs r _multiplyScalarOp._multiplysD%((w.?@A AiikZZ'  rcXUcU$[UR55RXS9$)zPad another operator with identities. Args: current (BaseOperator): current operator. other (BaseOperator): other operator. qargs (None or list): qargs Returns: BaseOperator: the padded operator. )rJ)r rrN)currentrPrJs rraScalarOp._pad_with_identitys0 =L**,-55e5IIrr,)Nr8)rzint | tuple | Nonerr)NN)returnr)NF)rPr rJz list | NonerKboolrkr )rTfloatrkr )rPr rkr r/)__name__ __module__ __qualname____firstlineno____doc__rr$r)propertyrr1r5r=r rGrNrUrXrYrcrf staticmethodra__static_attributes__ __classcell__)rs@rr r s<< G D G!  #NJ  " "-O^$ J Jrr )rr __future__rrrOnumbersrnumpyr0qiskit.exceptionsr+qiskit.quantum_info.operators.base_operatorr'qiskit.quantum_info.operators.linear_opr&qiskit.quantum_info.operators.operatorr$qiskit.quantum_info.operators.mixinsr r rrrsB#)D<;A]Jx]JBr