{
"cells": [
{
"cell_type": "markdown",
"id": "7acdb263-fde4-4ff3-a13d-c499a2ba77e4",
"metadata": {},
"source": [
"---\n",
"title: \"Définir les options de l'exécuteur\"\n",
"description: \"Spécifiez les options lors de la compilation avec la primitive Executor.\"\n",
"---\n",
"\n",
"\n",
"\n",
"# Définir les options de l'exécuteur\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "73e3d6f4",
"metadata": {
"tags": [
"version-info"
]
},
"source": [
"{/*\n",
" DO NOT EDIT THIS CELL!!!\n",
" This cell's content is generated automatically by a script. Anything you add\n",
" here will be removed next time the notebook is run. To add new content, create\n",
" a new cell before or after this one.\n",
" */}\n",
"\n",
"\n",
" \n",
" Le code présenté sur cette page a été développé en tenant compte des exigences suivantes.\n",
" Nous vous recommandons d'utiliser ces versions ou des versions plus récentes.\n",
"\n",
" ```\n",
" qiskit-ibm-runtime~=0.46.1\n",
" ```\n",
" \n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "513837ac-8853-4f45-8d8f-1a8297d5ab68",
"metadata": {},
"source": [
"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.\n",
"\n",
"\n",
" * Vous pouvez consulter les options disponibles et modifier leurs valeurs pendant ou après l'initialisation des primitives.\n",
" * Utilisez la `update()` méthode pour appliquer les modifications à `options` l'attribut.\n",
" * `options` L'attribut est de `dataclass` type Python. Vous pouvez utiliser la méthode intégrée `asdict` pour le convertir en dictionnaire.\n",
" * Executor ne peut traiter que les informations encodées sous forme de samplexes. Consultez les [guides Samplomatic](https://qiskit.github.io/samplomatic/guides/index) pour en savoir plus sur les restrictions.\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"## Définir les options de l'exécuteur\n",
"\n",
"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.\n",
"\n",
"\n",
"\n",
"### Initialisation des types primitifs\n",
"\n",
"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.\n",
"\n",
"\n",
"\n",
"#### Cours sur les options\n",
"\n",
"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`.\n",
"\n",
"Exemple :\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "948f4e75-3079-4c18-ba38-ce536b3f99b5",
"metadata": {},
"outputs": [],
"source": [
"from qiskit_ibm_runtime import QiskitRuntimeService, Executor\n",
"from qiskit_ibm_runtime.options import ExecutorOptions\n",
"\n",
"service = QiskitRuntimeService()\n",
"backend = service.least_busy(operational=True, simulator=False)\n",
"\n",
"options = ExecutorOptions(\n",
" environment={\"log_level\": \"INFO\"},\n",
" execution={\"init_qubits\": True},\n",
")\n",
"\n",
"# or use the following instead:\n",
"\n",
"options = ExecutorOptions()\n",
"options.environment.log_level = \"INFO\"\n",
"options.execution.init_qubits = True\n",
"\n",
"executor = Executor(mode=backend, options=options)"
]
},
{
"cell_type": "markdown",
"id": "ba2f5146-2781-49da-9fa2-8a22647225d0",
"metadata": {},
"source": [
"\n",
"\n",
"#### Dictionnaire\n",
"\n",
"Vous pouvez définir les options sous forme de dictionnaire lors de l'initialisation d'Executor.\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "cf4359c2-c97a-475c-998d-518dc05a445e",
"metadata": {},
"outputs": [],
"source": [
"from qiskit_ibm_runtime import QiskitRuntimeService, Executor\n",
"\n",
"service = QiskitRuntimeService()\n",
"backend = service.least_busy(operational=True, simulator=False)\n",
"\n",
"# Setting options during primitive initialization\n",
"executor = Executor(\n",
" backend,\n",
" options={\n",
" \"environment\": {\"log_level\": \"INFO\"},\n",
" \"execution\": {\"init_qubits\": True},\n",
" },\n",
")"
]
},
{
"cell_type": "markdown",
"id": "b981eda7-bd9b-4d1e-959a-12cfc35fc2a1",
"metadata": {},
"source": [
"\n",
"\n",
"\n",
"\n",
"## Options disponibles\n",
"\n",
"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](/docs/api/qiskit-ibm-runtime) et sélectionnez une version précédente.\n",
"\n",
"\n",
" \n",
" [`environment` Documentation de l'API](/docs/api/qiskit-ibm-runtime/options-sampler-options#environment)\n",
"\n",
" \n",
" \n",
" Liste des balises.\n",
"\n",
" **Options** : Aucune\n",
"\n",
" **Par défaut** : Aucun\n",
" \n",
"\n",
" \n",
" **Options** : DEBUG, INFO, WARNING, ERROR, CRITICAL\n",
"\n",
" **Par défaut** : AVERTISSEMENT\n",
" \n",
"\n",
" \n",
" **Options** : `True`, `False`\n",
"\n",
" **Par défaut** : `False`\n",
" \n",
"\n",
" \n",
" **Valeurs possibles** : nombre entier de secondes compris entre \\[1 et 10 800]\n",
"\n",
" **Par défaut** : 10800 (3 heures)\n",
" \n",
" \n",
" \n",
"\n",
" \n",
" [`execution` Documentation de l'API](/docs/api/qiskit-ibm-runtime/options-sampler-options#execution)\n",
"\n",
" \n",
" \n",
" Faut-il ramener les qubits à l'état fondamental à chaque tir?\n",
"\n",
" **Options** : `True`, `False`\n",
"\n",
" **Par défaut** : `True`\n",
" \n",
"\n",
" \n",
" Le délai entre une mesure et le circuit quantique qui suit.\n",
"\n",
" **Options** : Valeur comprise dans la plage fournie par `backend.rep_delay_range`\n",
"\n",
" **Par défaut** : fourni par `backend.default_rep_delay`\n",
" \n",
"\n",
" \n",
" **Options** : `classified`, `kerneled`, `avg_kerneled`\n",
"\n",
" **Par défaut** : `classified`\n",
" \n",
" \n",
" \n",
"\n",
" \n",
" Options expérimentales, le cas échéant.\n",
" \n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "9b86001b-718a-4d72-b3b5-4a67eabf0a45",
"metadata": {},
"source": [
"\n",
"\n",
"## Etapes suivantes\n",
"\n",
"\n",
" * Consultez la documentation de l'API d' [ExecutionOptionsV2](/docs/api/qiskit-ibm-runtime/options-execution-options-v2).\n",
" * Consultez la documentation de l'API d' [EnvironmentOptions](/docs/api/qiskit-ibm-runtime/options-environment-options).\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"id": "a1b8767d",
"source": "© IBM Corp., 2017-2026"
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3"
}
},
"nbformat": 4,
"nbformat_minor": 4
}