\h[%TSrSSKJrJrJrJrJrJrJr SSK J r SSK J r J r Jr SSKJrJrJrJrJrJrJr SS/r\\"\\45\\"\\45\\"\\45\\ \\"\\\45\\\\0r\R55VVs0sHupX_M snnrSrS rS rS rS r S r!gs snnf)aA module for mapping operators to their corresponding eigenstates and vice versa It contains a global dictionary with eigenstate-operator pairings. If a new state-operator pair is created, this dictionary should be updated as well. It also contains functions operators_to_state and state_to_operators for mapping between the two. These can handle both classes and instances of operators and states. See the individual function descriptions for details. TODO List: - Update the dictionary with a complete list of state-operator pairs )XOpYOpZOpXKetPxOpPxKet PositionKet3D)Operator) StateBaseBraBaseKet)JxOpJyOpJzOpJ2OpJxKetJyKetJzKetoperators_to_statestate_to_operatorsc z[U[[45(d [U[5(d [ S5e[U[5(aUH:n[U[5(aM[U[5(aM1[ S5e [ U5nU[ ;a6UVs/sH oD"5PM nn[[ U[U540UD6nU$UVs/sHn[U5PM nn[ U5n U [ ;a[[ U U40UD6nU$SnU$U[ ;aU"5n [[ UU 40UD6nU$[U5[ ;a[[ [U5U40UD6$gs snf![a [ UnU$f=fs snf![a [ UnU$f=f)aReturns the eigenstate of the given operator or set of operators A global function for mapping operator classes to their associated states. It takes either an Operator or a set of operators and returns the state associated with these. This function can handle both instances of a given operator or just the class itself (i.e. both XOp() and XOp) There are multiple use cases to consider: 1) A class or set of classes is passed: First, we try to instantiate default instances for these operators. If this fails, then the class is simply returned. If we succeed in instantiating default instances, then we try to call state._operators_to_state on the operator instances. If this fails, the class is returned. Otherwise, the instance returned by _operators_to_state is returned. 2) An instance or set of instances is passed: In this case, state._operators_to_state is called on the instances passed. If this fails, a state class is returned. If the method returns an instance, that instance is returned. In both cases, if the operator class or set does not exist in the state_mapping dictionary, None is returned. Parameters ========== arg: Operator or set The class or instance of the operator or set of operators to be mapped to a state Examples ======== >>> from sympy.physics.quantum.cartesian import XOp, PxOp >>> from sympy.physics.quantum.operatorset import operators_to_state >>> from sympy.physics.quantum.operator import Operator >>> operators_to_state(XOp) |x> >>> operators_to_state(XOp()) |x> >>> operators_to_state(PxOp) |px> >>> operators_to_state(PxOp()) |px> >>> operators_to_state(Operator) |psi> >>> operators_to_state(Operator()) |psi> z%Argument is not an Operator or a set!zSet is not all Operators!N) isinstancer set issubclassNotImplementedError frozenset op_mapping _get_statetype) operatorsoptionssopsop op_instancesretotmpclasses op_instances Y/var/www/auris/envauris/lib/python3.13/site-packages/sympy/physics/quantum/operatorset.pyrr/sl y8S/ 2 2jH6U6U!"IJJ)S!!Aq(++ H--)*EFF  " *  &/23ss 3 C#l2COwOJ$'(Cq47CC(nG*$ G!4cEWEJJ  " ,'k  I!6 OwOJ )_ *ji99PP P9 4& & oJ & )' , +J ,s<'F+E?;F F1F#?FFF#F:9F:c r[U[5(d [U[5(d [S5eU[;a*[ U5n[ U[[U540UD6nO[U5[;a'[ U[[[U5540UD6nO[U[5(aCUR5[;a+[ U[[UR555nOf[U[5(aOUR5[;a7[ U5n[ U[[UR555nOSn[U5$![[4a [UnN&f=f![[4a [UR5nNSf=f)aReturns the operator or set of operators corresponding to the given eigenstate A global function for mapping state classes to their associated operators or sets of operators. It takes either a state class or instance. This function can handle both instances of a given state or just the class itself (i.e. both XKet() and XKet) There are multiple use cases to consider: 1) A state class is passed: In this case, we first try instantiating a default instance of the class. If this succeeds, then we try to call state._state_to_operators on that instance. If the creation of the default instance or if the calling of _state_to_operators fails, then either an operator class or set of operator classes is returned. Otherwise, the appropriate operator instances are returned. 2) A state instance is returned: Here, state._state_to_operators is called for the instance. If this fails, then a class or set of operator classes is returned. Otherwise, the instances are returned. In either case, if the state's class does not exist in state_mapping, None is returned. Parameters ========== arg: StateBase class or instance (or subclasses) The class or instance of the state to be mapped to an operator or set of operators Examples ======== >>> from sympy.physics.quantum.cartesian import XKet, PxKet, XBra, PxBra >>> from sympy.physics.quantum.operatorset import state_to_operators >>> from sympy.physics.quantum.state import Ket, Bra >>> state_to_operators(XKet) X >>> state_to_operators(XKet()) X >>> state_to_operators(PxKet) Px >>> state_to_operators(PxKet()) Px >>> state_to_operators(PxBra) Px >>> state_to_operators(XBra) X >>> state_to_operators(Ket) O >>> state_to_operators(Bra) O zArgument is not a state!N) rr rr state_mapping _make_default_get_ops _make_set TypeErrorrr dual_class)stater! state_instr&s r+rrsv ui ( (Jui,H,H!"<== "5)  ':$]5%9:G>EGC e %u tE{!;<I@GI E7 # #(8(8(:m(Ku u/?/?/A!BCE E7 # #(8(8(:m(K"5)  4:$]53C3C3E%FGIC  S>%$Y/ '&C '$Y/ 4 0 0 23C 4s$ E-5*F -F F  'F65F6c<U"5nU$![a UnU$f=fN)r1)exprr&s r+r.r.s0f J  Js  c fUR"U40UD6nU$![a [U5nU$f=fr6)_operators_to_staterr.) state_classr#r!r&s r+rrsC)--c=W= J )K( J)s 00c UR"U40UD6n[U[5(a[U5S:XaUS$U$![aB [U[[[ 45(a[ SU55nNi[ U5nNvf=f)Nc38# UHn[U5v M g7fr6)r.).0xs r+ _get_ops.. s=*Q a((*sr)_state_to_operatorsrrrtuplerr.len)r4 op_classesr!r&s r+r/r/s,,,ZC7C#sCA 1v J , j3y"9 : :=*==C +C ,sA B  B c\[U[[[45(a [ U5$U$r6)rrClistrr)r#s r+r0r0s$#tY/003x N)"__doc__sympy.physics.quantum.cartesianrrrrrrr sympy.physics.quantum.operatorr sympy.physics.quantum.stater r r sympy.physics.quantum.spinrrrrrrr__all__rr-itemsrrrr.rr/r0)kvs00r+rRs <<<3??/// D$<0D$<0D$<0xCc?!;   -224 54tqad4 5 aHUp "O6s?B$