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)
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
resultein 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)
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
Erhöht
- QiskitError - Wenn ein Wert in
indicesungültig ist oder dascountsdict - ist ungültig. -
marginal_memory
qiskit.result.marginal_memory(memory, indices=None, int_return=False, hex_return=False, avg_data=False, parallel_threshold=1000)
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
Trueist die Ausgabe eine Liste von Ganzzahlen. Standardmäßig ist der Rückgabetyp ein Bitstring. Dies undhex_returnschließ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
Trueist die Ausgabe eine Liste von hexadezimalen Zeichenfolgen. Standardmäßig ist der Rückgabetyp ein Bitstring. Dies undint_returnschließ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 aufTruegesetzt 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. Wennlen(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)
Berechnet den Erwartungswert aus einer Stichprobenverteilung
Beachten Sie, dass die Übergabe eines rohen Diktats Bit-String-Schlüssel erfordert.
Parameter
- dist (dict |result.Counts |QuasiDistribution |ProbDistribution) – Verteilung der abgetasteten Eingabedaten.
- oper (str |quantum_info.Pauli |quantum_info.SparsePauliOp |quantum_info.SparseObservable) – Der Operator für die Observable.
Rückgabe
Der Erwartungswert.
Erhöht
QiskitError - wenn die Eingabeverteilung oder der Operator ein ungültiger Typ ist
Rückgabetyp