z iSrSSKJr SSKJr SSKrSSKJr SSK J r SSK J r SS K Jr SS KJr SSS jjrSSS jjrS rSrSrg)z Random state generation. ) annotations)LiteralN) default_rng) QiskitError)random_unitary) Statevector) DensityMatrixcUc[RR5nO7[U[RR5(aUnO [U5n[R "U5nUR U5R[5nUSUR U5-- nU[RRU5-n[X@S9$)aNGenerator a random Statevector. The statevector is sampled from the uniform distribution. This is the measure induced by the Haar measure on unitary matrices. Args: dims (int or tuple): the dimensions of the state. seed (int or np.random.Generator): Optional. Set a fixed seed or generator for RNG. Returns: Statevector: the random statevector. Reference: K. Zyczkowski and H. Sommers (2001), "Induced measures in the space of mixed quantum states", `J. Phys. A: Math. Gen. 34 7111 `__. ?dims) nprandomr isinstance Generatorprodstandard_normalastypecomplexlinalgnormr )rseedrngdimvecs [/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/quantum_info/states/random.pyrandom_statevectorrs( |ii##% D"))-- . .$ ''$-C  c " ) )' 2C2##C( ((C299>># C s &&c[R"U5nUcUnUS:Xa [XAU5nO!US:Xa [XAU5nO[ SU35e[ XPS9$)a|Generator a random DensityMatrix. Args: dims (int or tuple): the dimensions of the DensityMatrix. rank (int or None): Optional, the rank of the density matrix. The default value is full-rank. method (string): Optional. The method to use. 'Hilbert-Schmidt': (Default) sample from the Hilbert-Schmidt metric. 'Bures': sample from the Bures metric. seed (int or np.random.Generator): Optional. Set a fixed seed or generator for RNG. Returns: DensityMatrix: the random density matrix. Raises: QiskitError: if the method is not valid. Hilbert-SchmidtBureszError: unrecognized method r )rr_random_density_hs_random_density_buresrr )rrankmethodrrrhos rrandom_density_matrixr(?sb2 ''$-C | "" D1 7 #Ct47x@AA  ((rcUc[RR5nO7[U[RR5(aUnO [U5nUR X4S9UR X4S9S--nU$)a]Return a normally distributed complex random matrix. Args: nrow (int): number of rows in output matrix. ncol (int): number of columns in output matrix. seed(int or np.random.Generator): default rng. Returns: ndarray: A complex rectangular matrix where each real and imaginary entry is sampled from the normal distribution. )sizer )rrrrrnormal)nrowncolrrginibres r_ginibre_matrixr/eso |ii##% D"))-- . .$jjtlj+cjjtlj.Kb.PPG Nrc[XU5nURUR5R5nU[R "U5- $)aG Generate a random density matrix from the Hilbert-Schmidt metric. Args: dim (int): the dimensions of the density matrix. rank (int or None): the rank of the density matrix. The default value is full-rank. seed (int or np.random.Generator): default rng. Returns: ndarray: rho (N,N) a density matrix. )r/dotconjTrtrace)rr%rmats rr#r#|s; #T *C ''#((*,, C # rc[R"U5[XS9R-nUR [ XU55nUR UR 5R5nU[R"U5- $)a7Generate a random density matrix from the Bures metric. Args: dim (int): the length of the density matrix. rank (int or None): the rank of the density matrix. The default value is full-rank. seed (int or np.random.Generator): default rng. Returns: ndarray: rho (N,N) a density matrix. )r) reyerdatar1r/r2r3r4)rr%rdensityr5s rr$r$saffSkN3:???G ++oc6 7C ''#((*,, C # r)N)r int | tupler int | np.random.Generator | Nonereturnr )Nr!N) rr:r%z int | Noner&z#Literal['Hilbert-Schmidt', 'Bures']rr;r<r )__doc__ __future__rtypingrnumpyr numpy.randomrqiskit.exceptionsr$qiskit.quantum_info.operators.randomr statevectorr densitymatrixr rr(r/r#r$rrrGs#$)?$(AE' '=''H2C-1 #) #) #) 0#) + #)  #)L.$r