Définir les options de l'exécuteur

Le code présenté sur cette page a été développé en tenant compte des exigences suivantes. Nous vous recommandons d'utiliser ces versions ou des versions plus récentes.
```
qiskit-ibm-runtime~=0.46.1
```

Vous pouvez utiliser des options pour personnaliser la primitive Executor. Contrairement à Sampler et à Estimator, Executor ne dispose que de très peu d'options, car la plupart des intentions de conception sont codées dans le samplex.

Remarques

Vous pouvez consulter les options disponibles et modifier leurs valeurs pendant ou après l'initialisation des primitives.
Utilisez la update() méthode pour appliquer les modifications à options l'attribut.
options L'attribut est de dataclass type Python. Vous pouvez utiliser la méthode intégrée asdict pour le convertir en dictionnaire.
Executor ne peut traiter que les informations encodées sous forme de samplexes. Consultez les guides Samplomatic pour en savoir plus sur les restrictions.

Définir les options de l'exécuteur

Si une option est spécifiée à la fois pendant et après l'initialisation de la primitive, c'est la valeur définie après l'initialisation de la primitive qui est utilisée.

Initialisation des types primitifs

Lors de l'initialisation d'Executor, vous pouvez lui transmettre une instance de la classe d'options ou un dictionnaire; il en fera alors une copie. Ainsi, la modification du dictionnaire d'origine ou de l'instance d'options n'a aucune incidence sur les options associées à la primitive.

Cours sur les options

Lors de la création d'une instance de la Executor classe, vous pouvez lui transmettre une instance de la classe d'options. Ces options sont ensuite prises en compte lorsque vous utilisez run() pour effectuer le calcul. Indiquez les options sous ce format : options.option.sub-option.sub-sub-option = choice. Par exemple : options.environment.log_level = INFO.

Exemple :

from qiskit_ibm_runtime import QiskitRuntimeService, Executor
from qiskit_ibm_runtime.options import ExecutorOptions

service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)

options = ExecutorOptions(
    environment={"log_level": "INFO"},
    execution={"init_qubits": True},
)

# or use the following instead:

options = ExecutorOptions()
options.environment.log_level = "INFO"
options.execution.init_qubits = True

executor = Executor(mode=backend, options=options)

Dictionnaire

Vous pouvez définir les options sous forme de dictionnaire lors de l'initialisation d'Executor.

from qiskit_ibm_runtime import QiskitRuntimeService, Executor

service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)

# Setting options during primitive initialization
executor = Executor(
    backend,
    options={
        "environment": {"log_level": "INFO"},
        "execution": {"init_qubits": True},
    },
)

Options disponibles

Le tableau suivant présente les options de la dernière version de qiskit-ibm-runtime. Pour consulter les versions antérieures de cette option, rendez-vous sur la qiskit-ibm-runtime documentation de l'API et sélectionnez une version précédente.

environment Documentation de l'API
- Liste des balises.
  Options : Aucune
  Par défaut : Aucun
- Options : DEBUG, INFO, WARNING, ERROR, CRITICAL
  Par défaut : AVERTISSEMENT
- Options : True, False
  Par défaut : False
- Valeurs possibles : nombre entier de secondes compris entre [1 et 10 800]
  Par défaut : 10800 (3 heures)
execution Documentation de l'API
- Faut-il ramener les qubits à l'état fondamental à chaque tir?
  Options : True, False
  Par défaut : True
- Le délai entre une mesure et le circuit quantique qui suit.
  Options : Valeur comprise dans la plage fournie par backend.rep_delay_range
  Par défaut : fourni par backend.default_rep_delay
- Options : classified, kerneled, avg_kerneled
  Par défaut : classified
Options expérimentales, le cas échéant.

Etapes suivantes

Recommandations

Consultez la documentation de l'API d' ExecutionOptionsV2.
Consultez la documentation de l'API d' EnvironmentOptions.

Cette page a-t-elle été utile ?

Signaler un bogue, une coquille ou proposer du contenu sur GitHub.