gdZddlmZddlmZmZddlZddlm Z m Z ddl m Z m Z ddlmZGdd e Z dddZdS)zQuantum Volume model circuit.) annotations)OptionalUnionN)QuantumCircuitCircuitInstruction)PermutationGate UnitaryGate)quantum_volumec2eZdZdZ ddddfdZxZS) QuantumVolumeaA 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 `_] NTF)flatten num_qubitsintdepth Optional[int]seed)Optional[Union[int, np.random.Generator]]classical_permutationboolr returnNonec ddl}|p|}|dz}t|tjjr|ntj|}|} | %t t |jdddd} t |dt||| g ddz |r|Dtj tj j} || tj }t!|||} |j| _|r|| d dS|t)| t-|jdS|| }|r|nt1||j } |jjd ||z|||d d } t-| j}| D]}||}| t)t=||t?|D]J\}}tA|dd}d|z}| t)||||dzK|sI|t)| t-|jdSdS)axCreate quantum volume model circuit of size num_qubits x depth. 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_inputr)! scipy.stats isinstancenprandom Generator default_rnggetattr bit_generatorsuper__init__strreplaceiinfoint64maxintegersr rcompose_appendrto_instructiontuplequbitsrstats unitary_grouprvsreshape permutationr enumerater )selfrrrrr scipywidthrng seed_name max_valueqv_circbase unitariesr9rowpermwunitarygatequbit __class__s [/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/quantum_volume.pyr.zQuantumVolume.__init__=s* #a ry':;;\ddAVAVW[A\A\    (9:t L LiY]^^I  "S*eY)G%H%H%P%PQTVX%Y%YY     ! \HRX..2 ||IRX|>>$Z==G9GL _ Wd 33333 /0F0F0H0H%PTP[J\J\]]^^^^^| "R44z (R(R(RD 155aLLTTuaI4;''F  V Vz22 /0E0EvNNOOO"+C..VVJAw&wEaPPPDEELL!3D&QRAR:S!T!TUUUUV \ /0C0C0E0EuT[GYGYZZ[[[[[ \ \)NNT) rrrrrrrrr rrr)__name__ __module__ __qualname____doc__r. __classcell__)rOs@rPr r s!!L $:>&* E\E\E\E\E\E\E\E\E\E\E\E\E\rQr rrr int | Noner int | np.random.Generator | Nonerrct|tjjr!|dtj}|p|}t jt|||S)a.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. 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. **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 `__ rr ) r&r'r(r)r4uint64r_from_circuit_dataqv_rs)rrrs rPr r sZD$ +,,1}}Qbi}00  ZE  ,U:ud-K-K L LLrQ)NN)rrrrWrrXrr)rU __future__rtypingrrnumpyr'qiskit.circuitrr(qiskit.circuit.library.generalized_gatesrr "qiskit._accelerate.circuit_libraryr r\r rQrPrds$#""""""""""""""========QQQQQQQQFFFFFFi\i\i\i\i\Ni\i\i\\-1%M%M%M%M%M%M%MrQ