iSrSSKrSSKrSSKJr SSKJrJrJrJrJ r J r J r J r J r SSKJr SSKJr SSKJr SSKJr S S KJr S S KJr S S KJr S S KJrJrJ r J!r!J"r" S SK#J$r$ S SK%J&r& S SK'J(r( S SK)J*r* S SK)J+r+J,r,J-r- S SK.J/r/ S SK0J1r1 S SKJ2r2 S SK3J4r4 S SK5J6r6 S SKJ7r7 S SK8J9r9 \Rt"\;5rg)zQiskit runtime service.N)datetime) DictCallableOptionalUnionListAnyTypeSequenceTuple) BackendV2)QiskitBackendNotFoundError)filter_backends) ibm_backend)ProxyConfiguration)is_crn)configuration_from_server_data)AccountManagerAccount ChannelType RegionTypePlanType) VersionClient) RuntimeClient)RequestsApiError)IBMInputValueError)IBMRuntimeErrorRuntimeProgramNotFoundRuntimeJobNotFound) ResultDecoder) RuntimeJobV2)validate_job_tags)ClientParameters)RuntimeOptions) IBMBackend)QasmBackendConfigurationruntimec ^\rSrSrSrU4SjrSRS\\S\\S\\S\\S \\S \\S \\ S \\ S \\ S\\ \\\\ \/\4S\\S\\ \S\\ \SS4U4Sjjjr S \S\ \4SjrS \S\4SjrSSSjrSTS\\S\\S \\S\\S\\S \\S \\S \\ S\4SjjrS\S \S\4Sjr\S\S\\\\ \444Sj5rSUS \\S\4SjjrS\ \\44SjrSVSSS.S \\S \\S \\S!\\ S"\\ S#/\ 4S$\\ S%\\S&\S\ S#4S'jjjrS \\S\ \ \\ \44S(jr!S \SS4S)jr"SUS*\S \\S$\\ S%\\S\#4 S+jjr$S\\\\44S,jr%\SWS\\S \\S\\S\ 4S-jj5r&\SXS\\S\\S \\S\\S\\S \\S \\ S \\ S.\\ S/\\ S \\ S\\'S\\(S\\ \SS4S0jj5r)\SYS1\\ S\\S\\S \\S\ 4 S2jj5r*SZS \S \\S$\\ S%\\S\+4 S3jjr,S[S4\S5\S6\\\-\4S7\\\.\/\0\.\/4S8\\S9\\ S%\\S\14S:jjr2S;\S\14S<jr3S\S=\\S>\S*\\S?\ S4\S \\S@\\ \S8\\SA\\4SB\\4SC\ S\ \14SDjjr5S;\SS4SEjr6S\\\44SFjr7SG\S\14SHjr8SSSIjr9SWS \\S \\S"\\ S#/\ 4S&\S\:RF4 SJjjr;S\0\\\44SKjrS\4SMj5r?S\4SNjr@SO\S\ 4SPjrASQrBU=rC$)]QiskitRuntimeService0z6Class for interacting with the Qiskit Runtime service.c|>URSS5nUS:XaSSKJn [TU]U5$[TU]U5$)Nchannellocalr)QiskitRuntimeLocalService)getfake_provider.local_servicer/super__new__)clsargskwargsr-r/ __class__s c/home/james-whalen/.local/lib/python3.13/site-packages/qiskit_ibm_runtime/qiskit_runtime_service.pyr3QiskitRuntimeService.__new__3s=**Y- g  N7?#<= =7?3' 'Nr-tokenurlfilenamenameinstanceproxiesverifyprivate_endpoint url_resolverregionplans_preferencetagsreturnc >[TU]5 /Ul/UlUR UUUUUUU(a [ S0UD6OSUS9UlU bXR l[UR RUR RUR RUR RUR RUR RUR RU S9UlUR RUlXl0UlSUl[)UR5Ul/Ul/UlU =(d UR R0UlU =(d UR R4UlU =(d UR R8UlUR R(aUR RUR=5Vs/sHoSPM sn;a#[?SUR RS35eSUlUR R[)UR50Ul g0Ul URCU5nUR.Vs/sHofRES 5PM nnUR.Vs1sHofRES 5iM nnUR:(aS RGUR:5OS nUR2(a UR2OS nUR6(a"S RGUR65nSUS3nOS RGU5nSUS3nSUSUU3n[HRKSUR6(aSOSUS RGU55 UHunnURMU5 M gs snfs snfs snf)aQiskitRuntimeService constructor. Recommended uses: * Direct instantiation: .. code-block:: python from qiskit_ibm_runtime import QiskitRuntimeService service = QiskitRuntimeService( channel="ibm_quantum_platform", token="API_KEY", instance="CRN" ) * Saving default acccount: .. code-block:: python from qiskit_ibm_runtime import QiskitRuntimeService QiskitRuntimeService.save_account( token="API_KEY", instance="CRN", set_as_default = True ) service = QiskitRuntimeService() The minimum required information for service authentication to a non-local channel is the ``token``. The ``local`` channel doesn't require authentication. For non-local channels, it is recommended to always provide the relevant ``instance`` to minimize API calls. If an ``instance`` is not defined, the service will fetch all instances accessible within the account, filtered by ``region``, ``plans_preference``, and ``tags``. If ``plans_preference`` is not set, free and trial instances will be prioritized over paid instances. Also note that only one account per API token can be used. The API token is linked to the account it was created in. If you want to use multiple accounts, you must create multiple API tokens. The service will attempt to load an account from file if (a) no explicit ``token`` was provided during instantiation or (b) a ``name`` is specified, even if an explicit ``token`` was provided to the service constructor. The account will be selected based on the following criteria: - If a ``filename`` is specified, account details will be loaded from ``filename``, else they will be loaded from the default configuration file. - If a ``name`` is specified, the corresponding account details will be loaded from the configuration file, including ``channel``, ``token``, ``instance``, ``region``, ``plans_preference``, and the advanced configuration parameters: ``url``, ``url_resolver``, ``private_endpoint``, ``verify``, and ``proxies``. **Important Note**: An explicit ``instance`` value provided during instantiation will **overwrite** the value of the loaded ``instance``. - If no ``name`` is specified: if ``channel`` is specified, the service will load the default account associated with that channel from the configuration file. Else, it will fall back to the overall default account, defined when calling :meth:`.save_account` with ``set_as_default=True``. Args: Optional[ChannelType] channel: String that identifies the service platform. This is set to ``ibm_quantum_platform`` by default, but can additionally take ``local`` and ``ibm_cloud`` as values. If ``local`` is selected, the local testing mode will be used, and primitive queries will run on a local simulator. For more details, check the `Qiskit Runtime local testing mode `_ documentation. For non-local modes, the channel is used to resolve the default API URL value. ``ibm_cloud`` was the identifier for the legacy IBM Cloud platform, and its url will be redirected to the new ``ibm_quantum_platform`` url. Optional[str] token: IBM Cloud API key. Providing an API key is required for IQP authentication. If not provided explicitly, the default saved account will be queried for this API key. Optional[str] url: The API URL. Defaults to different values depending on the selected channel: https://quantum.cloud.ibm.com (``ibm_quantum_platform``), or https://quantum-computing.cloud.ibm.com (``ibm_cloud``). Optional[str] filename: Full path of the file where the account is created. Default: _DEFAULT_ACCOUNT_CONFIG_JSON_FILE. Optional[str] name: Name of the account to load from file. Optional[str] instance: The service instance to use. For ``ibm_cloud`` and ``ibm_quantum_platform``, this is the Cloud Resource Name (CRN) or the service name. If set, it will define an instance for service instantiation, if not set, the service will fetch all instances accessible within the account following the specified filtering criteria. Optional[dict] proxies: Proxy configuration. Supported optional keys are ``urls`` (a dictionary mapping protocol or protocol and host to the URL of the proxy, documented at https://requests.readthedocs.io/en/latest/api/#requests.Session.proxies), ``username_ntlm``, ``password_ntlm`` (username and password to enable NTLM user authentication) Optional[bool] verify: Whether to verify the server's TLS certificate. Optional[bool] private_endpoint: Connect to private API URL. Optional[Callable] url_resolver: Function used to resolve the runtime url. Optional[str] region: Set a region preference for automatic instance selection. This argument is **ignored** if an ``instance`` is specified. Accepted values are ``us-east`` or ``eu-de``. An instance with this region will be prioritized if an instance is not passed in. Optional[List[str]] plans_preference: A list of account plan names ordered by priority for automatic instance selection. This argument is **ignored** if an ``instance`` is specified. Only instances with the given plan names will be considered. For example, if you want to avoid using your premium accounts you can just pass in ``"open"`` to only use your open plan instances. Accepted values include (but are not limited to): ``open``, ``premium``, ``flex``, ``on-prem``, ``pay-as-you-go``. Optional[List[str]] tags: Set a list of tags to filter available instances for automatic instance selection. This argument is **ignored** if an ``instance`` is specified. Returns: An instance of QiskitRuntimeService or QiskitRuntimeLocalService for local channel. Raises: IBMInputValueError: If an input is invalid. N)r;r<r?r-r=r>r@rAr-r;r<r?r@rArBrCFcrnz\The given API token is associated with an account that does not have access to the instance za. To use this instance, use an API token generated from the account with this instance available.Tr>plan, Nonezus-east, eu-dez, plans_preference: )z), and available plans: (z(tags: z , region: a"Instance was not set at service instantiation. %sBased on the following filters: %s, the available account instances are: %s. If you need a specific instance set it explicitly either by using a saved account with a saved default instance or passing it in directly to QiskitRuntimeService().z3Free and trial plan instances will be prioritized. )'r2__init___all_instances_saved_instances_discover_accountr_accountrBr$r-r;r<r?r@rA_client_params_channel _url_resolver_backend_configs_default_instancer_active_api_client_backends_list_backend_instance_groupsrD_regionrE_plans_preferencerF_tags instancesr _api_clients_resolve_cloud_instancesr0joinloggerwarning_get_or_create_cloud_client)selfr-r;r<r=r>r?r@rArBrCrDrErFinstinstance_backendsinstance_namesinstance_plan_namestags_str region_strjoined_preferencesplans_preference_strjoined_plan_namesfilters_r7s r8rQQiskitRuntimeService.__init__=s[H 46+-..5<&11$/     '-=MM *.MM))--%% !!]]++MM))==''!]];;%   -- )EG!&"/0C0C"D46>@%5!5!5 !1!ST]]5S5S/T]]// == ! !}}%%dnnFV-WFVd5kFV-WW($$(MM$:$:#;<44 &*D "!%!7!7tGZGZ9[ \D  "D  $ = =h G CGC`C`aC`xll62C`Na595R5R#5R V$5R #15 tyy,H)-;KJ%%*.))D4J4J*K")=>P=QQR'S$$(II.A$B!)BCTBUUV'W$z |H\G]^G NN9--N .) -a006-W.Xb#sOOO"cXRR:waWXR;aURUUlO3URU5nURR X05 X lURR 5UlUR Vs/sHo3SPM sn$s snf![a [RSU5 /s$f=f)z.Retrieve all backends from the given instance.r>zInvalid instance %s) r[ _instancerb_create_new_cloud_api_clientupdate list_backendsr\ Exceptionrerf)rhr? new_clientbackends r8 _discover_backends_from_instance5QiskitRuntimeService._discover_backends_from_instances 22<<<000.2.?.?.ID+!%!B!B8!LJ%%,,h-CD.8+"&"9"9"G"G"ID 373F3FG3FFO3FG GG  NN0( ;I s$BB5B0-B50B55"CCc Z[URRURRURRUURR URR URRURS9Ul [UR5$)z*Create a new api_client given an instance.rI) r$rUr-r;r<r@rArBrXrVr)rhr?s r8rw1QiskitRuntimeService._create_new_cloud_api_client+s|.MM))--%% !!MM))==''!]];;++  T0011r:c^^^UR(aIURV^s/sH+m[U4SjUR55(dM)TPM- snUlUR(a6URVs/sHoRUS;dMUPM snUlUR(adURVs/sHo"R 5PM snmURVs/sHo3ST;dM UPM nn[ UU4SjS9UlO!/SQm[ URU4SjS9UlUR(d|SnUR(aUS URS 3- nUR(aUS URS 3- nUR(aUS UR3- n[S US35egs snfs snfs snfs snf)z6Filter instances by saved region and plan preferences.c3N># UHoR5TS;v M g7f)rFN)lower).0tagds r8 NQiskitRuntimeService._filter_instances_by_saved_preferences..?sF:Cyy{ai/:s"%rJrKc,>TRUS5$)NrKindex)rplanss r8MQiskitRuntimeService._filter_instances_by_saved_preferences..Osu{{1V9/Er:key)freetrialpaygopaid subscriptionc,>TRUS5$)N pricing_typer)rordered_pricing_typess r8rrVs399!N:KLr:rOztags: rLzregion: zplan: z6No matching instances found for the following filters:.N)r`r]allr^r_rsortedr)rhrrKgroupfiltered_groups error_stringrrs ` @@r8&_filter_instances_by_saved_preferences;QiskitRuntimeService._filter_instances_by_saved_preferences9s ::66-6AF4::FF6-D ) <<88-8aLLAeHGc Sn U=(d Sn U(anU(a*[XAU/5(a[RSUU5 O([XAU/5(a[RSU5 [R"XVS9n OU(aU(aUS;a [ S5eU(a/[ R"UUUUUU S9n [RS 5 O{U(a[RS U5 [R"XVUS 9n OHU(a/[ R"S UUUUU S9n [RS 5 OU(a [ S 5eU c[R"US9n U(aX9lU(aXyl UbXl U RS;aIU R(a8[U R5(dURXRS9U lU R5 U $)zADiscover account for ibm_cloud and ibm_quantum_platform channels.NTz]Loading account from file %s with name %s. Any input 'channel', 'token' or 'url' are ignored.zPLoading account with name %s. Any input 'channel', 'token' or 'url' are ignored.)r=r> ibm_cloudibm_quantum_platformz;'channel' can only be 'ibm_cloud', or 'ibm_quantum_platform)r-r;r<r?r@rAzGLoading account with the given token. A saved account will not be used.z3Loading default %s account. Input 'url' is ignored.r=r>r-rzT'url' is not valid as a standalone parameter. Try also passing in 'token' or 'name'.)r=)accountr?)anyrerfrr0 ValueErrorrcreate_accountr?r@rAr-r_get_crn_from_instance_namevalidate) rhr;r<r?r-r=r>r@rArverify_s r8rT&QiskitRuntimeService._discover_accountfs.D ,--NNC  ,--NNC %(((FG 7*OO !^__!00#%#" ]NN#XZab(,,hSZ[ ,,.! G NNY f  ?$(((;G '  %O  #N OOD D  7++,,#??*:*: @ G  r:rcfUR(dUR5UlURVs/sHo3SU:XdM UPM nnU(aF[U5S:a/[R S5 UVs/sHoUSPM snUlUSS$[ SUS35es snfs snf)z+Get the crn from the instance service name.r>rz7Multiple instances found. Using all matching instances.rJrzThe instance specified (z) is not a valid instance name.)rRlist_instanceslenrerfrSr)rhrr?itemmatching_instancesris r8r0QiskitRuntimeService._get_crn_from_instance_names""")"8"8":D /3/B/B_/Bt6lV^F^d/B_ %&*XYAS(TASeAS(T%%a(/ /$*8*4WW ` )Us B)B)<B.paramscl[SSUR0UR5D6nUR5$)zCheck the version of the remote server in a set of client parameters for all channels. Args: params: Parameters used for server connection. Returns: A dictionary with version information. r<rP)rr<connection_parametersversion)rversion_finders r8_check_api_version'QiskitRuntimeService._check_api_versions2'X6::X9U9U9WX%%''r:c~Uc UR$URRUS5nUc[SU35eU$)aXReturn the saved api client for a given instance for all channels. If no instance is provided, return the current active api client. Args: instance: IBM Cloud account CRN Returns: An instance of ``RuntimeClient`` that matches the specified instance. Raises: IBMInputValueError: If no saved api client matches the given instance. Nz(No API client found for given instance: )r[rbr0rrhr?clients r8_get_api_client$QiskitRuntimeService._get_api_clientsM  ** *&&**8T:F~(+ST\S])^__Mr:cUR$)zReturn dictionary of saved api clients identified by their corresponding instance for all channels. Returns: An dictionary of {instance: RuntimeClient} )rbrhs r8_get_api_clients%QiskitRuntimeService._get_api_clientss   r:F)use_fractional_gatescalibration_idmin_num_qubitsdynamic_circuitsrrzibm_backend.IBMBackendrrr6c ^^/n [5n URU5n U HupU(a X;aMU/n O:URH*nXS:XdM [R SUSUS5 M, U HnX;aM U(a:URH*nXS:XdM [R SUSUS5 M, U R U5 UR U 5 URUU UUS9=n(dMU RU5 M M U(aXS'T(a[[U4SjU 55n Tb[[U4S jU 55n U HnUURl M [U 4S U0UD6$) aReturn all backends accessible via this account, subject to optional filtering. Args: name: Backend name to filter by. min_num_qubits: Minimum number of qubits the backend has to have. instance: IBM Cloud account CRN dynamic_circuits: Filter by whether the backend supports dynamic circuits. filters: More complex filters, such as lambda functions. For example:: QiskitRuntimeService.backends( filters=lambda b: b.max_shots > 50000 ) QiskitRuntimeService.backends( filters=lambda x: ("rz" in x.basis_gates ) ) use_fractional_gates: Set True to allow for the backends to include fractional gates. Note that our backends now support dynamic circuits and fractional gates simultaneously. You no longer have to disable this flag when using dynamic circuits features (e.g. ``if_else``) in your algorithm. Control flow instructions are not removed from the backend when this flag is set to True. If ``None``, then both fractional gates and control flow operations are included in the backends. calibration_id: The calibration id used for instantiating the backend. This should only be used when selecting a single backend as the calibration id is defined per backend. **kwargs: Simple filters that require a specific value for an attribute in backend configuration or status. Examples:: # Get the operational real backends QiskitRuntimeService.backends(simulator=False, operational=True) # Get the backends with at least 127 qubits QiskitRuntimeService.backends(min_num_qubits=127) # Get the backends that support OpenPulse QiskitRuntimeService.backends(open_pulse=True) For the full list of backend attributes, see the `IBMBackend class documentation `_ Returns: The list of available backends that match the filter. Raises: IBMInputValueError: If an input is invalid. QiskitBackendNotFoundError: If the backend is not in any instance. rJzLoading instance: %s, plan: %sr>rKzUsing instance: %s, plan: %sr?rr backend_namec>>UR5RT:$N) configurationn_qubitsbrs r8r/QiskitRuntimeService.backends..js!2!;!;~!Mr:cF>S[UR5S/5;T:H$)Nrsupported_features)getattrr)rrs r8rros%*gaoo6GI]_a.bb'(r:rr)setrcr]rerfaddrg_create_backend_objappendlistfilteroptionsrr)rhr>rr?rrrrrr6backendsunique_backendsrjribackends_available inst_detailsrr|s ` ` r8rQiskitRuntimeService.backendss~&(% 99(C(9 $D1&*V"$($A$ALE22<(0(0%B!3 2(,(E(E #66"NN > ,V 4 ,V 4)F ##L1006"66 !)=#1 77 OOG,'!3):B %)> " MxXH  '( H G3GGOO 0 xCCFCCr:c U(a[U5(d1URURU5nU(d[US35eUR(a-URVs/sHnX R U54PM sn$XR U54/$UR (agURRnUR(a-URVs/sHnX R U54PM sn$X0R U54/$UR(dURR5UlUR(dZURVs/sH-nUSUSUSUR US5USUSS.PM/ snUl UR5 URVs/sH o"SUS4PM sn$s snfs snfs snfs snf) Nz is not a valid instance.r>rJrKrFr)r>rJrKrrFrr) rrrUrrSr}rZr?rRrr]r)rhr?ri default_crns r8rc-QiskitRuntimeService._resolve_cloud_instances|s (##;;DMM8T,z9R-STT$$!% 5 5 5@@FG 5DDXNOP P  ! !--00K$$!% 5 5 5@@FG 5!"G"G "TUV V"""&--">">"@D ,,!// -0D!L; L $ E Ed5k R L$($8 0 -D )  7 7 9<@P>P5P%;#'#:#:#P#P)5$Q$"*-A F;A)),78#66LL%1 M &)= 7=%%l3 ))!$22-    NNG Z sBC!0C!! D +DD c6URR5$)zReturn the IBM Quantum account currently in use for the session. Returns: A dictionary with information about the account currently in the session. )rUto_saved_formatrs r8active_account#QiskitRuntimeService.active_accounts }},,..r:c,[R"XUS9$)aPDelete a saved account from disk. Args: filename: Name of file from which to delete the account. name: Name of the saved account to delete. channel: Channel type of the default account to delete. Ignored if account name is provided. Returns: True if the account was deleted. False if no account was found. r)rdeleters r8delete_account#QiskitRuntimeService.delete_accounts$$$h7SSr: overwriteset_as_defaultcj[R"UUUUUUU(a [S0UD6OSUUU U U U U S9 g)aSave the account to disk for future use. Args: token: IBM Cloud API key. url: The API URL. Defaults to https://cloud.ibm.com. instance: This is an optional parameter to specify the CRN or service name. If set, it will define a default instance for service instantiation, if not set, the service will fetch all instances accessible within the account. channel: Channel type. ``ibm_cloud`` or ``ibm_quantum_platform``. filename: Full path of the file where the account is saved. name: Name of the account to save. proxies: Proxy configuration. Supported optional keys are ``urls`` (a dictionary mapping protocol or protocol and host to the URL of the proxy, documented at https://requests.readthedocs.io/en/latest/api/#requests.Session.proxies), ``username_ntlm``, ``password_ntlm`` (username and password to enable NTLM user authentication) verify: Verify the server's TLS certificate. overwrite: ``True`` if the existing account is to be overwritten. set_as_default: If ``True``, the account is saved in filename, as the default account. private_endpoint: Connect to private API URL. region: Set a region preference. `us-east` or `eu-de`. An instance with this region will be prioritized if an instance is not passed in. plans_preference: A list of account plan names (``open``, ``premium``, etc.), ordered by preference. An instance with the first value in the list will be prioritized and only instances with the given plan names will be considered. For example, if you want to avoid using your premium accounts you can just pass in ``"open"`` to only use your open plan instances. ``plans_preference`` is ignored if an ``instance`` is specified. tags: Set a list of tags to filter available instances. Instances with these tags will be prioritized if an instance is not passed in. Nr;r<r?r-r=r>r@rArrrBrDrErFrP)rsaverrs r8 save_account!QiskitRuntimeService.save_account sJf 5<&11$)-- r:defaultc p[[S[R"XX#S9R 555$)aList the accounts saved on disk. Args: default: If set to True, only default accounts are returned. channel: Channel type.``ibm_cloud`` or ``ibm_quantum_platform``. filename: Name of file whose accounts are returned. name: If set, only accounts with the given name are returned. Returns: A dictionary with information about the accounts saved on disk. Raises: ValueError: If an invalid account is found on disk. c>US[R"US54$)Nrr)rr)kvs r8r5QiskitRuntimeService.saved_accounts..hsBqE7#:#:2a5#ABr:rr-r=r>)dictmaprritemsrs r8saved_accounts#QiskitRuntimeService.saved_accountsQs6* B###x%'    r:cURUUUUS9nU(d"SnURS;aSn[SU-5eUS$)a1Return a single backend matching the specified filtering. Args: name: Name of the backend. instance: Specify the IBM Cloud account CRN. use_fractional_gates: Set True to allow for the backends to include fractional gates. Currently this feature cannot be used simultaneously with dynamic circuits, PEC, PEA, or gate twirling. When this flag is set, control flow instructions are automatically removed from the backend. When you use a dynamic circuits feature (e.g. ``if_else``) in your algorithm, you must disable this flag to create executable ISA circuits. This flag might be modified or removed when our backend supports dynamic circuits and fractional gates simultaneously. If ``None``, then both fractional gates and control flow operations are included in the backends. calibration_id: The calibration id used for instantiating the backend. Returns: Backend: A backend matching the filtering. Raises: QiskitBackendNotFoundError: if no backend could be found. rrOrzz Learn more about available backends here https://quantum.cloud.ibm.com/docs/en/guides/qpu-information#view-your-resources No backend matches the criteria.r)rrWr)rhr>r?rrr cloud_msg_urls r8r|QiskitRuntimeService.backendosc>== !5) !  M}} EEg--OR_-_` `{r: program_idinputsrresult_decoder session_id start_sessioncXUnUc [5nO [U[5(a [S0UD6nURURS9 UR n [U [ 5(aUR UR5S9n U R5n U RSLaAU RS:wa1[R"SU RSU RS35 U(aURS S 5OS n URR!UUR5UUR"UR$UUR&UR(UUR*UR,US 9 n U S(a)U SUR5:waUR U SS9n [9U URU SUUUR"UR&UU UR,S9 $![.a=n U R0S :Xa[3S U R435Se[7SU 35SeSn A ff=f)aExecute the runtime program. Args: program_id: Program ID. inputs: Program input parameters. These input values are passed to the runtime program. options: Runtime options that control the execution environment. result_decoder: A :class:`ResultDecoder` subclass used to decode job results. If more than one decoder is specified, the first is used for interim results and the second final results. If not specified, a program-specific decoder or the default ``ResultDecoder`` is used. session_id: Job ID of the first job in a runtime session. start_session: Set to True to explicitly start a runtime session. Defaults to False. Returns: A ``RuntimeJobV2`` instance representing the execution. Raises: IBMInputValueError: If input is invalid. RuntimeProgramNotFound: If the program cannot be found. IBMRuntimeError: An error occurred running the program. N)r-r>Tactivez The backend z currently has a status of rrr) rrrimage log_levelrjob_tagsmax_execution_timer session_timeprivaterzProgram not found: zFailed to run program: r|id) r|rjob_idrrrrFrrrrP)r% isinstancerrr-r|strget_backend_namestatus operational status_msgwarningswarnr>r0r[ program_runrrrrrrr status_codermessagerr")rhrrrrrrr qrt_optionsr|r"rresponsers r8_runQiskitRuntimeService._runsB'. ?(*K  & &(373KT\\2%% gs # #ll (D(D(FlGG!    %&*;*;x*G MMw||n,GHYHYGZZ[\ /5&**Y*! L..::%(99;!''%//%$--#.#A#A+(55#++-; H( I 8I#6+:V:V:X#Xll(;l!)##%%''    L~~$,/B2::,-OPVZZ!$;B4"@At K LsA.G"" H),8H$$H)rcURRUSS9nURU5$![anURS:wa[ SU35SeSnUR R 5HWupEUcM X@RR:wdM%XPlURRUSS9n O![a MUf=f UbURU5sSnA$[SU35SeSnAff=f)zRetrieve a runtime job. Args: job_id: Job ID. Returns: Runtime job retrieved. Raises: RuntimeJobNotFound: If the job doesn't exist. IBMRuntimeError: If the request failed. T)exclude_paramsrzFailed to retrieve job: NJob not found: ) r[job_getrr(rrbrrv _decode_jobr )rhrr+rr?rs r8jobQiskitRuntimeService.jobs  K..66vd6SH"))!  K~~$%(@&EFDPH$($5$5$;$;$= 'H8O8O8Y8Y,Y!28/#'#:#:#B#B6Z^#B#_+! ! %>#''11$vh%?@d J KsK- C:AC5<C5 B:8C5: CC5CC5 C:&C55C:limitskippendingr created_aftercreated_before descendingc zU(apX`RR:waWX`R;aURUUlO3URU5n URR Xl05 XlU(a [ U5 /n U=(d SnUnURR UUUUUUUU U U S9 nUSnUSnU U- n [U 5UU- :XaO8U(a[U 5U:aO!U[U 5- nOSnU[U5- nM|U Vs/sHnURU5PM sn$s snf)a@Retrieve all runtime jobs, subject to optional filtering. Args: limit: Number of jobs to retrieve. ``None`` means no limit. skip: Starting index for the job retrieval. backend_name: Name of the backend to retrieve jobs from. pending: Filter by job pending state. If ``True``, 'QUEUED' and 'RUNNING' jobs are included. If ``False``, 'DONE', 'CANCELLED' and 'ERROR' jobs are included. program_id: Filter by Program ID. instance: Filter by IBM Cloud instance crn. job_tags: Filter by tags assigned to jobs. Matched jobs are associated with all tags. session_id: Filter by session id. All jobs in the session will be returned in desceding order of the job creation date. created_after: Filter by the given start date, in local time. This is used to find jobs whose creation dates are after (greater than or equal to) this local date/time. created_before: Filter by the given end date, in local time. This is used to find jobs whose creation dates are before (less than or equal to) this local date/time. descending: If ``True``, return the jobs in descending order of the job creation date (i.e. newest first) until the limit is reached. Returns: A list of runtime jobs. Raises: IBMInputValueError: If an input value is invalid. ) r5r6rr7rrrr8r9r:jobscount) r[rvrbrwrxr#jobs_getrr2)rhr5r6rr7rr?rrr8r9r:r{ job_responsescurrent_page_limitoffset jobs_responsejob_pager>r3s r8r=QiskitRuntimeService.jobssYV $;$;$E$EE,,,*.*;*;H*E'!>>xH !!((()?@*4'  h ' "[b 33<<()%!%+-%= M%V,H"'*E X %M=!UT\1}%.%*S-?%?"%'" c(m #FAD2??#  %???sD8c[R"S[SS9 URR U5 g![ a=nUR S:Xa[SUR35Se[SU35SeSnAff=f)z(DEPRECATED) Delete a runtime job. Note that this operation cannot be reversed. Args: job_id: ID of the job to delete. Raises: RuntimeJobNotFound: The job doesn't exist. IBMRuntimeError: Method is not supported. zThe delete_job() method is deprecated and will be removed in a future release. The new IBM Quantum Platform does not support deleting jobs. stacklevelrr0NzFailed to delete job: ) r%r&DeprecationWarningr[ job_deleterr(r r)r)rhrrs r8 delete_jobQiskitRuntimeService.delete_jobus   K    K  # # . .v 6 K~~$(?2::,)GHdR!$:2$"?@d J Ks8 A?8A::A?cURR5nURS5(dURS5(aB[URSURS55URSS5- S5nX!S'U$)zaReturn usage information for the current active instance. Returns: Dict with usage details. usage_limit_secondsusage_allocation_secondsusage_consumed_secondsrusage_remaining_seconds)r[ cloud_usager0max)rh usage_dictusage_remainings r8usageQiskitRuntimeService.usages ,,88: >>/ 0 0JNNC]4^4^!4jnnE_6`a..!91=>O 5D0 1r:raw_datacURRnSU;aURUSUSS9nOSn[UURUUSURS05RSS5URS S5URS 5URS 5URS 5URS S5S9 $![a$ [R R USSS9nNf=f)zDecode job data received from the server. Args: raw_data: Raw job data received from the server. Returns: Decoded job data. r|F)r?rN)rapirprogramrOcreatedr(rrFr) r|rrrr creation_daterrrFr) r[rvrrrIBMRetiredBackend from_namer"r0)rhrYr?r|s r8r2 QiskitRuntimeService._decode_jobs**44 H$22Y'(QV3..D>||Ir266tR@",,y$7,,y)||L1f%LLE2  * !33==%i0>G sCC+C0/C0c0[R"S[SS9 UR5R S5SnUR S5nUR S5nX#:aFUR SS S S 9nU(a-[ RS US5 USRS S9 ggg![a2n[ RSUSR5U5 SnAgSnAff=f![a n[ RSU5 SnAgSnAff=f)z(DEPRECATED) Check the number of pending jobs and wait for the oldest pending job if the maximum number of pending jobs has been reached. zThe check_pending_jobs() method is deprecated and will be removed in a future release. The new IBM Quantum Platform does not support this functionality.rGrH byInstancer pendingJobsmaxPendingJobsrFT)r5r:r7zeThe pending jobs limit has been reached. Waiting for job %s to finish before submitting the next one.i,)timeoutz8An error occurred while waiting for job %s to finish: %sNz5Unable to retrieve open plan pending jobs details. %s) r%r&rJrWr0r=rerfwait_for_final_staterzdebugr)rhrW pending_jobsmax_pending_jobsoldest_runningrs r8check_pending_jobs'QiskitRuntimeService.check_pending_jobss   P    XJJL$$\215E 99]3L$yy)9: /!%ud!S!NNW&q) &q)>>s>K"0% V*1-446 X NNRTV W W Xs<A:C+B,, C(6(C#C+#C((C++ D5DDc ^/nU(a"URU5nUR5nOUR(d@URR 5H!nUR5nU(aXW- nM!M# Oonline)rrrr?c>UST:$)NqubitsrPrs r8r1QiskitRuntimeService.least_busy.."sq{n/Lr:r c US$)N queue_lengthrP)rs r8rrr%s 1^;Lr:rrrP)rryrZrbvaluesrr\r[rrr>copyremoverrrrr|rz)rhrr?rrr6 all_backendsrclient_backends candidatesr|rbackfiltered_backend_names candidatesorted_backendss ` r8 least_busyQiskitRuntimeService.least_busys. ))(3F!//1L''++224&,&:&:&">"@D """r:c.URR$)z.Return the crn of the current active instance.)r[rvrs r8active_instance$QiskitRuntimeService.active_instance9s&&000r:cUR$)zCReturn the channel type used. Returns: The channel type used. )rWrs r8r-QiskitRuntimeService.channel=s}}r:cLSRURR5$)Nz<{}>)formatr7__name__rs r8__repr__QiskitRuntimeService.__repr__Fs}}T^^4455r:othercURUR:H=(aa URRURR:H=(a- URRURR:H$r)rWrUr?r;)rhrs r8__eq__QiskitRuntimeService.__eq__IsY MMU^^ + < &&%..*A*AA < ##u~~';';; r:)rUr[rRrbrYr]r\rWrVrZr_r^rSr`rX) NNNNNNNNNNNNN)rGN)NNNNNNNNr)NNNNN)NNN)NNNNNNNNFNFNNN)NNNN)NFN)NNNFN) rNNNNNNNNT)Dr __module__ __qualname____firstlineno____doc__r3rrr rboolrrrQr}rrwrrrrTr staticmethodr$rrrrrintr rr rcrgr&rrrrrrrBackendr|r%r r!r r"r,r3rr=rLrWr2rlrrrarpropertyr-rr__static_attributes__ __classcell__)r7s@r8r*r*0s@(*.#!"&""&"&!%+/QU $04$(X7+&X7}X7c] X7 3- X7 sm X73-X7$X7X7#4.X7xc8D>3(G(LMNX7 X7#49-X7tCy!X7 X7X7tc( 2S 2] 2+^ $!"&)-"&"04!%Z}Zc]Z3- Z +& Z 3- ZsmZ,-ZZ Zx7cc" (#3 (S%c BR=R8S ( (#'3- 0!$sM'9":!#(,"&+/HL xD05(,xDsmxD! xD3- xD #4. xD ($<#=t#CDE xD'tnxD! xDxD & 'xDt([#([4cSWX[S\nH]C^([T-C-D-)- @@3-@'tn @ ! @  @D/c3h 8/"&")-T3-TsmT+&T  TT&#!"&)-"&""&!%$))-+0'+/3$(A }A c]A 3-A +& A 3- A sm A $A A D>A !A #4.A $A #8,A tCy!A  A A F"&)-"&"  $ +& 3- sm     @#'/4(, --3--'tn - ! -  -f:>^b$((-(,W W W % 456 W !tM':HT-EXrsTTT9B:*'APP&.,*SS/($3+#,   8 $ ^ ^ r: