\h:6SrSSKJr SSKJr SSKJr SSKJr SSK J r SSK J r SSK Jr SS KJr /S QrS rSS jrSSjrSrSSjrSrSSjrSSjrSrg )z1Primitive circuit operations on quantum circuits.)reduce)default_sort_key)Tuple)Mul)Symbolsympify)numbered_symbols)Gate) kmp_tablefind_subcircuitreplace_subcircuitconvert_to_symbolic_indicesconvert_to_real_indices random_reduce random_insertc*SnSn/nURS5 URS5 U[U5:a[XS- X:XaUS-nURU5 US-nO!US:aX2nOURS5 US-nU[U5:aM[U$)zBuild the 'partial match' table of the Knuth-Morris-Pratt algorithm. Note: This is applicable to strings or quantum circuits represented as tuples. r)appendlen)wordposcndtables Z/var/www/auris/envauris/lib/python3.13/site-packages/sympy/physics/quantum/circuitutils.pyr r s C C E LL LLO D / a=DI %'C LL 'C 1W*C LLO'C D / Lc[U[5(a URn[U[5(a URn[U5S:Xd[U5[U5:agUS:a [U5nUnSn[ U5nXE-U:aEXXU-:XaUS-nOXE-Xe- nXeS:aXeOSnU[U5:XaU$XE-U:aMEg)aHFinds the subcircuit in circuit, if it exists. Explanation =========== If the subcircuit exists, the index of the start of the subcircuit in circuit is returned; otherwise, -1 is returned. The algorithm that is implemented is the Knuth-Morris-Pratt algorithm. Parameters ========== circuit : tuple, Gate or Mul A tuple of Gates or Mul representing a quantum circuit subcircuit : tuple, Gate or Mul A tuple of Gates or Mul to find in circuit start : int The location to start looking for subcircuit. If start is the same or past end, -1 is returned. end : int The last place to look for a subcircuit. If end is less than 1 (one), then the length of circuit is taken to be end. Examples ======== Find the first instance of a subcircuit: >>> from sympy.physics.quantum.circuitutils import find_subcircuit >>> from sympy.physics.quantum.gate import X, Y, Z, H >>> circuit = X(0)*Z(0)*Y(0)*H(0) >>> subcircuit = Z(0)*Y(0) >>> find_subcircuit(circuit, subcircuit) 1 Find the first instance starting at a specific position: >>> find_subcircuit(circuit, subcircuit, start=1) 1 >>> find_subcircuit(circuit, subcircuit, start=2) -1 >>> circuit = circuit*subcircuit >>> find_subcircuit(circuit, subcircuit, start=2) 4 Find the subcircuit within some interval: >>> find_subcircuit(circuit, subcircuit, start=2, end=2) -1 rrr) isinstancerargsrr )circuit subcircuitstartendrindexrs rr r 8sp'3,,*c""__  :!s:W= Qw'l C E j !E ;#   e 4 4AIE+ ,C$)L2$5EL1E C O #J ;#  rNcRUS:aSn[U[5(a URn[U[5(a URn[U[5(a URnOUcSn[XUS9nUS:a%USUnX[ U5-[ U5nXR-U-nU$)aReplaces a subcircuit with another subcircuit in circuit, if it exists. Explanation =========== If multiple instances of subcircuit exists, the first instance is replaced. The position to being searching from (if different from 0) may be optionally given. If subcircuit cannot be found, circuit is returned. Parameters ========== circuit : tuple, Gate or Mul A quantum circuit. subcircuit : tuple, Gate or Mul The circuit to be replaced. replace : tuple, Gate or Mul The replacement circuit. pos : int The location to start search and replace subcircuit, if it exists. This may be used if it is known beforehand that multiple instances exist, and it is desirable to replace a specific instance. If a negative number is given, pos will be defaulted to 0. Examples ======== Find and remove the subcircuit: >>> from sympy.physics.quantum.circuitutils import replace_subcircuit >>> from sympy.physics.quantum.gate import X, Y, Z, H >>> circuit = X(0)*Z(0)*Y(0)*H(0)*X(0)*H(0)*Y(0) >>> subcircuit = Z(0)*Y(0) >>> replace_subcircuit(circuit, subcircuit) (X(0), H(0), X(0), H(0), Y(0)) Remove the subcircuit given a starting search point: >>> replace_subcircuit(circuit, subcircuit, pos=1) (X(0), H(0), X(0), H(0), Y(0)) >>> replace_subcircuit(circuit, subcircuit, pos=2) (X(0), Z(0), Y(0), H(0), X(0), H(0), Y(0)) Replace the subcircuit: >>> replacement = H(0)*Z(0) >>> replace_subcircuit(circuit, subcircuit, replace=replacement) (X(0), H(0), Z(0), H(0), X(0), H(0), Y(0)) r)r$r)r rr!r r)r"r#replacerlocleftrights rrrsp Qw'3,,*c""__ '3,,  'S 9C Rxq~c*o-c'l;.5( Nrc:0nUHn[X5X'M U$Nr)mappingnew_mapkeys r_sympify_qubit_mapr2s$Gw|,  Nrc[U[5(a URn[SSS9n[ U5n0nSnUb'[U[ 5(dSU-n[ U5eUnUb5[U[5R5(dSU-n[ U5eUnUb*[U[5(dSSU--n[ U5eUn[U5nU"U5n S n UHn [U [5(a5[U RUUUS 9n U uppTURU5 U"U5n Oe[U [[45(a+[U UUUS 9n U uppTURU5 U"U5n OX;aXn O[ U5nXU'XYU 'Un [U [5(aU R"U 6n X4-n M XXT4$) aReturns the circuit with symbolic indices and the dictionary mapping symbolic indices to real indices. The mapping is 1 to 1 and onto (bijective). Parameters ========== seq : tuple, Gate/Integer/tuple or Mul A tuple of Gate, Integer, or tuple objects, or a Mul start : Symbol An optional starting symbolic index gen : object An optional numbered symbol generator qubit_map : dict An existing mapping of symbolic indices to real indices All symbolic indices have the format 'i#', where # is some number >= 0. ir)prefixr$cLSn[[XR555$)NcUSUS4$)Nrrr()items rIconvert_to_symbolic_indices..create_inverse_map.. s$q'47!3r)dictmapitems)symb_to_real_map rev_itemss rcreate_inverse_map7convert_to_symbolic_indices..create_inverse_map s 3 C #9#9#;<==rz+Expected Symbol for starting index, got %r.zExpected a generator, got %r.z$Expected dict for existing map, got z%r.r() qubit_mapr$gen)r rr!r nextr TypeError __class__r;r2r rupdatetupler)seqr$rCrB index_gencur_ndxndx_mapr@msginv_mapsym_seqr8resultsym_itemr0s rrrs,#shh!26I9oGG> %((?%GCC.  #/1;;<<1C7CC.  )T**99$%CC.  )G )GG dD ! !0;B7>5>@F5; 1Hw NN7 #(1G uen - -0;B7>5>@F5; 1Hw NN7 #(1G _}H3iG#G #DMH dD ! !~~x0HK'AD W //rc[U[5(a URn[U[5(dSU-n[ U5e[ U5nSnUHn[U[ 5(a[URU5nO+[U[[45(a [XA5nOXn[U[ 5(aUR"U6nX54-nM U$)a_Returns the circuit with real indices. Parameters ========== seq : tuple, Gate/Integer/tuple or Mul A tuple of Gate, Integer, or tuple objects or a Mul qubit_map : dict A dictionary mapping symbolic indices to real indices. Examples ======== Change the symbolic indices to real integers: >>> from sympy import symbols >>> from sympy.physics.quantum.circuitutils import convert_to_real_indices >>> from sympy.physics.quantum.gate import X, Y, H >>> i0, i1 = symbols('i:2') >>> index_map = {i0 : 0, i1 : 1} >>> convert_to_real_indices(X(i0)*Y(i1)*H(i0)*X(i1), index_map) (X(0), Y(1), H(0), X(1)) z$Expected dict for qubit_map, got %r.r() r rr!r;rEr2r rrHrrF)rIrBrMreal_seqr8 real_items rrrMs2#shh i & &4y@n"9-IH dD ! !/ 9EI uen - -/@I"I dD ! ! 2Il* Orc&SSKJn U(dU$[U[5(a URn[ U5nU"U5nU(a;U"[ U55nURU5n[X5S:waO U(aM;U$[X5$)awShorten the length of a quantum circuit. Explanation =========== random_reduce looks for circuit identities in circuit, randomly chooses one to remove, and returns a shorter yet equivalent circuit. If no identities are found, the same circuit is returned. Parameters ========== circuit : Gate tuple of Mul A tuple of Gates representing a quantum circuit gate_ids : list, GateIdentity List of gate identities to find in circuit seed : int or list seed used for _randrange; to override the random selection, provide a list of integers: the elements of gate_ids will be tested in the order given by the list r _randranger) sympy.core.randomrWr rr! flatten_idsrpopr r)r"gate_idsseedrWids randranger4ids rrrs.- '3,, h C4 I  c#h  WWQZ 7 '2 -  # g **rcSSKJn U(dU$[U[5(a URnU"U5nU"[ U5S-5nX"[ U55n[ U5nX`XU&[U5$)axInsert a circuit into another quantum circuit. Explanation =========== random_insert randomly chooses a location in the circuit to insert a randomly selected circuit from amongst the given choices. Parameters ========== circuit : Gate tuple or Mul A tuple or Mul of Gates representing a quantum circuit choices : list Set of circuit choices seed : int or list seed used for _randrange; to override the random selections, give a list two integers, [i, j] where i is the circuit location where choice[j] will be inserted. Notes ===== Indices for insertion should be [0, n] if n is the length of the circuit. rrVr)rXrWr rr!rlistrH)r"choicesr\rWr^r*choices rrrsr6- '3,,4 I CL1$ %C Ys7|, -F7mGC >rcJSn[X/5nUR[S9 U$)Nc8U[UR[S9-$)Nr1)sortedequivalent_idsr)accan_ids rr9flatten_ids..s#u/C/C,<)>#>rrf)rsortr)r]collapses rrYrYs)>H  #CHH!H" Jr)rr)Nr)NNNr.)__doc__ functoolsrsympy.core.sortingrsympy.core.containersrsympy.core.mulrsympy.core.symbolrsympy.core.sympifyr sympy.utilitiesr sympy.physics.quantum.gater __all__r r rr2rrrrrYr(rrrxs^7/'$&,+ @UpRj^0B2j/+d*^r