{ "cells": [ { "cell_type": "markdown", "id": "bed19311-f71d-4d8c-9a05-1b68fa72df29", "metadata": {}, "source": [ "---\n", "title: \"Sampler-Optionen festlegen\"\n", "description: \"Geben Sie beim Erstellen mit der Sampler-Primitive Optionen an.\"\n", "---\n", "\n", "\n", "\n", "# Sampler-Optionen festlegen\n", "\n" ] }, { "cell_type": "markdown", "id": "3adc856a-0fcd-47e4-94d9-22b90bddc24f", "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", " Der Code auf dieser Seite wurde unter Berücksichtigung der folgenden Anforderungen entwickelt.\n", " Wir empfehlen, diese Versionen oder neuere zu verwenden.\n", "\n", " ```\n", " qiskit[all]~=2.5.2\n", " qiskit-ibm-runtime~=0.47.0\n", " ```\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "56db929d-8b84-49b2-a98b-55d33f91ea30", "metadata": {}, "source": [ "Sie können die Sampler-Primitive mithilfe von Optionen anpassen. In diesem Abschnitt wird erläutert, wie man die grundlegenden Optionen von „ IBM Quantum “ festlegt. Zwar ist die Schnittstelle der Methode `run()` der Primitive in allen Implementierungen einheitlich, ihre Optionen sind es jedoch nicht. Informationen zu den Optionen [`qiskit_aer.primitives.SamplerV2`](https://qiskit.github.io/qiskit-aer/stubs/qiskit_aer.primitives.SamplerV2.html) und [`qiskit.primitives.BackendSamplerV2`](/docs/api/qiskit/qiskit.primitives.BackendSamplerV2) finden Sie in den entsprechenden API-Referenzen.\n", "\n", "\n", "\n", "\n", "\n", "## Sampler-Optionen festlegen\n", "\n", "Sie können Optionen bei der Initialisierung von Sampler festlegen, nach der Initialisierung von Sampler oder die Optionen aktualisieren, nachdem Sampler initialisiert wurde. Anweisungen zur Anwendung dieser Techniken finden Sie im Abschnitt „[Einführung in Optionen](/docs/guides/runtime-options-overview#options-precedence) “.\n", "\n", "Außerdem können Sie den `shots` Wert in der `run()` Methode festlegen, wie im folgenden Abschnitt beschrieben.\n", "\n" ] }, { "cell_type": "markdown", "id": "3ca44016-acfe-4540-ab0e-659b9577c4eb", "metadata": {}, "source": [ "\n", "\n", "\n", "\n", "### Methode „Run()“\n", "\n", "Die einzigen Werte, die Sie an übergeben können, sind diejenigen, `run()` die in der Schnittstelle definiert sind. Das heißt, `shots`. Dadurch wird jeder für `default_shots` den aktuellen Durchlauf festgelegte Wert überschrieben.\n", "\n" ] }, { "cell_type": "code", "execution_count": 1, "id": "c2423fcc-7f7f-4674-af6f-fc90f4b28b17", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "" ] }, "execution_count": 1, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from qiskit_ibm_runtime import QiskitRuntimeService\n", "\n", "# Legacy server-side primitive before qiskit-ibm-runtime 0.50.0\n", "# from qiskit_ibm_runtime import Sampler\n", "\n", "# Client-side primitive introduced in qiskit-ibm-runtime 0.50.0\n", "from qiskit_ibm_runtime.executor_sampler import Sampler\n", "from qiskit.circuit.library import random_iqp\n", "from qiskit.transpiler import generate_preset_pass_manager\n", "\n", "service = QiskitRuntimeService()\n", "backend = service.least_busy(operational=True, simulator=False)\n", "\n", "circuit1 = random_iqp(3)\n", "circuit1.measure_all()\n", "circuit2 = random_iqp(3)\n", "circuit2.measure_all()\n", "\n", "pass_manager = generate_preset_pass_manager(\n", " optimization_level=3, backend=backend\n", ")\n", "\n", "transpiled1 = pass_manager.run(circuit1)\n", "transpiled2 = pass_manager.run(circuit2)\n", "\n", "sampler = Sampler(mode=backend)\n", "# Default shots to use if not specified in run()\n", "sampler.options.default_shots = 500\n", "# Sample two circuits at 128 shots each.\n", "sampler.run([transpiled1, transpiled2], shots=128)" ] }, { "cell_type": "markdown", "id": "4bf67f60-ce62-4b95-b70c-b15f131be46d", "metadata": {}, "source": [ "\n", "\n", "### Sonderfälle\n", "\n" ] }, { "cell_type": "markdown", "id": "857e40a1-de1d-46f0-9db8-db55a6954f47", "metadata": {}, "source": [ "\n", "\n", "\n", "\n", "#### Shots\n", "\n", "Die `SamplerV2.run` Methode akzeptiert zwei Argumente: eine Liste von PUBs, von denen jedes einen für „ PUB “ spezifischen Wert für „shots“ angeben kann, sowie ein Schlüsselwortargument „shots“. Diese Schusswerte sind Teil der Sampler-Ausführungsschnittstelle und unabhängig von den Optionen des Runtime-Samplers. Sie haben Vorrang vor allen als Optionen angegebenen Werten, um der Sampler-Abstraktion zu entsprechen.\n", "\n", "Wenn jedoch weder in einer „ `shots`PUB “-Datei noch im Schlüsselwortargument „run“ angegeben ist (oder wenn alle diese Werte `None`auf gesetzt sind), wird der Wert für „shots“ aus den Optionen verwendet, insbesondere `default_shots`.\n", "\n", "Zusammenfassend lässt sich sagen, dass dies die Reihenfolge ist, in der Aufnahmen im Sampler für eine bestimmte „ PUB “ festgelegt werden:\n", "\n", "1. Wenn in der Datei „ PUB “ die Anzahl der Aufnahmen angegeben ist, verwende diesen Wert.\n", "2. Wenn das `shots` Schlüsselwort-Argument in `run`angegeben ist, verwende diesen Wert.\n", "3. Wenn aktiviert `twirling` ist, wird das Produkt aus `num_randomizations` und `shots_per_randomization`, wie in den [Optionen `twirling`](/docs/api/qiskit-ibm-runtime/options-models-twirling-options) angegeben, verwendet.\n", "4. Wenn angegeben `sampler.options.default_shots` ist, verwende diesen Wert.\n", "\n", "Wenn also an allen möglichen Stellen Schüsse festgelegt sind, wird derjenige mit der höchsten Priorität (die im „ PUB “ festgelegten Schüsse) verwendet.\n", "\n", "\n", " Obwohl die in der „ PUB “ und in `run` angegebenen Schüsse eine höhere Priorität haben, schlägt der Auftrag fehl, wenn `twirling` aktiviert ist und das Produkt aus `num_randomizations` und `shots_per_randomization` kleiner als der `shots` Wert ist. `num_randomizations`In diesem Fall ist es nicht möglich, `SamplerV2` die Aufnahmen auf die angegebenen Elemente zu verteilen.\n", "\n", "\n", "Beispiel:\n", "\n" ] }, { "cell_type": "code", "execution_count": 2, "id": "e06376f4-fcba-4d03-8cbc-c53ca02d81af", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "" ] }, "execution_count": 2, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from qiskit_ibm_runtime import QiskitRuntimeService\n", "\n", "# Legacy server-side primitive before qiskit-ibm-runtime 0.50.0\n", "# from qiskit_ibm_runtime import Sampler\n", "\n", "# Client-side primitive introduced in qiskit-ibm-runtime 0.50.0\n", "from qiskit_ibm_runtime.executor_sampler import Sampler\n", "from qiskit.circuit.library import random_iqp\n", "from qiskit.transpiler import generate_preset_pass_manager\n", "\n", "service = QiskitRuntimeService()\n", "backend = service.least_busy(operational=True, simulator=False)\n", "\n", "circuit1 = random_iqp(3)\n", "circuit1.measure_all()\n", "circuit2 = random_iqp(3)\n", "circuit2.measure_all()\n", "\n", "pass_manager = generate_preset_pass_manager(\n", " optimization_level=3, backend=backend\n", ")\n", "\n", "transpiled1 = pass_manager.run(circuit1)\n", "transpiled2 = pass_manager.run(circuit2)\n", "\n", "\n", "# Setting shots during primitive initialization\n", "sampler = Sampler(mode=backend, options={\"default_shots\": 4096})\n", "\n", "# Setting options after primitive initialization\n", "# This uses auto-complete.\n", "sampler.options.default_shots = 2000\n", "\n", "# This does bulk update. The value for default_shots is overridden\n", "# if you specify shots with run() or in the PUB.\n", "sampler.options.update(\n", " default_shots=1024, dynamical_decoupling={\"sequence_type\": \"XpXm\"}\n", ")\n", "\n", "# Sample two circuits at 128 shots each.\n", "sampler.run([transpiled1, transpiled2], shots=128)" ] }, { "cell_type": "markdown", "id": "29451d36-d88d-4726-96d2-f3083ac9e4a9", "metadata": {}, "source": [ "\n", "\n", "\n", "\n", "## Verfügbare Optionen\n", "\n", "Die folgende Tabelle enthält die Optionen aus der neuesten Version von `qiskit-ibm-runtime`. Um ältere Versionen der Optionen anzuzeigen, besuchen Sie die Seite [`qiskit-ibm-runtime` API-Referenz](/docs/api/qiskit-ibm-runtime) und wählen Sie eine frühere Version aus.\n", "\n", "\n", " \n", " Die Gesamtzahl der Schüsse, die pro Schaltkreis und Konfiguration verwendet werden sollen.\n", "\n", " **Auswahlmöglichkeiten** : Ganzzahl >= 0\n", "\n", " **Standard** : Keine\n", "\n", " [`default_shots` API-Dokumentation](/docs/api/qiskit-ibm-runtime/options-models-sampler-options#default_shots)\n", " \n", "\n", " \n", " Einstellungen zur Minderung dynamischer Entkopplungsfehler steuern.\n", "\n", " [`dynamical_decoupling` API-Dokumentation](/docs/api/qiskit-ibm-runtime/options-models-sampler-options#dynamical_decoupling)\n", "\n", " \n", " \n", " **Auswahlmöglichkeiten** : `True`, `False`\n", "\n", " **Standard** : `False`\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : `middle`, `edges`\n", "\n", " **Standard** : `middle`\n", " \n", "\n", " \n", " Auswahlmöglichkeiten: `asap`, `alap`\n", " Standard: `alap`\n", " \n", "\n", " \n", " Auswahlmöglichkeiten: `XX`, `XpXm`, `XY4`\n", " Standard: `XX`\n", " \n", "\n", " \n", " Auswahlmöglichkeiten: `True`, `False`\n", " Standard: `False`\n", " \n", " \n", " \n", "\n", " \n", " [`environment` API-Dokumentation](/docs/api/qiskit-ibm-runtime/options-models-sampler-options#environment)\n", "\n", " \n", " \n", " Liste der Tags.\n", "\n", " **Auswahlmöglichkeiten** : Keine\n", "\n", " **Standard** : Keine\n", " \n", "\n", " \n", " **Optionen** : DEBUG, INFO, WARNING, ERROR, CRITICAL\n", "\n", " **Standard** : WARNUNG\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : `True`, `False`\n", "\n", " **Standard** : `False`\n", " \n", " \n", " \n", "\n", " \n", " [`execution` API-Dokumentation](/docs/api/qiskit-ibm-runtime/options-models-sampler-options#execution)\n", "\n", " \n", " \n", " Ob die Qubits bei jedem Durchlauf in den Grundzustand zurückgesetzt werden sollen.\n", "\n", " **Auswahlmöglichkeiten** : `True`, `False`\n", "\n", " **Standard** : `True`\n", " \n", "\n", " \n", " Die Verzögerung zwischen einer Messung und dem darauf folgenden Quantenschaltkreis.\n", "\n", " **Auswahlmöglichkeiten** : Wert im angegebenen Bereich `backend.rep_delay_range`\n", "\n", " **Standard** : Vorgelegt von `backend.default_rep_delay`\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : `classified`, `kerneled`, `avg_kerneled`\n", "\n", " **Standard** : `classified`\n", " \n", " \n", " \n", "\n", " \n", " Legt fest, wie lange ein Auftrag laufen darf (in Sekunden). Weitere Informationen finden Sie im Leitfaden zur [maximalen Ausführungszeit](/docs/guides/max-execution-time).\n", "\n", " **Auswahlmöglichkeiten** : Ganzzahlige Angabe der Sekunden im Bereich \\[von] 1 bis 10800\n", "\n", " **Standard** : 10800 (3 Stunden)\n", "\n", " [`max_execution_time` API-Dokumentation](/docs/api/qiskit-ibm-runtime/options-models-sampler-options#max_execution_time)\n", " \n", "\n", " \n", " Optionen, die bei der Simulation eines Backends übergeben werden müssen\n", "\n", " [`simulator` API-Dokumentation](/docs/api/qiskit-ibm-runtime/options-models-simulator-options)\n", "\n", " \n", " \n", " **Auswahlmöglichkeiten** : Liste der Namen der Basisgatter, zu denen entrollt werden soll\n", "\n", " **Standard** : Die Menge aller vom [Qiskit-Aer-Simulator](https://qiskit.github.io/qiskit-aer/stubs/qiskit_aer.AerSimulator.html) unterstützten Basisgatter\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : Liste gerichteter Zwei-Qubit-Wechselwirkungen\n", "\n", " **Standard** : Keine, was bedeutet, dass keine Konnektivitätsbeschränkungen gelten (vollständige Konnektivität).\n", " \n", "\n", " \n", " **Optionen** : [Qiskit Aer NoiseModel](/docs/guides/build-noise-models) oder dessen Darstellung\n", "\n", " **Standard** : Keine\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : Ganzzahl\n", "\n", " **Standard** : Keine\n", " \n", " \n", " \n", "\n", " \n", " Drehoptionen\n", "\n", " [`twirling` API-Dokumentation](/docs/api/qiskit-ibm-runtime/options-models-twirling-options)\n", "\n", " \n", " \n", " **Auswahlmöglichkeiten** : Richtig, Falsch\n", "\n", " **Standard** : False\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : Richtig, Falsch\n", "\n", " **Standard** : False\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : `auto`, Ganzzahl >= 1\n", "\n", " **Standard** : `auto`\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : `auto`, Ganzzahl >= 1\n", "\n", " **Standard** : `auto`\n", " \n", "\n", " \n", " **Auswahlmöglichkeiten** : `active`, `active-circuit`, `active-accum`, `all`\n", "\n", " **Standard** : `active-accum`\n", " \n", " \n", " \n", "\n", " \n", " Experimentelle Optionen, sofern verfügbar.\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "80737dfd-a1c7-4b5f-b1ea-3391dcfa61b7", "metadata": {}, "source": [ "\n", "\n", "\n", "\n", "## Featurekompatibilität\n", "\n", "Bestimmte Laufzeitfunktionen können nicht gemeinsam in einem einzigen Job verwendet werden. Klicken Sie auf die entsprechende Registerkarte, um eine Liste der Funktionen anzuzeigen, die mit der ausgewählten Funktion nicht kompatibel sind:\n", "\n", "\n", " \n", " Nicht kompatibel mit:\n", "\n", " * Dynamische Entkopplung\n", "\n", " Sonstige Hinweise:\n", "\n", " * Das „Gate Twirling“ kann auf dynamische Schaltungen angewendet werden, jedoch nur auf Gatter, die sich nicht innerhalb von bedingten Blöcken befinden. Das „Measurement Twirling“ kann nur bei Endmessungen angewendet werden.\n", " * Kompatibel mit fraktionierten Gates bei Verwendung `qiskit-ibm-runtime` von „ v0.42.0 “ oder einer neueren Version.\n", " \n", "\n", " \n", " Nicht kompatibel mit:\n", "\n", " * Dynamische Schaltungen\n", " \n", "\n", " \n", " Nicht kompatibel mit:\n", "\n", " * Torwirbeln\n", "\n", " Kompatibel mit dynamischen Schaltkreisen bei Verwendung `qiskit-ibm-runtime` von „ v0.42.0 “ oder einer neueren Version.\n", " \n", "\n", " \n", " Nicht kompatibel mit:\n", "\n", " * Bruchgatter\n", " * Dehnübungen\n", "\n", " Sonstige Hinweise:\n", "\n", " * Das „Gate Twirling“ kann auf dynamische Schaltungen angewendet werden, jedoch nur auf Gatter, die sich nicht innerhalb von bedingten Blöcken befinden.\n", " * Das „Measurement Twirling“ kann nur bei Endmessungen angewendet werden.\n", " * Das Vertauschen der Messwerte ist mit der [`store`](/docs/api/qiskit/circuit#store) Anweisung unvereinbar.\n", " * Funktioniert nicht mit Entanglern, die nicht von Clifford stammen.\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "b95e9e8e-575c-411e-8504-4ef0a00166d3", "metadata": {}, "source": [ "\n", "\n", "## Nächste Schritte\n", "\n", "\n", " * Lesen Sie den Leitfaden „[Einführung in Optionen](/docs/guides/runtime-options-overview) “.\n", " * Weitere Informationen zu den `SamplerV2` Methoden finden Sie in der [Sampler-API-Referenz](/docs/api/qiskit-ibm-runtime/executor-sampler-sampler).\n", " * Entscheiden Sie, in welchem [Ausführungsmodus](execution-modes) Ihr Job ausgeführt werden soll.\n", " * Erfahren Sie mehr über [das Rauschmanagement mit Sampler](/docs/guides/sampler-noise-management).\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 }