SamplerV2
class SamplerV2(mode=None, options=None)
Basen: BasePrimitiveV2[SamplerOptions], Sampler, BaseSamplerV2
SamplerV2 Primitive für IBM Quantum Compute (ehemals Qiskit Runtime ).
Diese Klasse unterstützt Version 2 der Sampler-Schnittstelle, die andere Eingabe- und Ausgabeformate als Version 1 verwendet.
IBM Quantum Compute Die Primitive „Sampler“ gibt das Abtastergebnis entsprechend dem angegebenen Ausgabetyp zurück. Wird beispielsweise die Messstufe 2 (Bits) angefordert, gibt das System für jede Aufnahme eine Bitfolge zurück.
Die Methode run() methode kann verwendet werden, um Schaltungen und Parameter an das Sampler-Primitiv zu übergeben.
Parameter
-
mode (BackendV2 | Session |Batch | None) –
Der Ausführungsmodus, der für die primitive Abfrage verwendet wird. Auswahlmöglichkeiten:
- A
Backendwenn Sie den Auftragsmodus verwenden. - A
Sessionwenn Sie den Modus Sitzungsausführung verwenden. - A
Batchwenn Sie den Stapelverarbeitungsmodus verwenden.
Weitere Informationen zum finden Sie unter IBM Quantum Compute Dokumentation
Execution modes. - A
-
options (dict | options.SamplerOptions | None) – Optionen für den Sampler – eine ausführliche Beschreibung finden Sie
qiskit_ibm_runtime.options.SamplerOptionsunter.
Attribute
mode
Gibt den von diesem Primitiv verwendeten Ausführungsmodus zurück.
Rückgabe
Modus, der von diesem Primitiv verwendet wird, oder None , wenn kein Ausführungsmodus verwendet wird.
options
Rückgabemöglichkeiten.
version
Standardwert: 2
Methoden
backend
run
run(pubs, *, shots=None, dry_run=False)
Stellen Sie eine Anfrage an den primitiven Probenehmer.
Parameter
- pubs (Iterable[SamplerPubLike]) – Eine iterierbare Struktur aus pub-ähnlichen Objekten.
(circuit, parameter_values)Zum Beispiel eine Liste von Schaltkreisen oder Tupeln. - shots (int | None) – Die Gesamtzahl der zu entnehmenden Schüsse für jeden Sampler-Pub, der keine eigenen Schüsse angibt. Bei
Nonewird der Standardwert für Schüsse des Primitivs verwendet, der je nach Implementierung variieren kann. - dry_run (bool) – Wenn
True, wird ein Testlauf durchgeführt, ohne den Auftrag auf einer QPU auszuführen. Dieser Modus kann verwendet werden, um den Auftrag zu validieren, den Ressourcenverbrauch abzuschätzen und Metadaten zur Schaltungszeit zu abrufen. Die zurückgegebenen Ergebnisse entsprechen zwar dem erwarteten Schema, enthalten jedoch zufällig generierte Dummy-Daten anstelle von tatsächlichen oder simulierten Messergebnissen. Im Gegensatz zu den simulierten Backends erfolgt die Verarbeitung dieses Testlaufs serverseitig, sodass der Vorgang möglicherweise nicht sofort abgeschlossen wird und der Zugriff auf diese Funktion eingeschränkt sein kann.
Rückgabe
Eingereichte Arbeit. Das Ergebnis des Auftrags ist eine Instanz von qiskit.primitives.containers.PrimitiveResult.
Erhöht
ValueError - Es wurden ungültige Argumente angegeben.
Rückgabetyp