z ij*SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKJ r SSK r SSK J r SSKJr SSKJrJr SSKJr SS KJr SS KJr SS KJr S S KJr S SKJr S SKJrJ r J!r!J"r" S SKJ#r# S SK$J%r% \RL"\'5r("SS\5r)g)aContains a (slow) Python simulator. It simulates a quantum circuit (an experiment) that has been compiled to run on the simulator. It is exponential in the number of qubits. The simulator is run using .. plot:: :include-source: :nofigs: BasicSimulator().run(run_input) Where the input is a :class:`.QuantumCircuit` object and the output is a :class:`.BasicProviderJob` object, which can later be queried for the Result object. The result will contain a 'memory' data field, which is a result of measurements for each shot. ) annotationsN)Counter)QuantumCircuit) UnitaryGate)get_standard_gate_name_mappingGlobalPhaseGate) BackendV2Options)Result)Target)BasicProviderJob)single_gate_matrix)SINGLE_QUBIT_GATESTWO_QUBIT_GATESTWO_QUBIT_GATES_WITH_PARAMETERSTHREE_QUBIT_GATES)einsum_vecmul_index)BasicProviderErrorc"^\rSrSrSrSrSSU4Sjjjr\SSj5r\SSj5r SSjr \ SSj5r SS jr SS jrSS jrSS jrS S jrSSjrS!S"SjjrSSjrS#SjrS$SjrS%SjrS&SjrS'SjrSrU=r$)(BasicSimulatorAzCPython implementation of a basic (non-efficient) quantum simulator.c >[TU]"S USSSS.UD6 X lSUlSUlSUlSUlSUlSUlURRS5Ul URRS 5Ul URRS 5Ul URRS 5Ulg) a^ Args: provider: An optional backwards reference to the provider object that the backend is from. target: An optional target to configure the simulator. fields: kwargs for the values to use to override the default options. Raises: AttributeError: If a field is specified that's outside the backend's options. basic_simulatorz0A Python simulator for basic quantum experimentsz0.1)providername descriptionbackend_versionrNFshotsmemoryinitial_statevectorseed_simulator)super__init___target_classical_memory _statevector_number_of_cmembits_number_of_qubits _local_rng_sample_measureoptionsget_shots_memory_initial_statevector_seed_simulator)selfrtargetfields __class__s i/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/providers/basic_provider/basic_simulator.pyr'BasicSimulator.__init__Is&  "J!     "##$ !"$ll&&w/ ||''1 $(LL$4$45J$K!#||//0@AcgNr%r5s r9 max_circuitsBasicSimulator.max_circuitsrsr;cfUR(dUR5UlUR$r=)r(_build_basic_targetr>s r9r6BasicSimulator.targetvs#||335DL||r;c[SSS9n/SQn[5nUHGnXC;aX4nURUSUS9 MUS:XaUR[SS9 M;[ SU35e U$) zHelper method that returns a minimal target with a basis gate set but no coupling map or instruction properties. Returns: The configured target. z Basic TargetN)r num_qubits)5ccxcczchcpcrxcrycrzcscsdgcswapcsxcucu1cu3cxcyczdcxdelayecr global_phasehidiswapmeasureprrccxresetrxrxxryryyrzrzxrzzssdgswapsxsxdgttdguu1u2u3unitaryx xx_minus_yy xx_plus_yyyz) propertiesrru)rz3Gate is not a valid basis gate for this simulator: )r radd_instructionrr)r5r6 basis_gates inst_mappingr instructions r9rB"BasicSimulator._build_basic_target|s& 6 n67 D#*0 &&{t$&O"&&{&C(I$P  r;c[SSSSS9$)NiT)r!r"r#r$r )clss r9_default_optionsBasicSimulator._default_optionss $   r;c[U5n[X R5n[R"[R "U[ S9USS/-5n[R"XEUR[ SS9Ulg)zApply an N-qubit unitary matrix. Args: gate (matrix_like): an N-qubit unitary matrix qubits (list): the list of N-qubits. dtypeno)rcastingN) lenrr,npreshapearraycomplexeinsumr*)r5gatequbitsrEindexes gate_tensors r9 _add_unitaryBasicSimulator._add_unitarysb[ %f.D.DEjj$g!> aQRV@ST II $"3"37D r;c^[[UR55nURURS- U- 5 [R "[R "UR5S-[U5S9nURR5nXCS:aSUS4$SUS4$)zSimulate the outcome of measurement of a qubit. Args: qubit: index indicating the qubit to measure Return: pair (outcome, probability) where outcome is '0' or '1' and probability is the probability of the returned outcome. rraxisr01) listranger,removersumabsr*tupler-random)r5qubitr probabilities random_numbers r9_get_measure_outcome#BasicSimulator._get_measure_outcomesE$0012 D**Q.67rvvd&7&78A=E$KP ..0 + + a(( (M!$$$r;c [UVVs1sHup4UiM snn5n[U5n[[UR55n[ U5H$nUR URS- U- 5 M& [R"[R"[R"UR5S-[U5S9SU-5nURR[SU-5X(S9n /n U Hn URn UH:up=UR!U5n[#U SU--U- 5nSU -nU U)-X--n M< [%U 5SSnU R'[)[#US555 M U $s snnf)aGenerate memory samples from current statevector. Args: measure_params: List of (qubit, cmembit) values for measure instructions to sample. num_samples: The number of memory samples to generate. Returns: A list of memory values in hex format. rrr)r_N)sortedrrrr,reversedrrrrrr*rr-choicer)indexintbinappendhex)r5measure_params num_samplesr_measured_qubits num_measuredrrsamplesr"sampleclassical_memorycmembitpos qubit_outcomemembitvalues r9_add_sample_measure"BasicSimulator._add_sample_measuresr!!GHE%!GH?+ E$0012o.E KK..2U: ;/ FF266$++,1d Dao //((q,)?(^F#55 "0%++E2 #VqCx%8S$@ A g$4$@]E]#^ #1 ()!"-E MM#c%m, - 9"HsF c*URU5up4SU-nURU)-[U5U--UlUS:Xa S[R"U5- S/SS//nOSS/SS[R"U5- //nUR Xa/5 g)zApply a measure instruction to a qubit. Args: qubit: index of the qubit measured. cmembit: index of the classical memory bit to store outcome in. rrrN)rr)rmathsqrtr)r5rroutcome probabilityr update_diags r9 _add_measureBasicSimulator._add_measure/s $88?g"&"8"8VG"DWY`I`!a c> + 66:QFCKq6Aq499[+A'A#BCK +w/r;cURU5up#US:Xa2S[R"U5- S/SS//nURXA/5 gSS[R"U5- /SS//nURXA/5 g)zApply a reset instruction to a qubit. Args: qubit: the qubit being rest This is done by doing a simulating a measurement outcome and projecting onto the outcome state while renormalizing. rrrN)rrrr)r5rrrupdates r9 _add_resetBasicSimulator._add_resetDs $88? c>499[11151v>F   fg .!dii 4451v>F   fg .r;cURcg[UR5nSUR-nX:wa[SUSU35eg)zValidate an initial statevectorNrz)initial statevector is incorrect length: z != )r3rr,r)r5length required_dims r9_validate_initial_statevector,BasicSimulator._validate_initial_statevectorXs[  $ $ , T../$000  !$;F84 ~V  "r;c0URRS5UlURRS5UlURRS5UlURRS5UlURSS5b![ R"US[S9UlURbH[ RRUR5n[US5S:wa[S US 35eSU;a USUlSU;a USUlO0UR c#[ RRS S S9UlSU;a USUl[ RRUR S 9Ulg)z,Set the backend run options for all circuitsr!r"r#r$Nr rz,Initial statevector is not normalized: norm z != 1iint32)seed)r/r0r1r2r3r4rrrlinalgnormroundrrrandint default_rngr-)r5 run_optionsrs r9_set_run_optionsBasicSimulator._set_run_optionses_ll&&w/ ||''1 $(LL$4$45J$K!#||//0@A ??0$ 7 C(*=R1S[b(cD %  $ $ 099>>$";";s r9_initialize_statevector&BasicSimulator._initialize_statevectors{  $ $ , "D,B,B)B' RD #$D  a $ 9 9 > > @D JJt'8'8$:P:PTUSV:VWr;cSnURS:abURHRnURS:Xa SUl gU(aURS;a SUl gM>URS:XdMPSnMT X lg)z:Determine if measure sampling is allowed for an experimentFrrbN)r^barrierr\u0r^T)r1datarr.)r5circuit measure_flagrs r9_validate_measure_sampling)BasicSimulator._validate_measure_samplings  ;;?&|| ##w.+0D( #''/QQ/4,R!%%2#'L , ,r;c J0nUR5HDupE[URU5(d [R"SUS3[ SS9 M@XSU'MF UR US9 [[R"55n[XURXa55nU$)aqRun on the backend. Args: run_input (QuantumCircuit or list): the QuantumCircuit (or list of QuantumCircuit objects) to run run_options (kwargs): additional runtime backend options Returns: BasicProviderJob: derived from BaseJob Additional Information: * kwarg options specified in ``run_options`` will temporarily override any set options of the same name for the current run. These may include: * "initial_statevector": vector-like. The "initial_statevector" option specifies a custom initial statevector to be used instead of the all-zero state. The size of this vector must correspond to the number of qubits in the ``run_input`` argument. * "seed_simulator": int. This is the internal seed for sample generation. * "shots": int. Number of shots used in the simulation. * "memory": bool. If True, the result will contain the results of every individual shot simulation. Example:: backend.run( circuit_2q, initial_statevector = np.array([1, 0, 0, 1j]) / math.sqrt(2) ) zOption z is not used by this backendr) stacklevel)r) itemshasattrr/warningswarn UserWarningrstruuiduuid4r_run_job)r5 run_inputr out_optionskeyrjob_idjobs r9runBasicSimulator.runsJ %++-JC4<<-- cU">?YZ$)C . +6TZZ\"tT]]6-MN r;cj[U[5(aU/nURU5 /n[R"5nUH#nUR UR U55 M% [R"5nUR URUUSSXd- S.n[R"U5$)zRun circuits in run_input. Args: job_id: unique id for the job. run_input: circuits to be run. Returns: Result object COMPLETEDT) backend_namer rresultsstatussuccess time_taken) isinstancer _validatetimer _run_circuitrr r from_dict)r5rr result_liststartrendresults r9rBasicSimulator._run_jobs i 0 0" I y!   G   t009 :!iik II#33"!; ''r;c l[R"5nURUlURUlSUlSUlUR5 URU5 /nUR(aSn/nO URn[U5GH5nUR5 U=R [R"SUR-5-slSUlUR GHTnUR"S:Xa`UR$Vs/sHoR'U5R(PM n nUR*R,Sn UR/X5 MtUR"S;aMUR"S:Xa7[1USS5n [3U 6R55n UR/U /5 MUR"[6;ap[1USS5n UR$Vs/sHoR'U5R(PM snSn [9UR"U 5n UR/X/5 GMQUR"[:;a[1USS5n UR$Vs/sHoR'U5R(PM n nU Sn U Sn[:UR""U 6R55n UR/XU/5 GMUR"S ;aGMUR"[<;agUR$Vs/sHoR'U5R(PM n nU Sn U Sn[<UR"n UR/XU/5 GMxUR"[>;alUR$Vs/sHoR'U5R(PM n nU Sn U SnU S n[>UR"n UR/XX/5 GMUR"S :XaMUR$Vs/sHoR'U5R(PM n nU Sn URAU 5 GMUUR"S :XaGMhUR"S :XaUR$Vs/sHoR'U5R(PM snSn URBVs/sHoR'U5R(PM snSnUR(aWREU U45 GMURGU U5 GM$UR"nSn[IURKUUR"55e URS:dGMUR(aURMWUR5nGM[OUR 5S SnURE[Q[SUS 555 GM8 S[U[WU550nURX(aUUS'[R"5nUR"URURZVs/sHnUR"UR\/PM snUR^Vs/sHnUR"UR\/PM snURZVVs/sH.n[UR\5HnUR"U/PM M0 snnUR^VVs/sH.n[UR\5HnUR"U/PM M0 snnURURUR`b UR`O0S. nUR"URbURUSSUUU- S.$s snfs snfs snfs snfs snfs snfs snfs snfs snfs snfs snnfs snnf)aSimulate a single circuit run. Args: circuit: circuit to be run. Returns: A result dictionary which looks something like:: { "name": name of this experiment "seed": random seed used for simulation "shots": number of shots used in the simulation "header": { "name": "circuit-206", "n_qubits": 3, "qreg_sizes": [['qr', 3]], "creg_sizes": [['cr', 3]], "qubit_labels": [['qr', 0], ['qr', 1], ['qr', 2]], "clbit_labels": [['cr', 0], ['cr', 1], ['cr', 2]], "memory_slots": 3, "global_phase": 0.0, "metadata": {}, } "data": { "counts": {'0x9: 5, ...}, "memory": ['0x9', '0xF', '0x1D', ..., '0x9'] }, "status": status string for the simulation "success": boolean "time_taken": simulation time of this single experiment } Raises: BasicProviderError: if an error occurred. rry?ru)r\rrXrZparamsN)r\rrrbrr^z,{0} encountered unrecognized operation "{1}"countsr") rn_qubits qreg_sizes creg_sizes qubit_labels clbit_labels memory_slotsrZmetadataDONET)rr$r!rrrheaderr)2rrEr, num_clbitsr+r*r)rrr.r1rrrexprZrrrfind_bitr operationrrgetattrr to_matrixrrrrrrclbitsrrrformatrrrrdictrr2qregssizecregsrr4)r5rr r"r!measure_sample_opsrrbitrrrrqubit0qubit1qubit2rbackenderr_msgrrr qregcregjrs r9rBasicSimulator._run_circuitsuF !(!3!3#*#5#5 !" **, ''0   E"$ KKEuA  ( ( *   W-A-A(A!B B %&D "$\\ >>Y.ENEUEUVEUc..s399EUFV$..55a8D%%d3^^'<<^^~5$Y$?F*F3==?D%%dB/^^'99$Y$?FDMDTDTUDTS--c288DTUVWXE-innfED%%dG4^^'FF$Y$?FENEUEUVEUc..s399EUFV#AYF#AYF:9>>JFS]]_D%%dV,<=^^|3^^6ENEUEUVEUc..s399EUFV#AYF#AYF*9>>:D%%dV,<=^^'88ENEUEUVEUc..s399EUFV#AYF#AYF#AYF,Y^^EmmLmdDIItyy1mL>EmmLmdDIItyy1mL8? ` uUYU^U^O_!dii^O_^ `8? ` uUYU^U^O_!dii^O_^ `#..#00,3,<,<,H((b  LL"22[[;  wWV WW WWVWDML``sH$]8/$]=3$^$^ $^  $^9$^1$^5"^ '"^% 5^*!5^0c URnUHnURU:a)[SURSUSURS35eURn[ UR 5S:Xa[ RSU5 MySURVs/sHoURPM sn;dM[ RSU5 M g s snf) z"Semantic validations of the input.zNumber of qubits z is greater than maximum (z) for "z".rz=No classical registers in circuit "%s", counts will be empty.r^zJNo measurements in circuit "%s", classical register will remain all zeros.N) MAX_QUBITS_MEMORYrErrrr$loggerwarningr)r5r max_qubitsrrops r9rBasicSimulator._validates++  G!!J.('(:(:';;UV`Uab II;b*<0 0d(>i Vr;r)*r= __future__rrrrloggingr collectionsrnumpyrqiskit.circuitrqiskit.circuit.libraryr%qiskit.circuit.library.standard_gatesrrqiskit.providers.backendr qiskit.providers.optionsr qiskit.resultr qiskit.transpilerr basic_provider_jobrbasic_provider_toolsrrrrrr exceptionsr getLoggerr9r2rr%r;r9rQso&# ).a., $04 6*   8 $t Yt r;