iEZSrSSKrSSKJrJrJrJr SSKJr SSK J r SSK J r SSK JrJr SSKJr SS KJr SS KJr S S KJrJrJrJr S S KJr S SKJ r S SK!J"r"J#r# S SK$J%r% S SK&J'r'J(r( S SK)J*r* \ "\5RVS:a SSK,J-r-J.r. OSSK/J-r-J.r. \R`"\15r2Sr3Sr4"SS\5r5"SS\55r6g)z3Module for interfacing with an IBM Quantum Backend.N)OptionalAnyListUniondatetime)deepcopy)Version)QuantumCircuit __version__) BackendV2Options)Target) BackendStatusBackendProperties GateConfigQasmBackendConfiguration)qiskit_runtime_service) RuntimeClient)IBMBackendApiProtocolErrorIBMBackendError)convert_to_target)properties_from_server_dataconfiguration_from_server_data) local_to_utc) MeasLevelMeasReturnTypezcircuit-runnerz qasm3-runnerc ^\rSrSrSrSrS'S\SSS\S \\ S \\ S S4 U4S jjjr S \ S \ 4U4Sjjr S(S\ S S4Sjjr\S \4Sj5r\S \\ S44Sj5r\S)Sj5r\S \4Sj5r\S*Sj5r\S \\\4Sj5r\S \4Sj5rS+S\\S \4SjjrS*Sjr S,S\ S\\S \\!4Sjjr"S \#4Sjr$S \4Sjr%S \ 4Sjr&S-Sjr'S \(S S4S!jr)S+S"\*S S4S#jjr+S*S$jr,S \ 4S%jr-S&r.U=r/$). IBMBackend<uBackend class interfacing with an IBM Quantum backend. Note: * You should not instantiate the ``IBMBackend`` class directly. Instead, use the methods provided by an :class:`QiskitRuntimeService` instance to retrieve and handle backends. This class represents an IBM Quantum backend. Its attributes and methods provide information about the backend. For example, the :meth:`status()` method returns a :class:`BackendStatus<~.providers.models.BackendStatus>` instance. The instance contains the ``operational`` and ``pending_jobs`` attributes, which state whether the backend is operational and also the number of jobs in the server queue for the backend, respectively:: status = backend.status() is_operational = status.operational jobs_in_queue = status.pending_jobs Here is list of attributes available on the ``IBMBackend`` class: * name: backend name. * backend_version: backend version in the form X.Y.Z. * num_qubits: number of qubits. * target: A :class:`qiskit.transpiler.Target` object for the backend. * basis_gates: list of basis gates names on the backend. * gates: list of basis gates on the backend. * local: backend is local or remote. * simulator: backend is a simulator. * conditional: backend supports conditional operations. * open_pulse: backend supports open pulse. * memory: backend supports memory. * coupling_map (list): The coupling map for the device * supported_instructions (List[str]): Instructions supported by the backend. * dynamic_reprate_enabled (bool): whether delay between primitives can be set dynamically (ie via ``rep_delay``). Defaults to False. * rep_delay_range (List[float]): 2d list defining supported range of repetition delays for backend in μs. First entry is lower end of the range, second entry is higher end of the range. Optional, but will be specified when ``dynamic_reprate_enabled=True``. * default_rep_delay (float): Value of ``rep_delay`` if not specified by user and ``dynamic_reprate_enabled=True``. * n_uchannels: Number of u-channels. * u_channel_lo: U-channel relationship on device los. * meas_levels: Supported measurement levels. * qubit_lo_range: Qubit lo ranges for each qubit with form (min, max) in GHz. * meas_lo_range: Measurement lo ranges for each qubit with form (min, max) in GHz. * dt: Qubit drive channel timestep in nanoseconds. * dtm: Measurement drive channel timestep in nanoseconds. * rep_times: Supported repetition times (program execution time) for backend in μs. * meas_kernels: Supported measurement kernels. * discriminators: Supported discriminators. * hamiltonian: An optional dictionary with fields characterizing the system hamiltonian. * channel_bandwidth (list): Bandwidth of all channels (qubit, measurement, and U) * acquisition_latency (list): Array of dimension n_qubits x n_registers. Latency (in units of dt) to write a measurement result from qubit n into register slot m. * conditional_latency (list): Array of dimension n_channels [d->u->m] x n_registers. Latency (in units of dt) to do a conditional operation on channel n from register slot m * meas_map (list): Grouping of measurement which are multiplexed * sample_name (str): Sample name for the backend * n_registers (int): Number of register slots available for feedback (if conditional is True) * register_map (list): An array of dimension n_qubits X n_registers that specifies whether a qubit can store a measurement in a certain register slot. * configurable (bool): True if the backend is configurable, if the backend is a simulator * credits_required (bool): True if backend requires credits to run a job. * online_date (datetime): The date that the device went online * display_name (str): Alternate name field for the backend * description (str): A description for the backend * tags (list): A list of string tags to describe the backend * version: version of ``Backend`` class (Ex: 1, 2) * channels: An optional dictionary containing information of each channel -- their purpose, type, and qubits operated on. * parametric_pulses (list): A list of pulse shapes which are supported on the backend. For example: ``['gaussian', 'constant']`` * processor_type (dict): Processor type for this backend. A dictionary of the form ``{"family": , "revision": , segment: }`` such as ``{"family": "Canary", "revision": "1.0", segment: "A"}``. * family: Processor family of this backend. * revision: Revision version of this processor. * segment: Segment this processor belongs to within a larger chip. FN configurationservice+qiskit_runtime_service.QiskitRuntimeService api_clientinstancecalibration_idreturnc>[TU]URURURS9 XPlX@lX lX0l[U5Ul SUl SUl URR(d[URS5(ae[URS5(aJURR!S[#S55 URR!S[#S55 [US5(a9URR!SUR$SUR$S45 gg) zIBMBackend constructor. Args: configuration: Backend configuration. service: Instance of QiskitRuntimeService. api_client: IBM client used to communicate with the server. calibration_id: An optional calibration id to use for this backend )name online_datebackend_versionN noise_modelseed_simulatorrep_delay_range rep_delayrr)super__init__ backend_namer-r._calibration_id _instance_service _api_clientr _configuration _properties_target simulatorhasattroptions set_validatortyper1)selfr$r%r'r(r) __class__s X/home/james-whalen/.local/lib/python3.13/site-packages/qiskit_ibm_runtime/ibm_backend.pyr4IBMBackend.__init__s ++%11)99  .! %&}5 $  ##-- m44 &677 LL & &}d4j A LL & &'7d D ="3 4 4 LL & &..q1=3P3PQR3ST  5r,c>US;a/[SRURRU55eUR 5 UR 5 [ TU]U5$![a Of=fURRU5$![a0 [SRURRU55ef=f)zGets attribute from self or configuration This magic method executes when user accesses an attribute that does not yet exist on IBMBackend class. )r;r<r:z!'{}' object has no attribute '{}') AttributeErrorformatrC__name__ properties_convert_to_targetr3__getattribute__r:)rBr,rCs rD __getattr__IBMBackend.__getattr__s ? ? 3::4>>;R;RTXY   ! 7+D1 1    &&77= =  3::4>>;R;RTXY  sA'' A43A48B:C refreshc|U(dUR(d$[URURS9Ulgg)z>Converts backend configuration and properties to Target objectr$rKN)r<rr:r;)rBrPs rDrLIBMBackend._convert_to_targets. $,,,"11++DL'rFcd[SS[R[RSSSSSSSSSS9 $)Default runtime options.FNdT) shotsmemory meas_level meas_return memory_slotsmemory_slot_sizerep_timer2 init_qubitsuse_measure_espuse_fractional_gatesr/r0)rr CLASSIFIEDr AVERAGEclss rD_default_optionsIBMBackend._default_optionssD ++&..  !&  rFcUR$)z)The calibration id used for this backend.)r6rBs rDr)IBMBackend.calibration_ids###rFcUR$)zVReturn the ``service`` object Returns: service: instance of QiskitRuntimeService )r8ris rDr%IBMBackend.services}}rFc.URR$)znReturn the system time resolution of output signals Returns: dtm: The output signal timestep in seconds. )r:dtmris rDrnIBMBackend.dtm s""&&&rFcg)zThis property used to return the `max_experiments` value from the backend configuration but this value is no longer an accurate representation of backend circuit limits. New fields will be added to indicate new limits. Nris rD max_circuitsIBMBackend.max_circuitssrFc.URR$)zReturn the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling. Returns: meas_map: The grouping of measurements which are multiplexed )r:meas_mapris rDruIBMBackend.meas_maps""+++rFcZUR5 UR5 UR$)zQA :class:`qiskit.transpiler.Target` object for the backend. Returns: Target )rKrLr<ris rDtargetIBMBackend.target's$  !||rFrcD[URURUS9S9$)zuA :class:`qiskit.transpiler.Target` object for the backend. Returns: Target with properties found on `datetime` rrR)rr:rK)rBrs rDtarget_historyIBMBackend.target_history2s(!--9  rFc8[URRUR5R UR SUR S9URURRS9=n(aXl URSS9 URSS9 g)zQRetrieve the newest backend configuration and refresh the current backend target.T)rPr)) raw_configr(ra)rPN) rr8_get_api_clientr7backend_configurationr,r)r?rar:rKrL)rBconfigs rDrPIBMBackend.refresh>s3}}44T^^DZZ 48K8K[^^!%!B!B   6 #)  % -rFc$URR(ag[U[5(d$[ SR U[ U555eU(a+[U[5(d [ S5e[U5nU(dU(d URccURRURX RS9nU(dg[UURR S9nU(aU$X@l UR$)a Return the backend properties, subject to optional filtering. This data describes qubits properties (such as T1 and T2), gates properties (such as gate length and error), and other general properties of the backend. The schema for backend properties can be found in `Qiskit/ibm-quantum-schemas/backend_properties `_. Args: refresh: If ``True``, re-query the server for the backend properties. Otherwise, return a cached version. datetime: By specifying `datetime`, this function returns an instance of the :class:`BackendProperties<~.providers.models.BackendProperties>` whose timestamp is closest to, but older than, the specified `datetime`. Returns: The backend properties or ``None`` if the backend properties are not currently available. Raises: TypeError: If an input argument is not of the correct type. NotImplementedError: If `datetime` is specified when cloud runtime is used. Nz>The 'refresh' argument needs to be a boolean. {} is of type {}z'{}' is not of type 'datetime'.)rr))ra)r:r= isinstancebool TypeErrorrIrApython_datetimerr;r9backend_propertiesr,r)rr?ra)rBrPrapi_propertiesrs rDrKIBMBackend.propertiesKs:    ( ('4((##)6'4=#A  h88 ABB#H-H w$"2"2":!--@@ H=P=PAN"!<%)\\%F%F" ))1 rFcURRUR5n[R"U5$![ a)n[ SR[U555UeSnAff=f)asReturn the backend status. Note: If the returned :class:`~.providers.models.BackendStatus` instance has ``operational=True`` but ``status_msg="internal"``, then the backend is accepting jobs but not processing them. Returns: The status of the backend. Raises: IBMBackendApiProtocolError: If the status for the backend cannot be formatted properly. zPUnexpected return value received from the server when getting backend status: {}N) r9backend_statusr,r from_dictrrrIstr)rB api_statusexs rDstatusIBMBackend.statussh%%44TYY?   **:6 6 ,--3VCG_  s= A0$A++A0cUR$)aReturn the backend configuration. Backend configuration contains fixed information about the backend, such as its name, number of qubits, basis gates, coupling map, quantum volume, etc. The schema for backend configuration can be found in `Qiskit/ibm-quantum-schemas/backend_configuration `_. More details about backend configuration properties can be found here `QasmBackendConfiguration `_. IBM backends may also include the following properties: * ``supported_features``: a list of strings of supported features like "qasm3" for dynamic circuits support. * ``parallel_compilation``: a boolean of whether or not the backend can process multiple jobs at once. Parts of the classical computation will be parallelized. Returns: The configuration for the backend. )r:ris rDr$IBMBackend.configurations0"""rFcbSRURRUR5$)Nz <{}('{}')>)rIrCrJr,ris rD__repr__IBMBackend.__repr__s#""4>>#:#:DIIFFrFcU$Nrqris rD__call__IBMBackend.__call__s rFcircuitc ^UR5(dgUR5R5nUR5R5nUVs/sH3n[UR5S:dM[ UR5PM5 nnTR HnURRS:XaM[ U4SjUR55nUH'nX;dM [STRSUSUS35e [U5S :XdM|Xu;dM[STRSUS U35e gs snf) zCheck if the input circuit uses faulty qubits or edges. Args: circuit: Circuit to check. Raises: ValueError: If an instruction operating on a faulty qubit or edge is found. Nrbarrierc3Z># UH nTRU5Rv M" g7fr)find_bitindex).0xrs rD *IBMBackend.check_faulty..s"!R\'"2"21"5";";\s(+zCircuit z contains instruction z operating on a faulty qubit .rz operating on a faulty edge ) rK faulty_qubits faulty_gateslenqubitstupledata operationr, ValueError) rBrrrgate faulty_edgesinstr qubit_indices circ_qubits ` rD check_faultyIBMBackend.check_faultys-  )779 (557 7C\|ts4;;GWZ[G[*dkk*| \\\E##y0!!RU\\!RRM+ .$"7<<.0F '!>zl!M,=!Q&=+H w||n,Bg9-J"]s E9E_memoc[[UR55UR[UR5UR S9nUR UlURUlURUlURUl URUl [URU5Ul [URU5Ul U$)N)r$r%r'r() r"r r$r8r9r7r, descriptionr-r. _coupling_mapr<_options)rBrcpys rD __deepcopy__IBMBackend.__deepcopy__s"4#5#5#78MM 0 01^^   99****"22 ..t||U3  u5  rFc[S5e)zH Raises: IBMBackendError: The run() method is no longer supported. zSupport for backend.run() has been removed. Please see our migration guide https://quantum.cloud.ibm.com/docs/migration-guides/qiskit-runtime for instructions on how to migrate to the primitives interface.)r)rBargskwargss rDrunIBMBackend.runs  =  rFc<URR(dgg)zBReturn the default translation stage plugin name for IBM backends.ibm_dynamic_circuitsibm_dynamic_and_fractional)r?raris rDget_translation_stage_plugin'IBMBackend.get_translation_stage_plugins||00)+rF)r9r6r:r7r;r8r<)NN)F)r*r&)r*NrFN)r*r")0rJ __module__ __qualname____firstlineno____doc__id_warning_issuedrrrrr4rrNrrL classmethodrrfpropertyrr)r%floatrnrrrintrurrxrr{rPrrKrrr$rrr rdictrrr__static_attributes__ __classcell__rCs@rDr"r"<sXt#'(, '/'?'" ' 3- ' ! ' ''R:$4   &$c4i 0$$'U'' ,$tCy/ , ,  x'@  F   .LP6 6 /7/H6 # $6 p 0# !#4G#G N t D$,  ,c,,rFr"c ^\rSrSrSrSS\SSS\\SS4U4S jjjr\ S\ 4S j5r SS \ S \\ SS4S jjrS\4Sjr\ SS\S\\SS4Sjj5rSrU=r$)IBMRetiredBackendizIBackend class interfacing with an IBM Quantum device no longer available.Nr$r%r&r'r*c>[TU]XU5 [URUR 5R SSSS9Ulg)zIBMRetiredBackend constructor. Args: configuration: Backend configuration. service: Instance of QiskitRuntimeService. api_client: IBM Quantum client used to communicate with the server. Frz$This backend is no longer available.)r5r. operational pending_jobs status_msgN)r3r4rr,r$r._status)rBr$r%r'rCs rDr4IBMRetiredBackend.__init__sB <$ ..0@@=   rFc[SS9$)rUrV)rXrrds rDrf"IBMRetiredBackend._default_optionssT""rFrPrcg)zReturn the backend properties.Nrq)rBrPrs rDrKIBMRetiredBackend.propertiessrFcUR$)zReturn the backend status.rris rDrIBMRetiredBackend.status#s ||rFr5apicT[USSS/SSSSS[S/SS9/SS//S9 nU"X25$) z'Return a retired backend from its name.z0.0.0z2019-10-16T04:00:00ZrFTODO)r, parametersqasm_defr) r5r.r-n_qubits basis_gatesr=local conditional open_pulserYgates coupling_map)rr)rer5rr$s rD from_nameIBMRetiredBackend.from_name'sQ1%#.6b6JKa&  =&&rFrrr)rJrrrrrrrr4rrrfrrrKrrrrrrrs@rDrrsS /3  / ? ]+     ,###$(?:S_c (,''m $'  ''rFr)7rloggingtypingrrrrrrcopyr packaging.versionr qiskitr r qiskit_versionqiskit.providers.backendr Backendqiskit.providers.optionsrqiskit.transpiler.targetrmodelsrrrrr api.clientsr exceptionsrrutils.backend_converterrutils.backend_decoderrrutilsrmajor qiskit.resultrr qiskit.qobj.utils getLoggerrJloggerQOBJRUNNERPROGRAMIDQASM3RUNNERPROGRAMIDr"rrqrFrDr s:--0%@9,+%&7  >  A%77;   8 $&%B,B,J;' ;'rF