z ijSrSSKJr SSKrSSKJr SSKJr SSK J r J r SSK J r SS KJrJrJr \"5rS SS jjrSSS jjrSSS jjrg)z% Methods to create random operators. ) annotationsN) default_rng) QiskitError)Operator Stinespring)random_cnotdihedral)random_clifford random_paulirandom_pauli_listcUc[nO7[U[RR5(aUnO [ U5n[R "U5nSSKJn URRX2S9n[XPUS9$)aKReturn a random unitary Operator. The operator is sampled from the unitary Haar measure. Args: dims (int or tuple): the input dimensions of the Operator. seed (int or np.random.Generator): Optional. Set a fixed seed or generator for RNG. Returns: Operator: a unitary operator. rstats random_state input_dims output_dims) DEFAULT_RNG isinstancenprandom Generatorrprodscipyr unitary_grouprvsr)dimsseedrdimrmats ^/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/quantum_info/operators/random.pyrandom_unitaryr# sj |" D"))-- . . "4( ''$-C    ! !# ! AC Cd ;;ctUc[nO7[U[RR5(aUnO [ U5n[R "U5nSSKJn U(a[R"XD4[S9nOA[R"URRSXCS9R[55nXDS- -S-nURRSXsS9nURRSXsS9n [R"US5upUS U --XjU 4'US U -- XkU 4'[!X`US 9$) aReturn a random hermitian Operator. The operator is sampled from Gaussian Unitary Ensemble. Args: dims (int or tuple): the input dimension of the Operator. traceless (bool): Optional. If True subtract diagonal entries to return a traceless hermitian operator (Default: False). seed (int or np.random.Generator): Optional. Set a fixed seed or generator for RNG. Returns: Operator: a Hermitian operator. rr)dtyper)scalesizerg?y?r)rrrrrrrrrzeroscomplexdiagnormrastype tril_indicesr) r tracelessrrngr rr!num_tril real_tril imag_trilrowscolss r"random_hermitianr8;s$ | D"))-- . .$ ''$-Chhz1ggejjnn13nIPPQXYZQwA%H SxJI SxJIb)JD!BN2Ct !BN2Ct  Cd ;;r$cXUcUc [S5eUcUnOUcUn[R"U5n[R"U5nUbX$U-:aXE-nUS:a[SUS35eSSKJn UR R [X%-U5US9n[USS2SU24XS 9$) amReturn a random CPTP quantum channel. This constructs the Stinespring operator for the quantum channel by sampling a random isometry from the unitary Haar measure. Args: input_dims (int or tuple): the input dimension of the channel. output_dims (int or tuple): the input dimension of the channel. rank (int): Optional. The rank of the quantum channel Choi-matrix. seed (int or np.random.Generator): Optional. Set a fixed seed or generator for RNG. Returns: Stinespring: a quantum channel operator. Raises: QiskitError: if rank or dimensions are invalid. NzHNo dimensions specified: input_dims and output_dims cannot both be None.rzRank z must be greater than 0.rrrr) rrrrrrrmaxr)rrrankrd_ind_outrunitarys r"random_quantum_channelr?is2k1 V     77: D GGK E |tUl*| axE$'?@AA!!%%c$,&=D%QG wq%4%x(Z YYr$)N)r int | tupler int | np.random.Generator | None)FN)rr@r1boolrrA)NNNN)rint | tuple | NonerrCr;z int | NonerrA)__doc__ __future__rnumpyr numpy.randomrqiskit.exceptionsrqiskit.quantum_info.operatorsrrdihedral.randomr symplectic.randomr r r rr#r8r?r$r"rMs#$)?1OOm <8Z^+< +<"&+<6V+<^&*&*-1 1Z"1Z#1Z 1Z + 1Zr$