Skip to main content
IBM Quantum Platform

Experimentergebnisse

qiskit.result


Kernklassen

Kolumne „ 1 “
Kolumne „ 2 “
Result(*[, backend_name, backend_version,...] )Modell für Ergebnisse.
ResultError(Fehler)Ausnahmen, die aufgrund von Fehlern in der Ergebnisausgabe ausgelöst werden.
Counts(Daten[, Dauer, Creg-Größen,...] )Eine Klasse zur Speicherung eines Zählergebnisses aus der Ausführung eines Schaltkreises.

Marginalisierung

marginal_counts

qiskit.result.marginal_counts(result, indices=None, inplace=False, format_marginal=False, marginalize_memory=True)

GitHub

Marginalisieren Sie die Zählungen aus einem Experiment über einige interessierende Indizes.

Parameter

  • result (dict |Result) – Ergebnis, das ausgeblendet werden soll (ein „Result“-Objekt oder ein „dict(str, int)“ mit Zählwerten).
  • indices (list[int] | None) – Die Bitpositionen, die für die Marginalisierung von Interesse sind. Wenn None (Standard), wird überhaupt keine Marginalisierung vorgenommen.
  • inplace (bool) – Voreinstellung: Falsch. Bearbeitet das ursprüngliche Ergebnis-Argument, wenn True, was zum Verlust des ursprünglichen Auftragsergebnisses führt. Es hat keine Auswirkungen, wenn result ein Diktat ist.
  • format_marginal (bool) – Voreinstellung: Falsch. Wenn True, wird die Ausgabe von marginalize übernommen und mit Platzhaltern zwischen Cregs und für Nicht-Indizes formatiert.
  • marginalize_memory (bool | None) – Wenn True, dann wird auch das Speicherfeld (falls vorhanden) marginalisiert. Wenn False, wird das Speicherfeld aus dem Ergebnis entfernt. Wenn Keine, lassen Sie das Speicherfeld so wie es ist.

Rückgabe

Ein Ergebnisobjekt oder ein Wörterbuch mit

die beobachteten Zählungen, marginalisiert, um nur die Häufigkeit der Beobachtungen von Bits von Interesse zu berücksichtigen.

Rückgabetyp

Ergebnis oder dict ( str, int )

Erhöht

QiskitError - im Falle von ungültigen Indizes zu marginalisieren.

marginal_distribution

qiskit.result.marginal_distribution(counts, indices=None, format_marginal=False)

GitHub

Marginalisieren Sie die Zählungen aus einem Experiment über einige interessierende Indizes.

Im Gegensatz zu marginal_counts() achtet diese Funktion auf die Reihenfolge der Eingabe indices. Wenn die Eingabeliste indices angegeben wird, entspricht die Reihenfolge, in der die Bit-Indizes angegeben werden, der Ausgabereihenfolge der Bitstrings in der marginalisierten Ausgabe.

Parameter

  • counts (dict) – ergebnis marginalisiert zu werden
  • indices (Sequence[int] | None) – Die Bitpositionen, die für die Marginalisierung von Interesse sind. Wenn None (Standard), wird überhaupt keine Marginalisierung vorgenommen.
  • format_marginal (bool) – Voreinstellung: Falsch. Wenn True, wird die Ausgabe von marginalize übernommen und mit Platzhaltern zwischen Cregs und für Nicht-Indizes formatiert.

Rückgabe

Ein marginalisiertes Wörterbuch

Rückgabetyp

dict (str, int )

Erhöht

  • QiskitError - Wenn ein Wert in indices ungültig ist oder das counts dict
  • ist ungültig. -

marginal_memory

qiskit.result.marginal_memory(memory, indices=None, int_return=False, hex_return=False, avg_data=False, parallel_threshold=1000)

GitHub

Schusserinnerung marginalisieren

Diese Funktion ist multithreadingfähig und startet standardmäßig einen Thread-Pool mit Threads, die der Anzahl der CPUs entsprechen. Sie können die Anzahl der Threads mit der Umgebungsvariablen RAYON_NUM_THREADS einstellen. Zum Beispiel würde die Einstellung RAYON_NUM_THREADS=4 den Thread-Pool auf 4 Threads begrenzen.

Parameter

  • memory (list[str] | ndarray) – Die Eingabespeicherliste ist entweder eine Liste von Hexadezimalzeichenfolgen, die zur Darstellung des Speichers der Messstufe 2 verwendet werden, oder ein NumPy-Array, das den Messspeicher der Stufe 0 (Einzelwert oder Mittelwert) oder den Messspeicher der Stufe 1 (Einzelwert oder Mittelwert) darstellt.
  • indices (list[int] | None) – Die Bitpositionen, die für die Marginalisierung von Interesse sind. Wenn None (Standard), wird überhaupt keine Marginalisierung vorgenommen.
  • int_return (bool) – Bei True ist die Ausgabe eine Liste von Ganzzahlen. Standardmäßig ist der Rückgabetyp ein Bitstring. Dies und hex_return schließen sich gegenseitig aus und können nicht gleichzeitig angegeben werden. Diese Option wirkt sich nur auf die Speicherebene 2 aus.
  • hex_return (bool) – Bei True ist die Ausgabe eine Liste von hexadezimalen Zeichenfolgen. Standardmäßig ist der Rückgabetyp ein Bitstring. Dies und int_return schließen sich gegenseitig aus und können nicht gleichzeitig angegeben werden. Diese Option wirkt sich nur auf die Speicherebene 2 aus.
  • avg_data (bool) – Wenn ein 2-dimensionales Numpy-Array für memory übergeben wird, kann dies auf True gesetzt werden, um anzuzeigen, dass es sich um Durchschnittsdaten der Stufe 0 handelt und nicht um einzelne Daten der Stufe 1.
  • parallel_threshold (int) – Die Anzahl der Elemente in memory , um die Ausführung in mehreren Threads zu starten. Wenn len(memory) >= dieser Wert ist, wird die Funktion in mehreren Threads ausgeführt. Standardmäßig ist dieser Wert auf 1000 eingestellt.

Rückgabe

Die Liste der marginalisierten Erinnerung

Rückgabetyp

randspeicher

Erhöht

ValueError - wenn sowohl int_return als auch hex_return eingestellt sind auf True


Distributionen

Kolumne „ 1 “
Kolumne „ 2 “
ProbDistribution(Daten[, Aufnahmen] )Eine generische diktatähnliche Klasse für Wahrscheinlichkeitsverteilungen.
QuasiDistribution(Daten[, Aufnahmen, …] )Eine Diktat-ähnliche Klasse zur Darstellung von Quasi-Wahrscheinlichkeiten.

Erwartungswerte

sampled_expectation_value

qiskit.result.sampled_expectation_value(dist, oper)

GitHub

Berechnet den Erwartungswert aus einer Stichprobenverteilung

Beachten Sie, dass die Übergabe eines rohen Diktats Bit-String-Schlüssel erfordert.

Parameter

Rückgabe

Der Erwartungswert.

Erhöht

QiskitError - wenn die Eingabeverteilung oder der Operator ein ungültiger Typ ist

Rückgabetyp

Gleitkomma

War diese Seite hilfreich?
Melden Sie auf GitHub einen Fehler, einen Tippfehler oder fordern Sie Inhalte an.