z iTSrSSKJr SSKJrJr SSKrSSKJ r J r SSK J r J r SSKJr SSKJr "S S \ 5rS S S jjrg)zQuantum Volume model circuit.) annotations)OptionalUnionN)QuantumCircuitCircuitInstruction)PermutationGate UnitaryGate)quantum_volume)deprecate_funccn^\rSrSrSr\"SSSS9S SS.S U4S jjjj5rS rU=r$) QuantumVolumea A quantum volume model circuit. The model circuits are random instances of circuits used to measure the Quantum Volume metric, as introduced in [1]. The model circuits consist of layers of Haar random elements of SU(4) applied between corresponding pairs of qubits in a random bipartition. Reference Circuit: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.library import QuantumVolume circuit = QuantumVolume(5, 6, seed=10) circuit.draw('mpl') Expanded Circuit: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.library import QuantumVolume from qiskit.visualization.library import _generate_circuit_library_visualization circuit = QuantumVolume(5, 6, seed=10, classical_permutation=False) _generate_circuit_library_visualization(circuit.decompose()) References: [1] A. Cross et al. Validating quantum computers using randomized model circuits, Phys. Rev. A 100, 032328 (2019). `arXiv:1811.12926 `__ z2.2z?Use the function qiskit.circuit.library.quantum_volume instead.z in Qiskit 3.0)sinceadditional_msgremoval_timelineF)flattenc h>SSKnU=(d UnUS-n[U[RR5(aUO[RR U5nUn U c"[ [ URSS5SS5n [TU]%US[XU /5RSS5-S 9 U(aUbL[R"[R5Rn URU [RS 9n[!XU5n UR"U lU(aUR%U S S 9 gUR'[)U R+5[-UR.555 gUcU nU(aUO[1XR"S 9n UR2R4R7S X'-U5R9X'S S 5n [-U R.5nU H~nUR;U5nU R'[)[=U5U55 [?U5H7unn[AUSSS9nSU-nU R'[)UUUUS-55 M9 M U(d=UR'[)U R+5[-UR.555 gg)a Args: num_qubits: number of active qubits in model circuit. depth: layers of SU(4) operations in model circuit. seed: Random number generator or generator seed. classical_permutation: use classical permutations at every layer, rather than quantum. flatten: If ``False`` (the default), construct a circuit that contains a single instruction, which in turn has the actual volume structure. If ``True``, construct the volume structure directly. rNseed_seqentropyquantum_volume_ )namedtypeT)inplaceF) check_input num_qubits)! scipy.stats isinstancenprandom Generator default_rnggetattr bit_generatorsuper__init__strreplaceiinfoint64maxintegersr rcompose_appendrto_instructiontuplequbitsrstats unitary_grouprvsreshape permutationr enumerater )selfr depthseedclassical_permutationrscipywidthrng seed_name max_valueqv_circbase unitariesr5rowpermwunitarygatequbit __class__s _/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/library/quantum_volume.pyr*QuantumVolume.__init__>sA2 #a ryy':':;;dAVAVW[A\    (9(9:t LiY]^I  "S*Y)G%H%P%PQTVX%YY   !HHRXX.22 ||IRXX|>$Z=G99GL Wd 3 /0F0F0H%PTP[P[J\]^| "4z (RD 1155aLTTaI4;;'F z2 /0EvNO"+C.JAw&wEaPDEELL!3D&QR:S!TU#1! /0C0C0EuT[[GYZ[)NNT) r intr=z Optional[int]r>z)Optional[Union[int, np.random.Generator]]r?boolrrTreturnNone) __name__ __module__ __qualname____firstlineno____doc__r r*__static_attributes__ __classcell__)rNs@rOr r s!FX( $:>&* D\D\D\D\8 D\ $ D\D\ D\D\  D\rQr cB[U[RR5(aL[R"[R 5R nURU[R S9nU=(d Un[R"[XU55$)aA quantum volume model circuit. The model circuits are random instances of circuits used to measure the Quantum Volume metric, as introduced in [1]. The model circuits consist of layers of Haar random elements of SU(4) applied between corresponding pairs of qubits in a random bipartition. This function is multithreaded and will launch a thread pool with threads equal to the number of CPUs by default. You can tune the number of threads with the ``RAYON_NUM_THREADS`` environment variable. For example, setting ``RAYON_NUM_THREADS=4`` would limit the thread pool to 4 threads. Args: num_qubits: The number qubits to use for the generated circuit. depth: The number of layers for the generated circuit. If this is not specified it will default to ``num_qubits`` layers. seed: An optional RNG seed used for generating the random SU(4) matrices used in the output circuit. This can be either an integer or a numpy generator. If an integer is specfied it must be an value between 0 and 2**64 - 1. Reference Circuit: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.library import quantum_volume circuit = quantum_volume(5, 6, seed=10) circuit.draw('mpl') References: [1] A. Cross et al. Validating quantum computers using randomized model circuits, Phys. Rev. A 100, 032328 (2019). `arXiv:1811.12926 `__ r) r"r#r$r%r-r.r/r0r_from_circuit_dataqv_rs)r r=r>rDs rOr r slV$ ++,,HHRXX&** }}Ybhh}7  ZE  , ,U:d-K LLrQ)NN)r rSr=z int | Noner>z int | np.random.Generator | NonerUr)r[ __future__rtypingrrnumpyr#qiskit.circuitrr(qiskit.circuit.library.generalized_gatesrr "qiskit._accelerate.circuit_libraryr r`qiskit.utils.deprecationr r rRrQrOrhsf$""=QF3m\Nm\d-1/M/M /M +/M /MrQ