{ "cells": [ { "cell_type": "markdown", "id": "008d2ceb-f6fa-42f6-a7df-6bd604775278", "metadata": {}, "source": [ "---\n", "title: \"Guide de démarrage rapide de Sampler\"\n", "description: \"Guide de démarrage rapide sur l'utilisation de la primitive « Sampler » d' IBM Quantum.\"\n", "---\n", "\n", "\n", "\n", "# Guide de démarrage rapide de Sampler\n", "\n" ] }, { "cell_type": "markdown", "id": "b7e96291-0925-4d7f-81a8-a7738549477c", "metadata": {}, "source": [ "La tâche principale de l'échantillonneur consiste à échantillonner le registre de sortie issu de l'exécution d'un ou plusieurs circuits quantiques. [Les circuits dynamiques](/docs/guides/execute-dynamic-circuits) et les circuits paramétrés sont acceptés en entrée (si des circuits paramétrés sont soumis, les valeurs des paramètres doivent également être fournies). Sampler prend également en charge le découplage dynamique et le twirling intégrés pour [la suppression des erreurs](/docs/guides/error-mitigation-and-suppression-techniques).\n", "\n", "Les étapes décrites dans cette rubrique expliquent comment installer Sampler, découvrir les options disponibles pour le configurer et l'appeler dans un programme.\n", "\n" ] }, { "cell_type": "markdown", "id": "818a2b3d-3950-4a28-8e37-39959c56484b", "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[all]~=2.5.1\n", " qiskit-ibm-runtime~=0.47.0\n", " ```\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "64e2e09f-8528-4088-897b-1529b451ab1e", "metadata": {}, "source": [ "\n", "\n", "## Étapes pour utiliser la primitive Sampler\n", "\n", "\n", "\n", "### 1. Créer le compte\n", "\n", "Vous devez d'abord configurer votre compte. Vous pouvez ensuite sélectionner le QPU que vous souhaitez utiliser pour calculer la valeur attendue.\n", "\n", "Si vous n'avez pas encore de compte, suivez les étapes décrites dans la rubrique «[ Configurer votre compte IBM Cloud](/docs/guides/cloud-setup) ».\n", "\n", "\n", " Pour utiliser les [portes fractionnaires](/docs/guides/fractional-gates) désormais prises en charge, définissez `use_fractional_gates=True` lorsque vous demandez un backend à une `QiskitRuntimeService` instance. Par exemple :\n", "\n", " ```python\n", " service = QiskitRuntimeService()\n", " fractional_gate_backend = service.least_busy(use_fractional_gates=True)\n", " ```\n", "\n", " Il s'agit d'une fonctionnalité expérimentale qui est susceptible d'évoluer à l'avenir.\n", "\n", "\n" ] }, { "cell_type": "code", "execution_count": 1, "id": "b40504d7-aee5-4b30-98b1-265e70bece8d", "metadata": {}, "outputs": [], "source": [ "from qiskit_ibm_runtime import QiskitRuntimeService\n", "\n", "service = QiskitRuntimeService()\n", "backend = service.least_busy(\n", " operational=True, simulator=False, min_num_qubits=127\n", ")" ] }, { "cell_type": "markdown", "id": "73374fbc-d3b6-4d2d-84c6-edf85b43ea25", "metadata": {}, "source": [ "\n", "\n", "### 2. Créer un circuit\n", "\n", "Il faut au moins un circuit comme entrée pour la primitive Sampler.\n", "\n" ] }, { "cell_type": "code", "execution_count": 2, "id": "dfe23a34-2ea9-48af-bd1d-c7e3185aa80c", "metadata": {}, "outputs": [], "source": [ "import numpy as np\n", "from qiskit.circuit.library import efficient_su2\n", "\n", "circuit = efficient_su2(127, entanglement=\"linear\")\n", "circuit.measure_all()\n", "# The circuit is parametrized, so we will define the parameter values for execution\n", "param_values = np.random.rand(circuit.num_parameters)" ] }, { "cell_type": "markdown", "id": "6cf08ef6-34d3-42e6-8cb3-391b60217289", "metadata": {}, "source": [ "Le circuit et l'observable doivent être transformés afin de n'utiliser que des instructions prises en charge par le QPU (ce que l'on appelle des circuits *d'architecture de jeu d'instructions, ou ISA* ). Pour ce faire, utilisez le transcompilateur.\n", "\n" ] }, { "cell_type": "code", "execution_count": 3, "id": "062bd89b-b13e-46d0-96b6-6c84b2131415", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ ">>> Circuit ops (ISA): OrderedDict([('rz', 3036), ('sx', 1769), ('cz', 378), ('measure', 127), ('barrier', 1)])\n" ] } ], "source": [ "from qiskit.transpiler import generate_preset_pass_manager\n", "\n", "pm = generate_preset_pass_manager(optimization_level=1, backend=backend)\n", "isa_circuit = pm.run(circuit)\n", "print(f\">>> Circuit ops (ISA): {isa_circuit.count_ops()}\")" ] }, { "cell_type": "markdown", "id": "cf0f2c0a-8574-45c6-a43b-1a99eac81279", "metadata": {}, "source": [ "\n", "\n", "### 3. Initialiser l'échantillonneur « IBM Quantum »\n", "\n", "Lorsque vous initialisez Sampler, utilisez le paramètre `mode` pour spécifier le mode dans lequel vous souhaitez qu'il s'exécute. Les valeurs possibles sont `batch`, `session`, ou pour `backend` les modes d'exécution par lots, par session et par tâche, respectivement. Pour plus d'informations, consultez la section « [Introduction aux modes d'exécution du service de calcul d' IBM Quantum](/docs/guides/execution-modes) ». Veuillez noter que les utilisateurs d'Open Plan ne peuvent pas soumettre de tâches de session.\n", "\n" ] }, { "cell_type": "code", "execution_count": 4, "id": "a2b80dca-dff8-49f9-8154-e2cb0b768507", "metadata": {}, "outputs": [], "source": [ "from qiskit_ibm_runtime import SamplerV2 as Sampler\n", "\n", "sampler = Sampler(mode=backend)" ] }, { "cell_type": "markdown", "id": "f35972bf-17d3-40be-852b-9e56615c7c3c", "metadata": {}, "source": [ "\n", "\n", "### 4. Lancer Sampler et obtenir les résultats\n", "\n", "Ensuite, appelez la `run()` méthode pour générer la sortie. Le circuit et les ensembles de valeurs de paramètres facultatifs sont fournis sous forme de tuples *de blocs unifiés primitifs* ( PUB ).\n", "\n" ] }, { "cell_type": "code", "execution_count": 5, "id": "e52e6a96-dc23-4f76-8152-b54514a99dfb", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ ">>> Job ID: d9mq9og8csec73fagt7g\n" ] }, { "name": "stdout", "output_type": "stream", "text": [ ">>> Job Status: QUEUED\n" ] } ], "source": [ "job = sampler.run([(isa_circuit, param_values)])\n", "print(f\">>> Job ID: {job.job_id()}\")\n", "print(f\">>> Job Status: {job.status()}\")" ] }, { "cell_type": "code", "execution_count": 6, "id": "4543fac5-abdc-4440-a1a2-d32aabe135d6", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "First ten results for the 'meas' output register: ['1010011011000000000000000000000000001111111111001010101010001110011000011101100100011100111111111010010110000011010100110111100', '0111100001100000011011101000000111111001011010110000101100011000000011010001000100000111001110011001111010100001100010100000000', '0111010101001110000110100000000110011000011011001111000110101101010100010010111111101011000000010000101111000001010110001000000', '1100111011000010011001100100001101111000101111110110011001011001100110000000000110111100110011000001100000100100001000000000000', '0011111010101101001111111110011000111000000010100011011111111011100110101010111111111101111110100011101101011100110010011010100', '1011111111011010000000000111000000010101001001000110011101100010010001100110100101111111110010001000001000101111100100011000000', '1110101101101011111111000010101010111100110011001010101111110110101010101111110000001110001111101101010100111011110001000000000', '1001010011111010000001010100011000101110111110111101100001010100011110000001000001000110000000000001101010110010110000011001000', '0000101010100000111000100001010101100101011101010110000001100110011001111011111110111010101000011001000011001001101101001010110', '1001001011000000010011101100010011101100010001001100100110011101100100000000111101010010000101011011011110110110001000111101100']\n" ] } ], "source": [ "result = job.result()\n", "\n", "# Get results for the first (and only) PUB\n", "pub_result = result[0]\n", "print(\n", " f\"First ten results for the 'meas' output register: \"\n", " f\"{pub_result.data.meas.get_bitstrings()[:10]}\"\n", ")" ] }, { "cell_type": "markdown", "id": "d38dd409-e0d8-4749-bb22-58ae9a53d26a", "metadata": {}, "source": [ "\n", "\n", "## Etapes suivantes\n", "\n", "\n", " * Découvrez comment effectuer [des tests en local](local-testing-mode) avant de lancer vos programmes sur des ordinateurs quantiques.\n", " * Consultez [des exemples](sampler-examples) détaillés.\n", " * Entraînez-vous avec les primitives en suivant la [leçon](/learning/courses/variational-algorithm-design/cost-functions) sur la fonction « Cost » dans « IBM Quantum Learning ».\n", " * Découvrez comment effectuer une transpilation en local dans la section «[ Transpilation](transpile/) ».\n", " * Consultez le guide [sur la comparaison des paramètres du transcompilateur](/docs/guides/circuit-transpilation-settings#compare-transpiler-settings).\n", " * Découvrez comment [utiliser les options de base](/docs/guides/runtime-options-overview).\n", " * Consultez l'API pour connaître les options [de Sampler](/docs/api/qiskit-ibm-runtime/options-sampler-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 }