QiskitRuntimeService

Retourne le type de canal utilisé.

Retours

Le type de canal utilisé.

active_account()

Retourne le compte IBM Quantum actuellement utilisé pour la session.

Retours

Un dictionnaire contenant des informations sur le compte en cours de session.

Type de retour

[d] ictstr, str | Aucun

active_instance()

Renvoie le crn de l'instance active actuelle.

Type de retour

str

backend(name, instance=None, use_fractional_gates=False, calibration_id=None)

Renvoie un seul backend correspondant au filtrage spécifié.

Veuillez noter que la disponibilité du backend n'est vérifiée qu'au moment de l'envoi du circuit. Pour vérifier l'état du backend à l'avance, utilisez la status() méthode sur l'objet backend :

from qiskit_ibm_runtime import QiskitRuntimeService

service = QiskitRuntimeService()
backend = service.backend()

status = backend.status()
assert status.operational and status.status_msg == "active"

Paramètres

• name (str) – Nom du backend.
• instance (str | None) – Indiquez le CRN du compte IBM Cloud.
• use_fractional_gates (bool | None) – Définissez cette valeur sur « True » pour permettre aux backends d'inclure des portes fractionnaires. Pour connaître les restrictions d 'utilisation, consultez la section « Quand ne pas utiliser les portes fractionnaires ».
• calibration_id (str | None) – L'identifiant de calibration utilisé pour l'instanciation du backend.

Retours

Un backend correspondant au filtrage.

Augmentations

• QiskitBackendNotFoundError - si aucun backend n'a pu être trouvé.
• IBMInputValueError – si des portes fractionnaires sont demandées mais ne sont pas prises en charge par le backend.

Type de retour

Back-end

backends(name=None, min_num_qubits=None, instance=None, dynamic_circuits=None, filters=None, *, use_fractional_gates=False, calibration_id=None, **kwargs)

Renvoie tous les backends accessibles via ce compte, sous réserve d'un filtrage optionnel.

Paramètres

• name (str | None) – Nom du backend à filtrer.

• min_num_qubits (int | None) – Nombre minimum de qubits que le backend doit posséder.

• instance (str | None) – IBM Cloud compte CRN

• dynamic_circuits (bool | None) – Filtrer en fonction de la prise en charge des circuits dynamiques par le backend.

• filters (Callable[[IBMBackend], bool] | None) –

  Filtres plus complexes, tels que les fonctions lambda. Par exemple :

  QiskitRuntimeService.backends(
      filters=lambda backend: (
          (status := backend.status()).operational
          and status.status_msg == "active"
      )
  )

  ne renverra que les backends opérationnels et actifs.

• use_fractional_gates (bool | None) – Mettre True pour permettre aux backends d'inclure des portes fractionnaires. Notez que nos backends prennent désormais en charge simultanément les circuits dynamiques et les portes fractionnaires. Il n'est plus nécessaire de désactiver ce drapeau lors de l'utilisation de circuits dynamiques (par exemple if_else) dans votre algorithme. Les instructions de flux de contrôle ne sont pas supprimées du backend lorsque cet indicateur est à True. Si None, les portes fractionnaires et les opérations de flux de contrôle sont incluses dans les backends.

• calibration_id (str | None) – L'identifiant de calibration utilisé pour l'instanciation du backend. Cette option ne doit être utilisée que lors de la sélection d'un seul backend, car l'identifiant d'étalonnage est défini pour chaque backend.

• **kwargs* (Any* ) -

  Filtres simples qui requièrent une valeur spécifique pour un attribut de la configuration ou de l'état du backend. Exemples :

  # 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)

  Pour la liste complète des attributs du backend, voir la documentation de la classe IBMBackend

Retours

La liste des backends disponibles qui correspondent au filtre.

Augmentations

• IBMInputValueError - Si une entrée n'est pas valide.
• QiskitBackendNotFoundError - Si le backend n'est dans aucune instance.

Type de retour

liste[ IBMBackend ]

static delete_account(filename=None, name=None, channel=None)

Supprimer un compte enregistré sur le disque.

Paramètres

• filename (str | None) – Nom du fichier dans lequel le compte doit être supprimé.
• name (str | None) – Nom du compte enregistré à supprimer.
• channel (ChannelType | None) – Type de canal du compte par défaut à supprimer. Ce paramètre est ignoré si un nom de compte est fourni.

Retours

Vrai si le compte a été supprimé. Faux si aucun compte n'a été trouvé.

Type de retour

booléen

delete_job(job_id)

Supprimer une tâche « IBM Quantum Compute ».

Notez que cette opération ne peut pas être annulée.

Paramètres

job_id (str) – ID du travail à supprimer.

Augmentations

• RuntimeJobNotFound – Le poste n'existe pas.
• IBMRuntimeError – La méthode n'est pas prise en charge.

Type de retour

Aucun

instances()

Renvoie une liste des instances disponibles pour le compte actif.

Renvoie une liste contenant une série de dictionnaires, chacun comportant les identifiants d'instance suivants : « crn », « plan », « name ».

Retours

Une liste des instances disponibles pour le compte actif.

Type de retour

Séquence[ [dic] tstr, Any]

job(job_id)

Récupérer une tâche « IBM Quantum Compute ».

Paramètres

job_id (str) – Job ID.

Retours

IBM Quantum Compute tâche récupérée.

Augmentations

• RuntimeJobNotFound - Si l'emploi n'existe pas.
• IBMRuntimeError - Si la demande a échoué.

Type de retour

RuntimeJobV2

jobs(limit=10, skip=0, backend_name=None, pending=None, program_id=None, instance=None, job_tags=None, session_id=None, created_after=None, created_before=None, descending=True)

Récupérer toutes les missions d' IBM Quantum Compute, en appliquant éventuellement des critères de filtrage.

Paramètres

• limit (int | None) – Nombre de travaux à récupérer. None signifie qu'il n'y a pas de limite.
• skip (int) – Index de départ pour l'extraction des travaux.
• backend_name (str | None) – Nom du backend à partir duquel les travaux doivent être récupérés.
• pending (bool | None) – Filtre sur l'état des travaux en attente. Si True, les travaux "QUEUED" et "RUNNING" sont inclus. Si False, les travaux "DONE", "CANCELLED" et "ERROR" sont inclus.
• program_id (str | None) – Filtrer par ID de programme.
• instance (str | None) – Filtrer par IBM Cloud crn d'instance.
• job_tags (list[str] | None) – Filtrer par mots-clés attribués aux emplois. Les emplois correspondants sont associés à toutes les balises.
• session_id (str | None) – Filtre sur l'identifiant de la session. Tous les travaux de la session seront renvoyés dans l'ordre de leur date de création.
• created_after (datetime | None) – Filtre sur la date de début donnée, en heure locale. Cette fonction permet de rechercher les emplois dont la date de création est postérieure (supérieure ou égale) à cette date/heure locale.
• created_before (datetime | None) – Filtre sur la date de fin donnée, en heure locale. Cette fonction est utilisée pour rechercher les emplois dont la date de création est antérieure (inférieure ou égale) à cette date/heure locale.
• descending (bool) – Si True, les travaux sont renvoyés dans l'ordre décroissant de leur date de création (c'est-à-dire le plus récent en premier) jusqu'à ce que la limite soit atteinte.

Retours

Une liste d'offres d'emploi chez IBM Quantum Compute.

Augmentations

IBMInputValueError - Si une valeur d'entrée n'est pas valide.

Type de retour

liste[ RuntimeJobV2 ]

least_busy(min_num_qubits=None, instance=None, filters=None, use_fractional_gates=False, **kwargs)

Renvoie le backend disponible le moins occupé.

Paramètres

• min_num_qubits (int | None) – Nombre minimum de qubits que le backend doit posséder.

• instance (str | None) – IBM Cloud compte CRN.

• filters (Callable[[IBMBackend], bool] | None) –

  Les filtres peuvent être définis comme pour la méthode backends() méthode. Un exemple pour obtenir les backends opérationnels avec 5 qubits :

  QiskitRuntimeService.least_busy(n_qubits=5, operational=True)

• use_fractional_gates (bool | None) –

  TrueDans ce cas, seuls les backends comportant des portes fractionnaires sont pris en compte, et ces portes fractionnaires sont incluses dans le backend renvoyé. Pour connaître les restrictions d 'utilisation, consultez la section « Quand ne pas utiliser les portes fractionnaires ».

• kwargs (Any) – Arguments supplémentaires transmis à la requête du backend.

Retours

Le backend ayant le plus petit nombre de travaux en attente.

Augmentations

QiskitBackendNotFoundError - Si aucun backend ne correspond aux critères.

Type de retour

IBMBackend

static save_account(token=None, url=None, instance=None, channel=None, filename=None, name=None, proxies=None, verify=None, overwrite=False, set_as_default=None, private_endpoint=False, region=None, plans_preference=None, tags=None)

Sauvegarder le compte sur le disque pour une utilisation ultérieure.

Paramètres

• token (str | None) – IBM Cloud Clé API.
• url (str | None) – L'API URL. La valeur par défaut est https://cloud.ibm.com.
• instance (str | None) – Il s'agit d'un paramètre facultatif permettant de spécifier l' CRN ou le nom du service. Si ce paramètre est défini, il déterminera l'instance par défaut à utiliser pour l'instanciation du service; s'il n'est pas défini, le service récupérera toutes les instances accessibles au sein du compte. Définissez la valeur sur "auto" pour enregistrer explicitement la sélection automatique comme préférence, ce qui supprime l'avertissement « instance non définie » lors des instanciations suivantes.
• channel (ChannelType | None) – Type de canal. ibm_cloud ou ibm_quantum_platform.
• filename (str | None) – Chemin complet du fichier dans lequel le compte est enregistré.
• name (str | None) – Nom du compte à sauvegarder.
• proxies (dict | None) – Configuration du serveur proxy. Les clés optionnelles prises en charge sont urls (un dictionnaire associant le protocole ou le protocole et l'hôte à l' URL e du proxy, documenté à l'adresse https://requests.readthedocs.io/en/latest/api/#requests.Session.proxies ), username_ntlm, password_ntlm (nom d'utilisateur et mot de passe pour activer l'authentification utilisateur NTLM)
• verify (bool | None) – Vérifiez le certificat TLS du serveur.
• overwrite (bool | None) – True si le compte existant doit être remplacé.
• set_as_default (bool | None) – Si True, le compte est enregistré dans le nom du fichier, en tant que compte par défaut.
• private_endpoint (bool | None) – Connexion à l'API privée URL.
• region (RegionType | None) – Définissez une préférence régionale. us-east ou eu-de. Une instance associée à cette région sera priorisée si aucune instance n'est fournie.
• plans_preference (PlanType | None) – Une liste des noms de plans de compte (open, premium, etc.), classés par ordre de préférence. Une instance correspondant à la première valeur de la liste sera privilégiée, et seules les instances portant les noms de plans indiqués seront prises en compte. Par exemple, si vous souhaitez éviter d'utiliser vos comptes premium, il vous suffit de passer le paramètre "open" pour n'utiliser que vos instances en mode « open plan ». plans_preference est ignoré si un instance est spécifié.
• tags (list[str] | None) – Définissez une liste de balises pour filtrer les instances disponibles. Les instances comportant ces balises seront prioritaires si aucune instance n'est transmise.

Type de retour

Aucun

static saved_accounts(default=None, channel=None, filename=None, name=None)

Liste des comptes enregistrés sur le disque.

Paramètres

• default (bool | None) – Si la valeur est True, seuls les comptes par défaut sont renvoyés.
• channel (ChannelType | None) – Canal type.\ \ibm_cloud`` ou ibm_quantum_platform.
• filename (str | None) – Nom du fichier dont les comptes sont renvoyés.
• name (str | None) – Si cette option est activée, seuls les comptes portant le nom donné sont renvoyés.

Retours

Un dictionnaire contenant des informations sur les comptes enregistrés sur le disque.

Augmentations

ValueError - Si un compte non valide est trouvé sur le disque.

Type de retour

dict

usage()

Renvoie des informations sur l'utilisation de l'instance active actuelle.

Retours

Dict avec détails d'utilisation.

Type de retour

dict [str, Any]