\ht6SSKJr SSKJr SSKJr SSKJr SSKJ r SSK J r SSK J r SSKJr SS KJrJrJrJrJr S S /r"S S \5rS rSr"SS \5rSrSrSrg))Expr)Symbol)sympify)Matrix) prettyForm)Tuple) is_sequence)Dagger) numpy_ndarrayscipy_sparse_matrixto_sympyto_numpyto_scipy_sparse QuantumErrorQExprc\rSrSrSrg)rN)__name__ __module__ __qualname____firstlineno____static_attributes__rS/var/www/auris/envauris/lib/python3.13/site-packages/sympy/physics/quantum/qexpr.pyrrsrc*[[U55$)afConvert elements of a sequence to standard form. This is like sympify, but it performs special logic for arguments passed to QExpr. The following conversions are done: * (list, tuple, Tuple) => _qsympify_sequence each element and convert sequence to a Tuple. * basestring => Symbol * Matrix => Matrix * other => sympify Strings are passed to Symbol, not sympify to make sure that variables like 'pi' are kept as Symbols, not the SymPy built-in number subclasses. Examples ======== >>> from sympy.physics.quantum.qexpr import _qsympify_sequence >>> _qsympify_sequence((1,2,[3,4,[1,]])) (1, 2, (3, 4, (1,))) )tuple__qsympify_sequence_helper)seqs r_qsympify_sequencer s0 +C0 11rc$[U5(dB[U[5(aU$[U[5(a [ U5$[ U5$[U[ 5(aU$UVs/sHn[U5PM nn[U6$s snf)zL Helper function for _qsympify_sequence This function does the actual work. ) r isinstancerstrrrrrr)ritemresults rrr8s s   c6 " "J S ! !#; 3< #u @s.B c\rSrSrSrSrSrSrSr\ S5r \ S5r \ S 5r \ S 5rS r\ S 5r\ S 5rSrSrSrSrS$SjrSrSrSrSrSrSrSrSrSrSr Sr!Sr"SS .S!jr#S"r$S#r%g)%rUz>A base class for all quantum object like operators and states.) hilbert_spaceFcUR"U40UD6n[U5S:Xa*UR"[UR5540UD6n[R "U/UQ76nUR U5UlU$)aConstruct a new quantum object. Parameters ========== args : tuple The list of numbers or parameters that uniquely specify the quantum object. For a state, this will be its symbol or its set of quantum numbers. Examples ======== >>> from sympy.physics.quantum.qexpr import QExpr >>> q = QExpr(0) >>> q 0 >>> q.label (0,) >>> q.hilbert_space H >>> q.args (0,) >>> q.is_commutative False r) _eval_argslenr default_argsr__new___eval_hilbert_spacer()clsargskwargsinsts rr. QExpr.__new__dsn:~~d-f- t9>>>%(8(8(:";FvFD||C'$' 44T: rcF[R"U/UQ70UD6nXlU$)adCreate new instance of this class with hilbert_space and args. This is used to bypass the more complex logic in the ``__new__`` method in cases where you already have the exact ``hilbert_space`` and ``args``. This should be used when you are positive these arguments are valid, in their final, proper form and want to optimize the creation of the object. )rr.r()r0r(r1old_assumptionsobjs r _new_rawargsQExpr._new_rawargss'll3999) rc[UR5S:Xa(UR[UR 555$UR$)zThe label is the unique set of identifiers for the object. Usually, this will include all of the information about the state *except* the time (in the case of time-dependent objects). This must be a tuple, rather than a Tuple. r)r,r1r+listr-selfs rlabel QExpr.labels; tyy>Q ??4(9(9(;#<= =99 rcg)NTrr<s r is_symbolicQExpr.is_symbolicsrc[S5e)aIf no arguments are specified, then this will return a default set of arguments to be run through the constructor. NOTE: Any classes that override this MUST return a tuple of arguments. Should be overridden by subclasses to specify the default arguments for kets and operators z$No default arguments for this class!NotImplementedErrorr<s rr-QExpr.default_argss""HIIrc[R"U5nUc"[U5n[ U[ 5(aUR UlU$N)r _eval_adjointr.r r"rr()r=r7s rrIQExpr._eval_adjointsG  & ;,,vt,C c5 ! ! $ 2 2C  rc[U5$)zbProcess the args passed to the __new__ method. This simply runs args through _qsympify_sequence. )r )r0r1s rr+QExpr._eval_argss "$''rcSSKJn U"5$)z:Compute the Hilbert space instance from the args. r) HilbertSpace)sympy.physics.quantum.hilbertrN)r0r1rNs rr/QExpr._eval_hilbert_spaces ?~rc~/nUH%nURUR"U/UQ765 M' URU5$rH)append_printjoin)r=rsepprinterr1r%r$s r_print_sequenceQExpr._print_sequences:D MM'..55 6xxrc UR"US/UQ76nUSSHBn[URU56n[URUR"U/UQ7656nMD U$)Nr)rSrright)r=rrUrVr1pformr$s r_print_sequence_prettyQExpr._print_sequence_prettysds1v--GD C 01E GNN4,G$,G HIE rc[URSUR5-56n[URSUR5-56n[UR U5S[R 06$)N binding)rleftwidthr[belowPOW)r=abtopbots r_print_subscript_prettyQExpr._print_subscript_prettysX!&&QWWY/0!''#aggi-01399S>B*..BBrc X-$rHr)r=rfrgs r_print_superscript_prettyQExpr._print_superscript_prettys t rc,[URX#S96$)N)rbr[)rparens)r=r\rbr[s r_print_parens_prettyQExpr._print_parens_prettys5<_label_separatorr=rVr1s r _print_labelQExpr._print_labels0## JJ--w 9=  rc@UR"URSU/UQ76$)N,)rWr>rvs r_print_label_reprQExpr._print_label_reprs(## JJW '+  rcTUR"URURU/UQ76$rH)r]r>rurvs r_print_label_prettyQExpr._print_label_prettys.** JJ--w 9=  rcTUR"URURU/UQ76$rHrtrvs r_print_label_latexQExpr._print_label_latex s.## JJ--w 9=  rc(UR"U/UQ76$)a+Printer for contents of QExpr Handles the printing of any unique identifying contents of a QExpr to print as its contents, such as any variables or quantum numbers. The default is to print the label, which is almost always the args. This should not include printing of any brackets or parentheses. )rwrvs r_print_contentsQExpr._print_contentss  0400rc(UR"U/UQ76$rH)r~rvs r_print_contents_prettyQExpr._print_contents_prettys''7$77rc(UR"U/UQ76$rH)rrvs r_print_contents_latexQExpr._print_contents_latexs&&w666rc(UR"U/UQ76$)aDefault printing behavior of QExpr objects Handles the default printing of a QExpr. To add other things to the printing of the object, such as an operator name to operators or brackets to states, the class should override the _print/_pretty/_latex functions directly and make calls to _print_contents where appropriate. This allows things like InnerProduct to easily control its printing the printing of contents. )rrvs r _sympystrQExpr._sympystr#s##G3d33rchURRnUR"U/UQ76nU<SU<S3$)N()) __class__rr{)r=rVr1 classnamer>s r _sympyreprQExpr._sympyrepr/s1NN++ &&w66$e,,rc,UR"U/UQ76nU$rH)r)r=rVr1r\s r_pretty QExpr._pretty4s++G;d; rc(UR"U/UQ76$rH)rrvs r_latex QExpr._latex8s))'9D99rc [S5e)Nz)This object does not have a default basisrD)r=optionss r_represent_default_basisQExpr._represent_default_basis?s!"MNNrN)basisc UcUR"S0UD6nO[USU40UD6nURSS5nURX45nU$)aRepresent this object in a given basis. This method dispatches to the actual methods that perform the representation. Subclases of QExpr should define various methods to determine how the object will be represented in various bases. The format of these methods is:: def _represent_BasisName(self, basis, **options): Thus to define how a quantum object is represented in the basis of the operator Position, you would define:: def _represent_Position(self, basis, **options): Usually, basis object will be instances of Operator subclasses, but there is a chance we will relax this in the future to accommodate other types of basis sets that are not associated with an operator. If the ``format`` option is given it can be ("sympy", "numpy", "scipy.sparse"). This will ensure that any matrices that result from representing the object are returned in the appropriate matrix format. Parameters ========== basis : Operator The Operator whose basis functions will be used as the basis for representation. options : dict A dictionary of key/value pairs that give options and hints for the representation, such as the number of basis functions to be used. _representformatsympyr)rdispatch_methodget_format_represent)r=rrr%rs rrQExpr._representBsWD =22=W=F$T<J'JFXw/''7 rcUS:Xa [U[5(d [U5$US:Xa [U[5(d [ U5$US:Xa [U[ 5(d [ U5$U$)Nrnumpyz scipy.sparse)r"rr r rr r)r=r%rs rrQExpr._format_representnsf W Z%?%?F# # w z&-'H'HF# # ~ %v':;;"6* * rr)rr)&rrrr__doc__ __slots__is_commutativerur. classmethodr8propertyr>rAr-rIr+r/rWr]rjrmrqrwr{r~rrrrrrrrrrrrrrrrrUsH$IN#J  $  JJ(( C A     187 4- :O#'*X rcBUR5up[U5nX4$)z1Split into commutative and non-commutative parts.)args_cncr;)ec_partnc_parts rsplit_commutative_partsrzs jjlOF &\F ?rc/n/nURH<n[U[5(dURU5 M+URU5 M> X4$)z=Split an expression into Expr and noncommutative QExpr parts.)r1r"rrR)r expr_part qexpr_partargs rsplit_qexpr_partsrsNIJvv#u%%   S !   c "    rc U<SURR<3n[X5(a[X5nU"U40UD6nUbU$[ URR<SU<SU<35e)z)Dispatch a method to the proper handlers._.z cannot handle: )rrhasattrgetattrrE)r=basenamerr method_namefr%s rrrsh%s}}'='=>Kt!! D &3"'"  M   (C 1 rN)sympy.core.exprrsympy.core.symbolrsympy.core.sympifyrsympy.matrices.denser sympy.printing.pretty.stringpictrsympy.core.containersrsympy.utilities.iterablesr sympy.physics.quantum.daggerr !sympy.physics.quantum.matrixutilsr r r rr__all__ Exceptionrr rrrrrrrrrsj $&'7'1/    9 26:bDbJ  ! r