Référence de l'API Orbit de Quantum Elements

Type: Iterable[SamplerPubLike] or Iterable[EstimatorPubLike]

Un ou plusieurs PUB correspondant à la primitive sélectionnée.

• Obligatoire : oui
• Types d'entrée valides : itérable d'objets de type « Sampler » PUB ou itérable d'objets de type « Estimator » PUB

Chaque « PUB » doit correspondre au contrat d'entrée de la primitive sélectionnée.

• Pour primitive="sampler" : chaque PUB suit la forme PUB Sampler, par exemple (circuit, parameter_values, shots).
• Pour primitive="estimator" : chaque PUB suit la forme PUB de l'estimateur, par exemple (circuit, observables, parameter_values, precision).
• Les circuits ne doivent pas nécessairement être des circuits ISA dans le chemin par défaut options.transpilation_mode="optimize" ; Orbit se charge de leur transcompilation et de leur planification en interne.

Type: str

Permet de sélectionner la primitive « IBM Quantum » qu’Orbit utilise pour l’exécution.

• Obligatoire : oui
• Types de données valides : str

La primitive définit ce que chaque « PUB » doit contenir et quelles données de résultat chacune PubResult renvoie.

• Choix : "sampler" / "estimator"
• À utiliser "sampler" pour les données de type « bitstring » échantillonnées.
• Utilisez "estimator" pour les valeurs attendues et les erreurs-types.

Type: str or None

Valeur par défaut: None

Nom du backend « IBM Quantum » sur lequel l'application doit s'exécuter.

• Obligatoire : Non

• Valeur par défaut : None

• Types d'entrée valides : str ou None

• En cas d'omission ou de None, Orbit sélectionne un backend opérationnel éligible (autre qu'un simulateur) à l'aide de least_busy().

• Exemple:"ibm_boston"

Type: dict or None

Valeur par défaut: None

Options spécifiques à chaque fonction permettant de contrôler le comportement d'exécution d'Orbit.

• Obligatoire : Non
• Valeur par défaut : None
• Types d'entrée valides : dict ou None

Les options permettent de contrôler la transpilation, l'insertion de DD, les options de calcul quantique, le mode aperçu, le mode simulateur, l'exportation des informations du backend et l'atténuation des erreurs de mesure.

• Les touches d'option inconnues sont rejetées.
• Indiquez None, {}, ou ne rien indiquer options pour utiliser toutes les valeurs par défaut.
• Exemple :

{
    "pub_options": [
        {"mode": "raw"},
        {"mode": "orbit"},
        {
            "mode": "custom",
            "dd_strategy": [[{"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1}]],
            "transpilation_mode": "optimize",
            "mem": True
        }
    ]
}

Type: bool

Valeur par défaut: False

Orbit renvoie-t-il un rapport d'insertion DD sans soumettre de tâche de calcul quantique?

• Obligatoire : Non

• Valeur par défaut : False

• Types de données valides : bool

• TrueDans ce cas, aucun temps de QPU n'est utilisé; Orbit se contente de prétraiter les circuits dans pubs et fournit un rapport d'insertion.

• Lorsque False (valeur par défaut), une tâche de calcul quantique comportant des circuits modifiés par Orbit est soumise et traitée.

• TrueSi et simulator sont tous preview deux, le mode aperçu prévaut et l'exécution du simulateur est ignorée.

Type: bool

Valeur par défaut: False

Le mode aperçu inclut-il le circuit post-Orbit préparé pour chaque PUB dans les métadonnées?

• Obligatoire : Non

• Valeur par défaut : False

• Types de données valides : bool

• À n'utiliser que lorsque preview=True.

• debugCircuit.circuit``TrueChaque rapport « PUB » comprend le nombre de, debugCircuit.usedQubits, et d'opérations. Cela inclut également une approche « au mieux » debugCircuit.qasm lorsque Qiskit est en mesure d'exporter le circuit.

• Laissez cette option désactivée pour les exécutions normales, car les charges utiles des circuits peuvent être volumineuses.

Type: string

Valeur par défaut: optimize

Comment Orbit prépare les circuits d' PUB s avant l'insertion des DD.

• Obligatoire : Non

• Valeur par défaut : "optimize"

• Valeurs d'entrée valides : "optimize", "prepare", ou "validate"

• "optimize" effectue plusieurs fois la transpilation avec Qiskit optimization_level=2 et retient la solution présentant la profondeur en deux qubits la plus faible pour les circuits statiques et dynamiques.

• "prepare" gère la préparation de Qiskit optimization_level=0 et la planification d'ALAP. Si physical_layout est fourni, Orbit matérialise d'abord le circuit sur ces indices de fils physiques et utilise la méthode de disposition « trivial » de Qiskit.

• "validate" considère que le circuit d'entrée est déjà physiquement mis en place. Orbit vérifie la compatibilité du backend lorsque cela est possible, n'effectue ni remappage, ni routage, ni optimisation, ni correction de la planification avant l'insertion du DD, et ignore physical_layout l'opération en affichant un avertissement.

Type: object or null

Valeur par défaut: None

Mappage optionnel des qubits logiques vers les qubits physiques.

• Obligatoire : Non
• Valeur par défaut : None
• Types d'entrée valides : objet dont les clés et les valeurs sont des entiers non négatifs, ou None

Exemple : {"0": 85, "1": 89} associe le qubit logique 0 au qubit physique 85 et le qubit logique 1 au qubit physique 89. Python Les appelants peuvent utiliser des clés de type entier; les clés des objets JSON sont des chaînes de caractères.

• En "optimize" mode, cette valeur est transmise comme point de départ de la disposition initiale et le mappage final peut évoluer au cours de l'optimisation/du routage.
• En "prepare" mode, Orbit matérialise le circuit sur ces indices de fils physiques, puis utilise la préparation « level-0 » avec layout_method="trivial". Les SWAP à routage explicite peuvent tout de même déplacer un état quantique pendant l'exécution.
• En "validate" mode, les fils du circuit fournis font autorité; par conséquent, physical_layout est ignoré et un avertissement s'affiche.

Type: int

Valeur par défaut: 300

Nombre de tentatives de transpilation stochastique « Orbit » en transpilation_mode="optimize".

• Obligatoire : Non
• Valeur par défaut : 300
• Types d'entrée valides : entier positif

Type: bool or None

Valeur par défaut: None

Si Orbit utilise la technique de réduction des erreurs de mesure « Sampler-only » via l' M3.

• Obligatoire : Non

• Valeur par défaut : None

• Types d'entrée valides : bool ou None

• Lorsque True, applique une atténuation des erreurs de mesure aux prises de vue provenant de sampler.

• Lorsque False, il n'effectue pas de post-traitement des prises de vue.

• NoneLorsque le mode « Orbit » est activé, la fonction MEM s'applique aux PUB du Sampler en cours d'exécution; en modes « raw » et « custom », la fonction MEM n'est pas prise en compte, sauf configuration contraire.

• « Explicit True » nécessite primitive="sampler", preview=False, et simulator=False.

• Les nombres bruts d'échantillons sont conservés et les nombres corrigés sont associés aux métadonnées d'Orbit.

• Si la correction échoue lors du post-traitement, Orbit conserve le résultat brut et consigne l'échec de la correction dans les métadonnées.

Type: list[dict] or None

Valeur par défaut: None

Modes d'exécution et règles de remplacement par « per- PUB ».

• Obligatoire : Non

• Valeur par défaut : None

• Types d'entrée valides : list[dict] ou None

• Une entrée est diffusée vers tous les PUB; sinon, transmettre une entrée par PUB.

• {"mode": "raw"} utilise un seul passage de transpilation et de planification Qiskit optimization_level=0 pour les circuits statiques ou dynamiques, et ignore l'optimisation Orbit, Orbit DD, DD dynamique et MEM.

• {"mode": "orbit"} utilise les paramètres par défaut d'Orbit.

• {"mode": "custom"} peut remplacer transpilation_mode, physical_layout, dd_qubits, dd_strategy, dynamic_dd_seq, et mem pour cette PUB e.

• Le mode « Raw » utilise transpilation_mode="prepare" toujours avec physical_layout=None, ignore Orbit DD et ne tient pas compte des options de préparation globales.

• Les PUB « Orbit » et personnalisés héritent des paramètres globaux transpilation_mode et physical_layout à moins qu'ils ne les redéfinissent via PUB.

• Utilisez des PUB dupliqués avec pub_options pour comparer les données brutes, les paramètres par défaut d'Orbit et une stratégie DD personnalisée au sein d'une même tâche Quantum Compute. Pour une référence CPMG « naïve », utilisez {"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1} dans le fichier. PUB personnalisé dd_strategy.

Pour les circuits préparés par l'appelant, utilisez transpilation_mode="validate" pour les PUB compatibles Orbit :

options = {
    "pub_options": [
        {"mode": "raw"},
        {"mode": "orbit", "transpilation_mode": "validate"},
        {
            "mode": "custom",
            "transpilation_mode": "validate",
            "dd_qubits": None,
            "dd_strategy": [[{"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1}]],
            "mem": False,
        },
    ]
}

Type: list[list[dict]]

Stratégies DD classées par ordre d'application aux circuits d' PUB.

• Obligatoire : Non

• Valeur par défaut : [[{"dd_sequence": "auto", "pulse_density": 0.25, "dd_reps": 1}]]

• Types de données valides : list[list[dict]]

• Choix : liste externe non vide de listes de stratégies non vides.

• La liste externe répertorie les PUB ou les circuits. Si une seule stratégie est fournie, Orbit la diffuse à tous les PUB.

• Chaque liste interne est appliquée, itération après itération, au même circuit.

• Chaque tour nécessite dd_sequence; pulse_density la valeur par défaut est 0.25; dd_reps la valeur par défaut est 1.

Type: str or dict or list or None

Valeur par défaut: XY8

Séquence DD utilisée pour l'insertion DD à anticipation de circuit dynamique d'Orbit.

• Obligatoire : Non

• Valeur par défaut : "XY8"

• listTypes d'entrée valides : str, dict, groupe d'impulsions personnalisé, ou None

• Options : Utilisez les mêmes formes de séquence que dd_strategy[].dd_sequence, ou None pour désactiver l'étage d'insertion dynamique en avance.

• S'applique lorsque Orbit détecte une logique conditionnelle ou un flux de contrôle et utilise le pipeline DD à circuit dynamique.

• Le passage normal dd_strategy est d'abord exécuté, puis Orbit applique cette séquence aux régions dynamiques de pré-alimentation étiquetées.

Type: list[int] or None

Valeur par défaut: None

Liste blanche globale des indices de qubits éligibles à l'insertion dans Orbit DD.

• Obligatoire : Non

• Valeur par défaut : None

• Types d'entrée valides : list[int] ou None

• Options : None ou une liste d'entiers >= 0

• None ne cible que les qubits actifs ou touchés.

• Une liste peut inclure des qubits « idle-only » et exclut les qubits qui n'y figurent pas.

• pub_options[i].dd_qubits Il est possible de remplacer cette valeur dans orbit les entrées ou custom PUB.

• Les listes d'autorisation explicites ne peuvent être fournies que pour les PUB compatibles Orbit dont l'adresse résolue transpilation_mode est "validate", de sorte que l'appelant détienne les indices des qubits physiques. dd_qubitsLes PUB « bruts » ignorent Orbit DD et n'acceptent pas les fichiers.

Type: bool

Valeur par défaut: False

Orbit enregistre-t-il les propriétés d'étalonnage du backend après l'exécution d'une tâche de calcul quantique?

• Obligatoire : Non

• Valeur par défaut : False

• Types de données valides : bool

• Choix : True / False

• Lorsqu'elle est activée, Orbit interroge service.job(job_id).properties(), enregistre les propriétés sérialisées du backend sous /data, et indique le chemin d'accès de l'enregistrement dans les métadonnées d'Orbit.

• Les échecs sont signalés sous forme d'avertissements et n'entraînent pas l'annulation des résultats des primitives qui ont par ailleurs abouti.

Type: int

Valeur par défaut: 4096

Images par défaut utilisées pour les PUB Sampler qui ne précisent pas explicitement les images.

• Obligatoire : Non

• Valeur par défaut : 4096

• Types de données valides : int

• Options : nombre entier > 0

• S'applique uniquement à primitive="sampler".

Type: float

Valeur par défaut: 0.015625

Précision cible par défaut utilisée pour les PUB de l'estimateur qui ne précisent pas explicitement la précision.

• Obligatoire : Non

• Valeur par défaut : 0.015625

• Types d'entrée valides : float ou int

• Options : Flottant > 0

• S'applique uniquement à primitive="estimator".

Type: dict

IBM Quantum options primitives transmises à la primitive sous-jacente SamplerV2 ou EstimatorV2.

• Obligatoire : Non

• Valeur par défaut : {"resilience_level": 0, "dynamical_decoupling": {"enable": false}}

• Types de données valides : dict

• Les dictionnaires d'options imbriqués sont pris en charge, y compris les options avancées et expérimentales pour la primitive sélectionnée.

• Le découplage dynamique à l'exécution est désactivé par défaut; par conséquent, l'insertion DD d'Orbit est la seule étape de découplage dynamique, sauf si l'utilisateur choisit de l'activer.

Par exemple, les utilisateurs expérimentés de Sampler peuvent activer les champs de débogage des circuits dynamiques :

options = {
    "runtime_options": {
        "experimental": {
            "execution": {
                "scheduler_timing": True,
                "stretch_values": True,
            }
        }
    }
}

• Avertissement : il convient donc de modifier cette valeur avec précaution, en activant manuellement certaines fonctionnalités telles que le « twirling » tout en continuant à exclure le DD.

Type: int or None

Valeur par défaut: None

Limite souple de la durée maximale d'exécution d'une tâche Quantum Compute.

• Obligatoire : Non
• Valeur par défaut : None
• Types d'entrée valides : int ou None

La valeur est indiquée en secondes.

• Options : None ou un nombre entier > 0
• NoneDans ce cas, la valeur par défaut de Runtime est utilisée.

Type: bool

Valeur par défaut: False

Si Orbit exécute la charge de travail sur un simulateur Aer local plutôt que sur un QPU réel.

• Obligatoire : Non
• Valeur par défaut : False
• Types de données valides : bool

Le simulateur s'exécute au sein du conteneur de fonctions.

• Choix : True / False
• Ignoré lorsque preview est égal à True.
• Un objet « normal » PrimitiveResult est renvoyé, accompagné des métadonnées d'Orbit.

Type: str

Valeur par défaut: backend

Modèle de bruit utilisé lorsque simulator est égal à True.

• Obligatoire : Non

• Valeur par défaut : "backend"

• Types de données valides : str

• Choix : "backend" / "ideal"

• "backend" utilise AerSimulator.from_backend(backend) , dans la mesure du possible.

• AerSimulator``"ideal" utilise un fichier simple et sans bruit.

Type: int or None

Valeur par défaut: None

Durée d'une porte ou d'une impulsion DD.

• Obligatoire : Non

• Valeur par défaut : None

• Types d'entrée valides : int ou None

• Avertissement : n'utilisez une valeur explicite que dans le cadre de tests contrôlés ou lorsque vous avez une raison précise liée au backend et justifiée.

• Cette valeur utilise les mêmes unités que celles utilisées par le backend pour les délais, généralement dt.

• Options : None ou un nombre entier > 0

• Lorsque None Orbit résout une valeur tenant compte du backend à partir de backend.target en utilisant la durée de porte X calibrée la plus longue ou la durée de porte sqrt(X).

Type: PrimitiveResult

Standard, PrimitiveResult avec métadonnées Orbit associées.

• primitive="sampler"En effet, chacun d'entre eux PubResult.data contient des données de résultats d'échantillonnage, telles que des tableaux de bits de registre classique.
• primitive="estimator"En effet, chacun d'entre eux PubResult.data contient des données de résultats d'estimation, telles que les valeurs attendues et les erreurs-types.
• En mode aperçu, chaque champ est PubResult.data vide car aucune primitive « IBM Quantum » n'a été soumise.